WhatsApp SIP-Anrufintegration
Überblick
WhatsApp unterstützt jetzt SIP-Anrufe über die WhatsApp Cloud API und ermöglicht Sprachanrufe über SIP via TLS/SRTP.
Dies ermöglicht eine native Integration zwischen WhatsApp und 3CX und erweitert die bisherige reine Nachrichten-Integration, um auch WhatsApp-Sprachanrufe zu unterstützen. Diese können an 3CX-Nebenstellen, Warteschleifen, IVRs oder AI-Agenten weitergeleitet werden.
Beachten Sie, dass die aktuelle Implementierung für Sprachanrufe nur eingehende WhatsApp-Anrufe an 3CX unterstützt.
Voraussetzungen
- Die Aktivierung von WhatsApp-SIP erfordert eine Live-WhatsApp-Anwendung im Entwicklerportal von Meta mit Nachrichtenberechtigungen für die geschäftliche Telefonnummer, für die Sie SIP aktivieren möchten.
- Falls Sie dies noch nicht eingerichtet haben, folgen Sie bitte den Schritten in unserer WhatsApp-Integrationsanleitung und rufen Sie Ihre Telefonnummer-ID sowie Ihren Nutzer-Zugriffstoken ab, die in der oben genannten Anleitung beschrieben sind. Diese werden zur Authentifizierung der erforderlichen Anfragen an die Meta Graph API zur SIP-Aktivierung benötigt.
- Da die Aktivierung von SIP-Anrufen für Ihre WhatsApp-Anwendung derzeit nicht über das Meta-UI-Portal verfügbar ist, müssen Sie ein Drittanbieter-Tool wie Postman verwenden, um POST-Anfragen an die Graph API von Meta zu senden.
- Um mehrere WhatsApp-Telefonnummern gleichzeitig zu integrieren, muss jede Nummer mit einer eigenen separaten WhatsApp-Anwendung im Portal Meta for Developers verknüpft sein. Der in dieser Anleitung beschriebene Einrichtungsprozess – vom Erstellen einer WhatsApp-Anwendung bis zur Konfiguration des SIP-Trunks auf 3CX – muss für jede WhatsApp-Telefonnummer wiederholt werden, die Sie integrieren möchten.
- Weitere Informationen finden Sie in der offiziellen Anleitung für WhatsApp-SIP.
Schritt 1: Erstellen Sie eine WhatsApp-Anwendung
- Wenn Sie WhatsApp-Messaging auf Ihrer 3CX bereits konfiguriert haben, können Sie diesen Schritt überspringen und Ihre Telefonnummer-ID sowie Ihren Nutzer-Zugriffstoken von Ihrem bereits konfigurierten WhatsApp in 3CX unter Admin-Konsole > Trunks & Chat > Ihr WhatsApp-Messaging-Trunk abrufen.
- Falls nicht, folgen Sie bitte den Schritten in unserer WhatsApp-Integrationsanleitung und rufen Sie Ihre Telefonnummer-ID und Ihren Nutzer-Zugriffstoken ab.
Schritt 2: SIP auf Ihrer WhatsApp-Nummer aktivieren
- Senden Sie die folgende POST-Anfrage an die Graph API von Meta unter Verwendung von curl oder einem anderen Tool.
- Sie können den curl-Befehl direkt in Postman importieren, indem Sie zu "Datei → Importieren" navigieren und Folgendes einfügen:
curl -X POST "https://graph.facebook.com/v24.0/<PHONE_NUMBER_ID>/settings" \
-H "Authorization: Bearer <YOUR_ACCESS_TOKEN>" \
-H "Content-Type: application/json" \
-d '{
"calling": {
"status": "ENABLED",
"callback_permission_status": "ENABLED",
"call_icon_visibility": "DEFAULT",
"srtp_key_exchange_protocol": "SDES",
"sip": {
"status": "ENABLED",
"servers": [
{
"hostname": "<YOUR_3CX_FQDN>",
"port": <YOUR_SIPS_PORT>
}
]
}
}
}'
- Stellen Sie sicher, dass Sie die folgenden Platzhalter im obigen Befehl durch Ihre eigenen Angaben ersetzen, bevor Sie ihn senden:
- <PHONE_NUMBER_ID> = Die Telefonnummer-ID, die Sie in Schritt 1 oben erhalten haben
- <YOUR_ACCESS_TOKEN> = Der Nutzer-Zugriffstoken, den Sie in Schritt 1 oben erhalten haben
- <YOUR_3CX_FQDN> = Der FQDN Ihrer 3CX-Telefonanlage; zum Beispiel: mypbx.3cx.com
- <YOUR_SIPS_PORT> = In der Regel 5061, wenn Ihre Telefonanlage Standardports verwendet
- Wenn die Anfrage erfolgreich war:
{"success":true}
- Sollten Sie eine Erfolgsmeldung in curl erhalten
- Oder in Postman
Schritt 3: Überprüfen Sie Ihre SIP-Konfiguration
- Senden Sie die folgende GET-Anfrage an die Graph API von Meta:
curl -X GET "https://graph.facebook.com/v17.0/<PHONE_NUMBER_ID>/settings?fields=calling&include_sip_credentials=true" \
-H "Authorization: Bearer <YOUR_ACCESS_TOKEN>"
- Stellen Sie sicher, dass Sie die folgenden Platzhalter im obigen Befehl durch Ihre eigenen Angaben ersetzen, bevor Sie ihn senden:
- <PHONE_NUMBER_ID> = Die Telefonnummer-ID, die Sie in Schritt 1 oben erhalten haben
- <YOUR_ACCESS_TOKEN> = Der Nutzer-Zugriffstoken, den Sie in Schritt 1 oben erhalten haben
- Wenn die Anfrage erfolgreich ist, sollten Sie eine Antwort ähnlich der folgenden erhalten:
{
"calling": {
"status": "ENABLED",
"call_icon_visibility": "DEFAULT",
"callback_permission_status": "ENABLED",
"srtp_key_exchange_protocol": "SDES",
"sip": {
"status": "ENABLED",
"servers": [
{
"app_id": 112233445566778,
"hostname": "pbx.3cx-example.com",
"port": 5061,
"sip_user_password": "aabbccddeeffgghhiijjkkllmmnnoopp"
}
]
}
},
"storage_configuration": {
"status": "DEFAULT"
}
}
- In curl
- Oder in Postman
Schritt 4: Anrufeinstellungen im WhatsApp Business Manager aktivieren
- Navigieren Sie zu Ihrem WhatsApp Business Manager
- Klicken Sie auf Telefonnummern und wählen Sie Ihre WhatsApp-Nummer aus
- Falls Telefonnummern nicht angezeigt wird, klicken Sie auf Alle Tools
- Öffnen Sie den Reiter Anrufeinstellungen und stellen Sie sicher, dass Sie diese Optionen aktiviert haben:
- Sprachanrufe zulassen
- Rückrufe zulassen
- Anruftasten anzeigen
Schritt 5: Erstellen Sie einen SIP-Trunk auf 3CX
So erstellen Sie Ihren neuen WhatsApp-SIP-Trunk:
- Laden Sie die WhatsApp-Vorlage von hier herunter
- Gehen Sie zu Admin > Erweitert > Vorlagen > Provider-Vorlagen.
- Klicken Sie auf die Schaltfläche Provider importieren, wählen Sie die oben heruntergeladene Vorlage aus und klicken Sie auf die Schaltfläche Importieren:
- Legen Sie einen Namen für Ihren neuen WhatsApp-SIP-Trunk fest
- Legen Sie das Standardziel für eingehende WhatsApp-SIP-Anrufe fest
- Deaktivieren Sie das Kontrollkästchen Ausgehende Regel erstellen
- Setzen Sie die Haupt-Trunk-Nummer auf Ihre WhatsApp-Nummer
- Lassen Sie alle anderen Felder auf ihren Standardwerten
- Klicken Sie auf die Schaltfläche Speichern
- Sie können nun eingehende WhatsApp-Anrufe für Ihre WhatsApp-Nummer entgegennehmen, die an das ausgewählte 3CX-Ziel zugestellt werden.
Alternativ können Sie manuell einen generischen SIP-Trunk auf 3CX erstellen und dabei sicherstellen, dass Sie die folgende Konfiguration verwenden:
- Authentifizierungstyp: IP-basiert
- Host: wa.meta.vc
- Port: Automatische Erkennung
- Transportprotokoll: TLS
- SRTP-Modus: Erzwungen
- Codecs: OPUS
Siehe auch
- WhatsApp konfigurieren
- Facebook einrichten
- Live-Chat konfigurieren
- SMS/MMS konfigurieren
- Kundenanfragen verwalten
Letztes Update
Dieses Dokument wurde zuletzt am 22.September 2026 aktualisiert.
Copyright © 2025