Konto und API-Schlüssel erstellen
Zwei Wege zum Schlüssel – direkt in Bitrix24 oder in der Developer-Konsole mit E-Mail-Adresse und Passwort. Keine Redirect-URI, kein PKCE, kein Zustimmungsbildschirm.
Es gibt zwei gleichwertige Wege, einen API-Schlüssel zu erhalten – je nachdem, wie Sie WASync nutzen.
Öffnen Sie die App in Bitrix24, gehen Sie zu Einstellungen → API & Agents und suchen Sie die Karte API-Schlüssel. Benennen Sie die Integration und klicken Sie auf Schlüssel erstellen.
Zum Erstellen eines Schlüssels brauchen Sie mindestens eine Verbindung mit aktivem
API-Add-on (12 $ pro Nummer und Monat). Ohne diese ist die Schaltfläche
deaktiviert und nennt den Grund; der Server antwortet mit 403 addon_required. Der Schlüssel wird einmalig
direkt dort angezeigt, mit einer Schaltfläche Kopieren, und trägt die Standard-Scopes
whatsapp.read whatsapp.send.
IP-Allowlists, die webhook-Konfiguration und die Verwaltung mehrerer Portale mit einem Konto finden Sie in der Developer-Konsole, nicht in dieser Karte – die Karte verweist darauf.
Der Schlüssel wird nur einmal angezeigt – gespeichert wird lediglich ein Hash davon. Kopieren Sie ihn sofort in Ihre Umgebung.
export WASYNC_API_KEY=wsk_live_…Senden Sie ihn bei jeder Anfrage mit:
Authorization: Bearer $WASYNC_API_KEYDas ist die gesamte Authentifizierung. Keine Redirect-URI, kein PKCE, kein Zustimmungsbildschirm, keine Token-Erneuerung.
Scopes
Wählen Sie nur aus, was die Integration braucht – Scopes gelten pro Schlüssel.
| Scope | Was er erlaubt |
|---|---|
whatsapp.read | Verbindungen auflisten und Nachrichten lesen. |
whatsapp.send | Nachrichten senden und Lesebestätigungen lesen. |
whatsapp.events | webhooks empfangen und festlegen, wohin sie gesendet werden. |
whatsapp.manage | Verbindungen erstellen, prüfen, neu starten, abmelden und löschen. |
Scopes und die Liste der erreichbaren Verbindungen werden bei jeder Anfrage live ermittelt. Wenn Sie einen Schlüssel widerrufen oder einschränken, gilt das daher schon beim nächsten Aufruf – es wird nichts zwischengespeichert und nichts muss erneuert werden. Die Details und was jeder Scope Sie kostet, falls er in falsche Hände gerät, finden Sie unter Scopes.
Sie können sich nicht aussperren
Die optionale IP-Allowlist gilt nur für API-Aufrufe. Die Seite, auf der Sie sie bearbeiten, wird über Ihr Konto authentifiziert, nicht über den Schlüssel, und bleibt daher von jeder Adresse aus erreichbar. Siehe IP-Allowlist.
Was eine Verbindung kostet
Jede WhatsApp-Nummer braucht zum Senden und Empfangen eine aktive Lizenz. Eine neue Nummer
startet mit einer 7-tägigen kostenlosen Testphase, danach kostet sie 19 $ pro Nummer und Monat als qr-Nummer
(WAPP) oder 29 $ pro Nummer und Monat als cloud_api-Nummer (WABA), jeweils in
USD. In einem Bitrix24-Portal ist der API-Zugriff auf eine Nummer ein separates Add-on für 12 $ pro Nummer
und Monat. Lizenzen & Testphase bietet den vollständigen Überblick.