Log masukMulakan percubaan percuma
Meta Tech Provider

Webhook panggilan WhatsApp: peristiwa Calling API dan panggilan pada nombor Coexistence

Medan webhook calls melaporkan peristiwa WhatsApp Business Calling API: sambung dengan jawapan atau tawaran SDP, status panggilan RINGING, ACCEPTED dan REJECTED, tamat dengan COMPLETED atau FAILED serta tempoh, dan call_recording_available atau call_transcription_available. Panduan Coexistence Meta menyenaraikan panggilan suara dan video sebagai tidak berubah dalam aplikasi WhatsApp Business dan tidak disokong pada Cloud API, jadi panggilan tersebut kekal pada telefon.

easyCoexistence menyambungkan nombor aplikasi WhatsApp Business anda ke Cloud API Meta melalui Coexistence, supaya AI dan automasi anda menjawab mesej dan menghantar template manakala panggilan terus berdering dalam aplikasi di telefon anda.

Not supported

Panggilan suara dan video pada Cloud API bagi nombor yang didaftarkan dengan aplikasi WhatsApp Business; dalam aplikasi, ia tidak berubah.

2,000

Had mesej harian minimum, dalam penerima unik, yang diperlukan oleh nombor sebelum boleh menggunakan Calling API.

7 days

Berapa lama rakaman dan transkrip panggilan kekal boleh dimuat turun selepas webhook dihantar.

wacid

Awalan ID panggilan, nilai yang menghubungkan webhook sambung, status dan tamat bagi sesuatu panggilan.

whatsapp_business_messaging

Kebenaran yang diperlukan oleh aplikasi untuk menerima webhook calls, sama seperti bagi mesej.

Apakah yang dilaporkan oleh medan webhook calls?

Segala yang berlaku kepada panggilan yang dibuat atau diterima melalui Calling API, dalam satu medan dengan satu peristiwa bagi setiap peringkat. Panggilan yang dimulakan oleh perniagaan menghasilkan peristiwa sambung, kemas kini status dan peristiwa tamat. Panggilan yang dikendalikan melalui SIP melaporkan call_created dan bukannya sambung, tanpa sesi SDP. Satu peristiwa berkaitan terdapat di tempat lain: apabila pelanggan menjawab permintaan kebenaran panggilan, jawapan tiba pada medan messages sebagai mesej interaktif jenis 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.

Bagaimana rupa webhook panggilan?

Sampul yang sama dengan setiap webhook WhatsApp, dengan tatasusunan calls di bawah value dan field ditetapkan kepada calls. direction menyatakan BUSINESS_INITIATED atau USER_INITIATED, from dan to membawa nombor telefon, to_user_id ialah BSUID pelanggan, dan mana-mana nombor boleh tiada bagi pelanggan yang menggunakan nama pengguna. metadata.phone_number_id mengenal pasti nombor anda, sama seperti pada mana-mana medan lain. Ini ialah contoh Call Connect daripada Meta, dengan pemegang tempat seperti yang Meta paparkan:

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"
        }
      ]
    }
  ]
}

Medan apakah yang ditambah oleh peristiwa tamat?

terminate ialah peristiwa yang paling kerap disimpan oleh sistem, kerana ia menutup panggilan. Medannya, mengikut rujukan Meta:

  • status: COMPLETED apabila panggilan tamat tanpa ralat yang tidak dijangka, termasuk panggilan yang tidak dijawab; FAILED apabila ia tidak tersambung atau terputus.
  • start_time, end_time dan duration dalam saat: hadir hanya apabila pihak seberang menjawab.
  • errors: code, message, href dan error_data.details pada panggilan FAILED.
  • biz_opaque_callback_data: rentetan penjejakan anda sendiri, apabila anda menghantarnya semasa memulakan atau menerima panggilan.

Adakah webhook panggilan berfungsi pada nombor Coexistence?

Panduan Coexistence Meta menjawab soalan ini dalam jadual ciri: panggilan suara dan video tidak berubah dalam aplikasi WhatsApp Business dan tidak disokong pada Cloud API bagi nombor yang didaftarkan dengan cara ini. Prasyarat Calling API sendiri menyatakan perkara yang sama dari sisi lain: nombor perniagaan mesti digunakan dengan Cloud API, bukan aplikasi WhatsApp Business. Jadi pada nombor Coexistence, pelanggan terus membuat panggilan seperti biasa, panggilan berdering dalam aplikasi di telefon, dan medan calls tidak ada apa-apa untuk dilaporkan. Perniagaan yang memerlukan panggilan dalam perisian menggunakan nombor pada Cloud API sahaja.

