Webhooki rozmów WhatsApp: zdarzenia Calling API i rozmowy na numerze Coexistence
Pole calls raportuje zdarzenia WhatsApp Business Calling API: zdarzenie connect z odpowiedzią SDP lub ofertą, statusy rozmowy RINGING, ACCEPTED i REJECTED, zakończenie z COMPLETED lub FAILED oraz czas trwania, a także call_recording_available lub call_transcription_available. Przewodnik Meta po Coexistence wymienia rozmowy głosowe i wideo jako niezmienione w aplikacji WhatsApp Business i nieobsługiwane w Cloud API, więc te rozmowy pozostają przy telefonie.
easyCoexistence łączy numer z aplikacji WhatsApp Business z Cloud API Meta przez Coexistence, dzięki czemu Twoje AI i automatyzacje odpowiadają na wiadomości i wysyłają szablony, a rozmowy dalej dzwonią w aplikacji na Twoim telefonie.
Rozmowy głosowe i wideo w Cloud API dla numeru podłączonego przez aplikację WhatsApp Business; w aplikacji pozostają bez zmian.
Minimalny dzienny limit wiadomości, liczony w unikalnych odbiorcach, jaki numer musi osiągnąć, zanim będzie mógł korzystać z Calling API.
Jak długo nagrania i transkrypcje rozmów można pobrać po dostarczeniu ich webhooka.
Prefiks identyfikatorów rozmów, czyli wartość łącząca zdarzenia connect, status i terminate jednej rozmowy.
Uprawnienie, jakie aplikacja musi mieć, by odbierać webhooki rozmów, takie samo jak dla wiadomości.
Co raportuje pole calls?
Wszystko, co dzieje się z rozmową wykonaną lub odebraną przez Calling API, jako jedno pole ze zdarzeniem na każdym etapie. Rozmowa zainicjowana przez firmę generuje zdarzenie connect, aktualizacje statusu i zdarzenie terminate. Rozmowy obsługiwane przez SIP raportują call_created zamiast connect, bez sesji SDP. Jedno powiązane zdarzenie jest w innym polu: gdy klient odpowie na prośbę o uprawnienie do rozmowy, odpowiedź trafia do pola messages jako wiadomość interaktywna typu call_permission_reply.
Jak wygląda webhook rozmowy?
Ta sama koperta co w każdym webhooku WhatsApp, z tablicą calls pod value i polem field ustawionym na calls. direction przyjmuje BUSINESS_INITIATED albo USER_INITIATED, from i to zawierają numery telefonów, to_user_id to BSUID klienta, a dowolny z numerów może być pusty w przypadku klienta, który używa nazwy użytkownika. metadata.phone_number_id identyfikuje Twój numer, tak jak w każdym innym polu. To przykład Call Connect z dokumentacji Meta, z symbolami zastępczymi wydrukowanymi przez Meta:
{
"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"
}
]
}
]
}Jakie pola dodaje zdarzenie terminate?
terminate to zdarzenie, które większość systemów zapisuje, bo zamyka rozmowę. Jego pola według referencji Meta:
- status: COMPLETED, gdy rozmowa zakończyła się bez nieoczekiwanych błędów, także nieodebrana; FAILED, gdy nie doszła do skutku lub się zerwała.
start_time,end_timei duration w sekundach: obecne tylko wtedy, gdy druga strona odebrała.- errors: code, message, href i
error_data.details przy rozmowie FAILED. biz_opaque_callback_data: Twój własny ciąg śledzący, jeśli przekazałeś go przy rozpoczynaniu lub przyjmowaniu rozmowy.
Czy webhooki rozmów działają na numerze Coexistence?
Przewodnik Meta po Coexistence odpowiada na to w tabeli funkcji: rozmowy głosowe i wideo pozostają bez zmian w aplikacji WhatsApp Business i nie są obsługiwane w Cloud API dla numeru podłączonego w ten sposób. Wymagania wstępne Calling API mówią to samo od drugiej strony: numer firmowy musi być używany z Cloud API, a nie w aplikacji WhatsApp Business. Na numerze Coexistence klienci więc dzwonią jak dotąd, rozmowa dzwoni w aplikacji na telefonie, a pole calls nie ma nic do zgłoszenia. Firma, która potrzebuje rozmów w oprogramowaniu, korzysta wyłącznie z numeru w Cloud API.
Jak zdarzenia jednej rozmowy łączą się ze sobą?
Po identyfikatorze rozmowy, który zaczyna się od wacid i powtarza się w każdym zdarzeniu tej rozmowy. Rozmowa zainicjowana przez firmę zgłasza connect z odpowiedzią SDP, statusy RINGING, a potem ACCEPTED albo REJECTED, a na końcu terminate. Rozmowa zainicjowana przez użytkownika zgłasza connect z ofertą SDP, na którą Twój stos ma odpowiedzieć, a potem terminate. Zdarzenia nagrań i transkrypcji, jeśli są włączone, przychodzą po terminate. Zapisuj zdarzenia według pary id i event, bo ponowienia powtarzają je, a kolejność dostarczenia nie jest gwarantowana. Pełna lista wymagań wstępnych Calling API znajduje się na stronie o rozmowach na numerze Coexistence.
Co Twoje AI może zrobić z rozmowami na numerze Coexistence?
Pracować w czacie, podczas gdy rozmowy zostają z osobą przy telefonie. easyCoexistence nie subskrybuje pola calls i nie ma narzędzi do rozmów; jego konektor i automatyzacje obejmują wiadomości i szablony. W praktyce oznacza to, że odpowiedź AI może poinformować klienta, kiedy ktoś jest dostępny do rozmowy i pod który numer zadzwonić, automatyzacja słowa kluczowego może odpowiedzieć na „dzwonię” lub „telefon” tą informacją, a właściciel odbiera rozmowę w aplikacji WhatsApp Business jak dotychczas.
Typowe błędy
- Subskrybowanie calls dla numeru Coexistence i czekanie na zdarzenia. Meta wymienia połączenia jako nieobsługiwane w Cloud API dla tych numerów.
- Spodziewanie się start_time i duration przy każdym terminate. Pojawiają się tylko wtedy, gdy rozmowa została odebrana; nieodebrana rozmowa i tak kończy się COMPLETED.
- Szukanie odpowiedzi na uprawnienia w polu calls. Trafiają do messages jako interaktywne call_permission_reply.
- Pozostawianie nagrań i transkrypcji u Meta. Oba można pobrać przez 7 dni od webhooka, potem znikają.
Każdy numer jest monitorowany 24/7, łącznie z zasadą 14 dni, która odłącza numer, gdy aplikacja nie jest otwierana. Od US$ 9 do US$ 0.75 za numer miesięcznie, spadając wraz z dodawaniem numerów, z bezpłatnym okresem próbnym na 3 dni.
Najczęściej zadawane pytania
Czy klienci tracą przycisk połączenia, gdy numer łączy się z API przez Coexistence?
Przewodnik Meta po Coexistence wymienia rozmowy głosowe i wideo jako niezmienione w aplikacji WhatsApp Business. Klienci dzwonią na ten sam numer, a właściciel odbiera w aplikacji na telefonie.
Czy Calling API jest wyceniane jak wiadomości?
Nie. Strona cennika Meta mówi, że Calling API ma inne ceny i wskazuje osobny dokument cennika połączeń, więc opłaty za rozmowy nie pojawiają się w obiekcie pricing statusów wiadomości.
Czy rozmowę przez Calling API można nagrać lub transkrybować?
Tak, gdy nagrywanie lub transkrypcja są włączone. Po rozmowie Meta wysyła call_recording_available z identyfikatorem mediów audio albo call_transcription_available z identyfikatorem dokumentu JSON, zwykle w ciągu minuty.
Czy webhook rozmów może trafiać na inny endpoint niż aplikacji?
Tak. calls to jedno z pól, które Meta pozwala kierować na alternatywny adres callback, obok messages i pól Coexistence.
Czytaj dalej
Gotowy, aby zacząć?
Skonfiguruj WhatsApp Coexistence w kilka minut, nie miesięcy. Aplikacja nadal działa na telefonie.
Rozpocznij bezpłatny okres próbnyZweryfikowano w