Conectați-văÎncepeți perioada de probă gratuită
Meta Tech Provider

Webhook-urile pentru apeluri WhatsApp: evenimente Calling API și apeluri pe un număr Coexistence

Câmpul calls raportează evenimentele WhatsApp Business Calling API: connect cu un SDP answer sau offer, statusurile apelului RINGING, ACCEPTED și REJECTED, terminate cu COMPLETED sau FAILED și durata, precum și call_recording_available sau call_transcription_available. Ghidul Coexistence al Meta enumeră apelurile vocale și video drept neschimbate în aplicația WhatsApp Business și nesuportate prin Cloud API, deci aceste apeluri rămân la telefon.

easyCoexistence conectează numărul din aplicația WhatsApp Business la Cloud API al Meta prin Coexistence, astfel că AI-ul și automatizările dumneavoastră răspund la mesaje și trimit șabloane, în timp ce apelurile continuă să sune în aplicația de pe telefon.

Not supported

Apeluri vocale și video prin Cloud API pentru un număr conectat cu aplicația WhatsApp Business; în aplicație rămân neschimbate.

2,000

Limita minimă zilnică de mesaje, exprimată în destinatari unici, pe care trebuie să o aibă un număr înainte să poată folosi Calling API.

7 days

Cât timp înregistrările și transcrierile apelurilor rămân disponibile pentru descărcare după livrarea webhook-ului lor.

wacid

Prefixul ID-urilor de apel, valoarea care leagă webhook-urile connect, status și terminate ale unui apel.

whatsapp_business_messaging

Permisiunea pe care o aplicație trebuie să o primească pentru a primi webhook-urile de apeluri, aceeași ca pentru mesajele.

Ce raportează câmpul calls?

Tot ce se întâmplă cu un apel plasat sau primit prin Calling API, ca un singur câmp cu un eveniment pentru fiecare etapă. Un apel inițiat de firmă produce un eveniment connect, actualizări de status și un eveniment terminate. Apelurile gestionate prin SIP raportează call_created în loc de connect, fără sesiunea SDP. Un eveniment înrudit se află în altă parte: când un client răspunde la o cerere de permisiune pentru apel, răspunsul ajunge pe câmpul messages, ca mesaj interactiv de tip 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.

Cum arată un webhook de apel?

Aceeași structură ca orice webhook WhatsApp, cu un array calls sub value și field setat la calls. direction are valoarea BUSINESS_INITIATED sau USER_INITIATED, from și to conțin numerele de telefon, to_user_id BSUID-ul clientului, iar oricare dintre numere poate lipsi pentru un client care folosește un nume de utilizator. metadata.phone_number_id identifică numărul dumneavoastră, ca la orice alt câmp. Acesta este exemplul Call Connect al Meta, cu substituenții așa cum îi afișează 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"
        }
      ]
    }
  ]
}

Ce câmpuri adaugă evenimentul terminate?

terminate este evenimentul pe care îl stochează cele mai multe sisteme, deoarece închide apelul. Câmpurile sale, conform referinței Meta:

  • status: COMPLETED când apelul s-a încheiat fără erori neașteptate, inclusiv apelurile fără răspuns; FAILED când nu s-a conectat sau s-a întrerupt.
  • start_time, end_time și duration în secunde: prezente doar dacă cealaltă parte a răspuns.
  • errors: code, message, href și error_data.details pentru un apel FAILED.
  • biz_opaque_callback_data: șirul dumneavoastră de urmărire, dacă l-ați transmis la inițierea sau acceptarea apelului.

Funcționează webhook-urile de apeluri pe un număr Coexistence?

Ghidul Coexistence al Meta răspunde în tabelul de funcționalități: apelurile vocale și video nu se schimbă în aplicația WhatsApp Business și nu sunt suportate prin Cloud API pentru un număr conectat în acest mod. Cerințele prealabile ale Calling API spun același lucru din cealaltă parte: numărul firmei trebuie să fie folosit cu Cloud API, nu cu aplicația WhatsApp Business. Așadar, pe un număr Coexistence, clienții continuă să sune ca înainte, apelul sună în aplicația de pe telefon, iar câmpul calls nu are ce raporta. O firmă care are nevoie de apeluri în software folosește un număr exclusiv pe Cloud API.

