WhatsApp-Anruf-Webhooks: Calling-API-Ereignisse und Anrufe auf einer Coexistence-Nummer
Das Feld calls meldet Ereignisse der WhatsApp Business Calling API: connect mit einer SDP-Antwort oder einem SDP-Angebot, Anrufstatus RINGING, ACCEPTED und REJECTED, terminate mit COMPLETED oder FAILED samt Dauer sowie call_recording_available oder call_transcription_available. Metas Coexistence-Leitfaden führt Sprach- und Videoanrufe in der WhatsApp Business App als unverändert und auf der Cloud API als nicht unterstützt auf, daher bleiben diese Anrufe auf dem Telefon.
easyCoexistence verbindet Ihre Nummer der WhatsApp Business App über Coexistence mit der Cloud API von Meta, damit Ihre KI und Automatisierungen Nachrichten beantworten und Vorlagen senden, während Anrufe weiterhin in der App auf Ihrem Telefon klingeln.
Sprach- und Videoanrufe über die Cloud API für eine Nummer, die mit der WhatsApp Business App angebunden wurde; in der App bleiben sie unverändert.
Das minimale tägliche Nachrichtenlimit, gemessen in eindeutigen Empfängern, das eine Nummer haben muss, bevor sie die Calling API nutzen kann.
Wie lange Anrufaufnahmen und Transkripte nach der Zustellung ihres Webhooks herunterladbar bleiben.
Das Präfix der Anruf-IDs: der Wert, der die connect-, Status- und terminate-Webhooks eines Anrufs verknüpft.
Die Berechtigung, die eine App benötigt, um calls-Webhooks zu empfangen, dieselbe wie für Nachrichten.
Was meldet das Webhook-Feld calls?
Alles, was mit einem Anruf geschieht, der über die Calling API getätigt oder angenommen wird, als ein Feld mit einem Ereignis pro Phase. Ein vom Unternehmen gestarteter Anruf erzeugt ein connect-Ereignis, Statusaktualisierungen und ein terminate-Ereignis. Anrufe über SIP melden call_created statt connect, ohne die SDP-Sitzung. Ein verwandtes Ereignis steht an anderer Stelle: Wenn ein Kunde auf eine Anfrage zur Anrufberechtigung antwortet, kommt die Antwort im Feld messages als interaktive Nachricht vom Typ call_permission_reply an.
Wie sieht ein calls-Webhook aus?
Dieselbe Hülle wie bei jedem WhatsApp-Webhook, mit einem calls-Array unter value und field auf calls gesetzt. direction gibt BUSINESS_INITIATED oder USER_INITIATED an, from und to enthalten die Telefonnummern, to_user_id die BSUID des Kunden. Eine der beiden Nummern kann fehlen, wenn der Kunde einen Benutzernamen verwendet. metadata.phone_number_id identifiziert Ihre Nummer, wie bei jedem anderen Feld. Dies ist das Call-Connect-Beispiel von Meta, mit Platzhaltern wie Meta sie angibt:
{
"object": "whatsapp_business_account",
"entry": [
{
"id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
"changes": [
{
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "16315553601",
"phone_number_id": "<PHONE_NUMBER_ID>"
},
"contacts": [
{
"profile": {
"name": "<CALLEE_NAME>",
"username": "<USERNAME>"
},
"wa_id": "16315553602",
"user_id": "<BSUID>",
"parent_user_id": "<PARENT_BSUID>"
}
],
"calls": [
{
"id": "wacid.ABGGFjFVU2AfAgo6V-Hc5eCgK5Gh",
"to": "16315553601",
"to_user_id": "<BSUID>",
"to_parent_user_id": "<PARENT_BSUID>",
"from": "16315553602",
"event": "connect",
"timestamp": "1671644824",
"direction": "BUSINESS_INITIATED",
"session": {
"sdp_type": "answer",
"sdp": "<<RFC 8866 SDP>>"
}
}
]
},
"field": "calls"
}
]
}
]
}Welche Felder fügt das Ereignis terminate hinzu?
terminate ist das Ereignis, das die meisten Systeme speichern, weil es den Anruf abschließt. Seine Felder laut Metas Referenz:
- status: COMPLETED, wenn der Anruf ohne unerwartete Fehler endete, auch unbeantwortete Anrufe; FAILED, wenn er nicht zustande kam oder abbrach.
start_time,end_timeund duration in Sekunden: nur vorhanden, wenn die Gegenseite abgenommen hat.- errors: code, message, href und
error_data.details bei einem FAILED-Anruf. biz_opaque_callback_data: Ihr eigener Tracking-String, wenn Sie beim Starten oder Annehmen des Anrufs einen übergeben haben.
Funktionieren calls-Webhooks bei einer Coexistence-Nummer?
Metas Coexistence-Leitfaden beantwortet das in seiner Funktionstabelle: Sprach- und Videoanrufe bleiben in der WhatsApp Business App unverändert und werden bei einer so angebundenen Nummer auf der Cloud API nicht unterstützt. Die Voraussetzungen der Calling API sagen dasselbe von der anderen Seite: Die Geschäftsnummer muss mit der Cloud API genutzt werden, nicht mit der WhatsApp Business App. Auf einer Coexistence-Nummer rufen Kunden also weiterhin wie bisher an, der Anruf klingelt auf dem Telefon in der App, und das Feld calls hat nichts zu melden. Ein Unternehmen, das Anrufe in Software braucht, nutzt eine Nummer ausschließlich auf der Cloud API.
Wie gehören die Ereignisse eines Anrufs zusammen?
Über die Anruf-ID, die mit wacid beginnt und sich bei jedem Ereignis dieses Anrufs wiederholt. Ein vom Unternehmen gestarteter Anruf meldet connect mit der SDP-Antwort, dann den Status RINGING und anschließend ACCEPTED oder REJECTED, und zuletzt terminate. Ein vom Nutzer gestarteter Anruf meldet connect mit einem SDP-Angebot, das Ihr Stack beantworten muss, danach terminate. Aufnahme- und Transkriptereignisse kommen, wenn aktiviert, nach terminate. Speichern Sie Ereignisse über id und event, da Zustellwiederholungen sie mehrfach liefern und die Reihenfolge der Ankunft nicht garantiert ist. Die vollständige Liste der Voraussetzungen der Calling API steht auf der Seite zu Anrufen auf einer Coexistence-Nummer.
Was kann Ihre KI bei Anrufen auf einer Coexistence-Nummer tun?
Im Chat arbeiten, während Anrufe bei der Person am Telefon bleiben. easyCoexistence abonniert das Feld calls nicht und hat keine Anruf-Tools; Connector und Automatisierungen decken Nachrichten und Vorlagen ab. Praktisch heißt das: Eine KI-Antwort kann dem Kunden mitteilen, wann jemand für ein Gespräch erreichbar ist und unter welcher Nummer er anrufen kann. Eine Automatisierung per Schlüsselwort kann auf "call" oder "phone" mit dieser Information antworten, und der Inhaber nimmt den Anruf wie bisher in der WhatsApp Business App entgegen.
Häufige Fehler
- Das Feld calls für eine Coexistence-Nummer abonnieren und auf Ereignisse warten. Meta führt das Anrufen für diese Nummern auf der Cloud API als nicht unterstützt.
- Erwarten, dass start_time und duration bei jedem terminate vorhanden sind. Sie erscheinen nur, wenn der Anruf angenommen wurde; ein unbeantworteter Anruf endet trotzdem mit COMPLETED.
- Berechtigungsantworten im Feld calls suchen. Sie kommen im Feld messages an, als interaktive Nachricht call_permission_reply.
- Aufnahmen und Transkripte bei Meta liegen lassen. Beide sind 7 Tage nach ihrem Webhook herunterladbar, danach sind sie weg.
Jede Nummer wird rund um die Uhr überwacht, einschließlich der 14-Tage-Regel, die eine Nummer trennt, deren App nicht geöffnet wird. US$ 9 bis US$ 0.75 pro Nummer und Monat, sinkend mit jeder weiteren Nummer, und die ersten 3 Tage sind kostenlos.
Häufig gestellte Fragen
Verlieren Kunden den Anrufbutton, wenn eine Nummer über Coexistence an die API angebunden wird?
Metas Coexistence-Leitfaden führt Sprach- und Videoanrufe in der WhatsApp Business App als unverändert auf. Kunden rufen dieselbe Nummer an, und der Inhaber nimmt den Anruf in der App auf dem Telefon entgegen.
Wird die Calling API wie Nachrichten bepreist?
Nein. Die Preisseite von Meta sagt, dass die Calling API eine eigene Preisgestaltung hat, und verweist auf ein separates Dokument zu Anrufpreisen. Anrufkosten erscheinen daher nicht im Objekt pricing der Nachrichtenstatus.
Kann ein Anruf der Calling API aufgezeichnet oder transkribiert werden?
Ja, wenn Aufnahme oder Transkription aktiviert ist. Nach dem Anruf sendet Meta call_recording_available mit einer Audio-Media-ID oder call_transcription_available mit einer JSON-Dokument-ID, meist innerhalb einer Minute.
Kann ein Anruf-Webhook an einen anderen Endpoint gehen als den der App?
Ja. calls gehört zu den Feldern, die Meta einem WhatsApp Business Account oder einer Telefonnummer erlaubt, an eine alternative Callback-URL weiterzuleiten, neben messages und den Coexistence-Feldern.
Weiterlesen
Bereit für den Start?
Richten Sie WhatsApp Coexistence in wenigen Minuten statt Monaten ein. Die App funktioniert weiterhin auf dem Telefon.
Kostenlose Testphase startenVerifiziert am