Bagaimana peristiwa bagi satu panggilan saling berkait?

Melalui ID panggilan, yang bermula dengan wacid dan berulang pada setiap peristiwa panggilan itu. Panggilan yang dimulakan oleh perniagaan melaporkan sambung dengan jawapan SDP, status RINGING kemudian ACCEPTED atau REJECTED, dan akhirnya tamat. Panggilan yang dimulakan oleh pengguna melaporkan sambung dengan tawaran SDP untuk timbunan anda menjawab, kemudian tamat. Peristiwa rakaman dan transkrip, apabila diaktifkan, datang selepas tamat. Simpan peristiwa mengikut id ditambah event, kerana percubaan semula mengulang peristiwa dan susunan ketibaan tidak dijamin. Senarai lengkap prasyarat Calling API terdapat pada halaman tentang panggilan pada nombor Coexistence.

Apa yang boleh dilakukan AI anda tentang panggilan pada nombor Coexistence?

Berfungsi dalam sembang, manakala panggilan kekal dengan orang di telefon. easyCoexistence tidak melanggan medan calls dan tidak mempunyai alat panggilan; penyambungnya dan automasi meliputi mesej dan template. Dalam amalan, ini bermakna balasan AI boleh memberitahu pelanggan bila seseorang sedia untuk bercakap dan nombor mana untuk dihubungi, automasi kata kunci boleh menjawab "call" atau "phone" dengan maklumat tersebut, dan pemilik menjawab panggilan dalam aplikasi WhatsApp Business seperti biasa.

Kesilapan biasa

  • Melanggan calls untuk nombor Coexistence dan menunggu peristiwa. Meta menyenaraikan panggilan sebagai tidak disokong pada Cloud API bagi nombor ini.
  • Menjangka start_time dan duration pada setiap tamat. Ia hanya muncul apabila panggilan dijawab; panggilan yang tidak dijawab tetap berakhir dengan COMPLETED.
  • Mencari jawapan kebenaran pada medan calls. Ia tiba pada messages, sebagai mesej interaktif call_permission_reply.
  • Membiarkan rakaman dan transkrip bersama Meta. Kedua-duanya boleh dimuat turun selama 7 hari selepas webhook, selepas itu ia hilang.
Menggunakan EasyCoexistence untuk ini

Setiap nombor dipantau 24/7, termasuk peraturan 14 hari yang memutuskan sambungan nombor yang aplikasinya tidak dibuka. Daripada US$ 9 hingga US$ 0.75 sebulan bagi setiap nombor yang disambungkan, menurun apabila anda menambah nombor, dengan 3 hari pertama percuma.

Soalan lazim

Adakah pelanggan kehilangan butang panggilan apabila nombor disambungkan ke API melalui Coexistence?

Panduan Coexistence Meta menyenaraikan panggilan suara dan video sebagai tidak berubah dalam aplikasi WhatsApp Business. Pelanggan menghubungi nombor yang sama, dan pemilik menjawab dalam aplikasi di telefon.

Adakah Calling API dikenakan harga seperti mesej?

Tidak. Halaman harga Meta menyatakan Calling API mempunyai harga yang berbeza dan merujuk kepada dokumen harga panggilan yang berasingan, jadi caj panggilan tidak muncul dalam objek pricing bagi status mesej.

Bolehkah panggilan Calling API dirakam atau ditranskripsikan?

Ya, apabila rakaman atau transkripsi diaktifkan. Selepas panggilan, Meta menghantar call_recording_available dengan id media audio atau call_transcription_available dengan id dokumen JSON, biasanya dalam masa seminit.

Bolehkah webhook panggilan dihantar ke endpoint yang berbeza daripada endpoint aplikasi?

Ya. calls ialah salah satu medan yang dibenarkan Meta untuk dihalakan oleh Akaun WhatsApp Business atau nombor telefon ke URL panggilan balik alternatif, bersama messages dan medan Coexistence.

Teruskan membaca

Sedia untuk bermula?

Sediakan WhatsApp Coexistence dalam beberapa minit, bukan berbulan-bulan. Aplikasi terus berfungsi pada telefon.

Mulakan Percubaan Percuma

Disahkan pada