Cum se leagă evenimentele unui apel?

Prin ID-ul apelului, care începe cu wacid și se repetă la fiecare eveniment al apelului respectiv. Un apel inițiat de firmă raportează connect cu răspunsul SDP, statusurile RINGING și apoi ACCEPTED sau REJECTED, și în final terminate. Un apel inițiat de utilizator raportează connect cu o ofertă SDP pe care stack-ul dumneavoastră o va răspunde, apoi terminate. Evenimentele de înregistrare și transcriere, când sunt activate, vin după terminate. Stocați evenimentele după perechea id și event, deoarece reîncercările le repetă, iar ordinea de sosire nu este garantată. Lista completă a cerințelor prealabile ale Calling API se află pe pagina despre apeluri pe un număr Coexistence.

Ce poate face AI-ul dumneavoastră cu apelurile pe un număr Coexistence?

Lucrează în chat, în timp ce apelurile rămân la persoana de la telefon. easyCoexistence nu se abonează la câmpul calls și nu are instrumente pentru apeluri; conectorul și automatizările sale acoperă mesajele și șabloanele. În practică, un răspuns AI poate spune unui client când este disponibil cineva cu care să vorbească și la ce număr să sune, o automatizare pe cuvinte cheie poate răspunde la „apel” sau „telefon” cu aceste informații, iar proprietarul preia apelul din aplicația WhatsApp Business ca înainte.

Greșeli frecvente

  • Abonarea la calls pentru un număr Coexistence și așteptarea evenimentelor. Meta enumeră apelurile drept nesuportate prin Cloud API pentru aceste numere.
  • Așteptarea ca start_time și duration să apară la fiecare terminate. Apar doar când apelul a fost preluat; un apel fără răspuns se încheie tot cu COMPLETED.
  • Căutarea răspunsurilor la permisiune pe câmpul calls. Ele sosesc pe messages, ca call_permission_reply interactiv.
  • Lăsarea înregistrărilor și transcrierilor la Meta. Ambele pot fi descărcate timp de 7 zile după webhook-ul lor, apoi dispar.
Faceți acest lucru cu EasyCoexistence

Fiecare număr este monitorizat non-stop, inclusiv regula de 14 zile care deconectează un număr a cărui aplicație nu mai este deschisă. De la US$ 9 la US$ 0,75 pe număr pe lună, scăzând pe măsură ce adăugați numere, cu primele 3 zile de probă gratuite.

Întrebări frecvente

Pierd clienții butonul de apelare când un număr se conectează la API prin Coexistence?

Ghidul Coexistence al Meta enumeră apelurile vocale și video drept neschimbate în aplicația WhatsApp Business. Clienții sună același număr, iar proprietarul răspunde în aplicație, de pe telefon.

Calling API are același preț ca mesajele?

Nu. Pagina de prețuri a Meta spune că Calling API are alt preț și trimite la un document separat cu tarifele pentru apeluri, astfel că taxele pentru apeluri nu apar în obiectul pricing din statusurile mesajelor.

Un apel Calling API poate fi înregistrat sau transcris?

Da, când înregistrarea sau transcrierea este activată. După apel, Meta trimite call_recording_available cu ID-ul media audio sau call_transcription_available cu ID-ul documentului JSON, de obicei într-un minut.

Un webhook de apeluri poate merge la un endpoint diferit de cel al aplicației?

Da. calls este unul dintre câmpurile pe care Meta le permite unui WhatsApp Business Account sau unui număr de telefon să le direcționeze către un URL de callback alternativ, alături de messages și de câmpurile Coexistence.

Continuați să citiți

Gata să începeți?

Configurați WhatsApp Coexistence în câteva minute, nu luni. Aplicația continuă să funcționeze pe telefon.

Începeți perioada de probă gratuită

Verificat la