WhatsApp SIP-Anrufintegration

Überblick

WhatsApp unterstützt jetzt SIP-Anrufe über die WhatsApp Cloud API und ermöglicht so Sprachanrufe über SIP via TLS/SRTP.

Dies ermöglicht die native Integration von WhatsApp und 3CX und erweitert die bestehende Messaging-Integration um die Unterstützung von WhatsApp-Sprachanrufen. Diese können an 3CX-Nebenstellen, Warteschleifen, IVR-Systeme oder KI-Agenten weitergeleitet werden.

Bitte beachten Sie, dass die aktuelle Implementierung für Sprachanrufe nur eingehende WhatsApp-Anrufe an 3CX unterstützt.

Voraussetzungen

  • Um WhatsApp SIP zu aktivieren, benötigen Sie eine aktive WhatsApp-Anwendung im Entwicklerportal von Meta mit Messaging-Berechtigungen 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 besorgen Sie sich Ihre Telefonnummern-ID und Ihr User Access Token (siehe Anleitung oben). Diese werden für die Authentifizierung der erforderlichen Anfragen an die Meta Graph API zur Aktivierung von SIP benötigt.
  • Da die Aktivierung von SIP-Anrufen in Ihrer WhatsApp-Anwendung derzeit nicht über das Meta-UI-Portal möglich ist, müssen Sie ein Drittanbieter-Tool wie Postman verwenden, um POST-Anfragen an die Meta Graph API zu senden.
  • Um mehrere WhatsApp-Telefonnummern gleichzeitig zu integrieren, muss jede Nummer im Meta-Entwicklerportal mit einer eigenen WhatsApp-Anwendung verknüpft sein. Der in dieser Anleitung beschriebene Einrichtungsprozess – von der Erstellung einer WhatsApp-Anwendung bis zur Konfiguration des SIP-Trunks auf 3CX – muss für jede zu integrierende WhatsApp-Telefonnummer wiederholt werden.
  • Weitere Informationen finden Sie in der offiziellen Anleitung für WhatsApp SIP.

Schritt 1: Erstellen Sie eine WhatsApp-Anwendung

  • Wenn Sie WhatsApp Messaging bereits in Ihrem 3CX-Konto eingerichtet haben, können Sie diesen Schritt überspringen und Ihre Phone number ID und Ihr User Access Token in der Admin-Konsole unter „Sprache & Chat“ > „Ihr WhatsApp Messaging-Trunk“ abrufen.
  • Andernfalls folgen Sie bitte den Schritten in unserer WhatsApp-Integrationsanleitung, um Ihre Phone number ID und User Access Token zu erhalten.

Schritt 2: SIP auf Ihrer WhatsApp-Nummer aktivieren

  • Senden Sie die folgende POST-Anfrage an die Graph-API von Meta mit curl oder einem anderen Tool.
  • Sie können den curl-Befehl direkt in Postman importieren, indem Sie auf „Datei → Importieren“ gehen 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>

          }

        ]

      }

    }

  }'

  • Ersetzen Sie unbedingt die folgenden Platzhalter durch Ihre eigenen Daten im obigen Befehl, bevor Sie ihn absenden:
  • <PHONE_NUMBER_ID> = Die Phone Number ID, die Sie in Schritt 1 oben erhalten haben
  • <YOUR_ACCESS_TOKEN> = Den User Access Token,  den Sie in Schritt 1 oben erhalten haben
  • <YOUR_3CX_FQDN> = Ihre 3CX PBX FQDN; zum Beispiel: mypbx.3cx.com
  • <YOUR_SIPS_PORT> = Normalerweise 5061, wenn Ihre Telefonanlage die Standardports verwendet.
  • Wenn die Anfrage erfolgreich war:

{"success":true}

  • Sie sollten in curl eine Erfolgsmeldung erhalten.

curl Erfolgsmeldung

  • 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>"

  • Ersetzen Sie vor dem Absenden des Befehls unbedingt die folgenden Angaben durch Ihre eigenen:
  • <PHONE_NUMBER_ID> = Die Phone Number ID, die Sie in Schritt 1 oben erhalten haben
  • <YOUR_ACCESS_TOKEN> = Den User Access Token, den Sie in Schritt 1 oben erhalten haben
  • Wenn die Anfrage erfolgreich ist, sollten Sie eine Antwort erhalten, die in etwa der folgenden entspricht:

{

    "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

curl Antwort

  • Oder in Postman

Schritt 4: Anrufeinstellungen im WhatsApp Business Manager aktivieren

  • Falls die Telefonnummern nicht angezeigt werden, klicken Sie auf „All tools“.

WhatsApp Telefonnummer auswählen

  • Öffnen Sie den Tab Call Settings und vergewissern Sie sich, 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:

  • Lade die WhatsApp-Vorlage hier herunter.
  • Gehen Sie in Ihrer 3CX-Administrationskonsole zum Tab „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“:

Provider importieren

  • Geben Sie Ihrem neuen WhatsApp-SIP-Trunk einen Namen.
  • Legen Sie die Standardroute für eingehende WhatsApp-SIP-Anrufe fest.
  • Deaktivieren Sie das Kontrollkästchen „Ausgehende Regel erstellen“.
  • Geben Sie Ihre WhatsApp-Nummer als Haupt-Trunknummer ein.
  • Belassen Sie alle anderen Felder auf ihren Standardwerten.
  • Klicken Sie auf „Speichern“.
  • Sie können nun eingehende WhatsApp-Anrufe an Ihre WhatsApp-Nummer annehmen, die dann an das ausgewählte 3CX-Ziel weitergeleitet werden.

Alternativ können Sie einen generischen SIP-Trunk auf 3CX manuell erstellen und dabei sicherstellen, dass Sie die folgende Konfiguration verwenden:

  • Authentifizierungstyp: IP-basiert
  • Host: wa.meta.vc
  • Port: Auto discovery
  • Transport Protokoll: TLS
  • SRTP Modus: Enforced
  • Codecs: OPUS

Siehe auch

Letztes Update

Dieses Dokument wurde zuletzt am 4. August 2026 aktualisiert.

https://www.3cx.de/docs/whatsapp-sip-anruf-integration/