Zaloguj sięRozpocznij bezpłatny okres próbny
Meta Tech Provider

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.

Not supported

Rozmowy głosowe i wideo w Cloud API dla numeru podłączonego przez aplikację WhatsApp Business; w aplikacji pozostają bez zmian.

2,000

Minimalny dzienny limit wiadomości, liczony w unikalnych odbiorcach, jaki numer musi osiągnąć, zanim będzie mógł korzystać z Calling API.

7 days

Jak długo nagrania i transkrypcje rozmów można pobrać po dostarczeniu ich webhooka.

wacid

Prefiks identyfikatorów rozmów, czyli wartość łącząca zdarzenia connect, status i terminate jednej rozmowy.

whatsapp_business_messaging

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.

connectThe call is ready to connect; session carries the SDP to apply to your WebRTC stack.
call_createdA SIP call was attempted, business- or user-initiated.
statuses (type call)RINGING, ACCEPTED or REJECTED for a business-initiated call.
terminateThe call ended: status COMPLETED or FAILED, with times and duration when answered.
call_recording_availableA media id for the finished audio recording.
call_transcription_availableA media id for the transcript, a JSON document.

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:

Meta's example: the Call Connect webhook
{
  "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_time i 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ą.
Z EasyCoexistence zrobisz to

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óbny

Zweryfikowano w