MasukMulai uji coba gratis
Meta Tech Provider

Webhook panggilan WhatsApp: event Calling API, dan panggilan pada nomor Coexistence

Field calls melaporkan event WhatsApp Business Calling API: connect dengan SDP answer atau offer, status panggilan RINGING, ACCEPTED dan REJECTED, terminate dengan COMPLETED atau FAILED beserta durasinya, serta call_recording_available atau call_transcription_available. Panduan Coexistence dari Meta mencantumkan panggilan suara dan video sebagai tidak berubah di aplikasi WhatsApp Business dan tidak didukung di Cloud API, sehingga panggilan tersebut tetap berada di ponsel.

easyCoexistence menghubungkan nomor aplikasi WhatsApp Business Anda ke Cloud API Meta melalui Coexistence, sehingga AI dan otomasi Anda membalas pesan dan mengirim template sementara panggilan tetap berdering di aplikasi di ponsel Anda.

Not supported

Panggilan suara dan video di Cloud API untuk nomor yang di-onboard dengan aplikasi WhatsApp Business; di aplikasi, panggilan tetap seperti biasa.

2,000

Batas minimum pesan harian, dalam penerima unik, yang harus dimiliki nomor sebelum dapat menggunakan Calling API.

7 days

Berapa lama rekaman dan transkrip panggilan dapat diunduh setelah webhook-nya dikirim.

wacid

Awalan ID panggilan, nilai yang menghubungkan webhook connect, status, dan terminate dari sebuah panggilan.

whatsapp_business_messaging

Izin yang dibutuhkan aplikasi untuk menerima webhook panggilan, sama seperti untuk pesan.

Apa yang dilaporkan field webhook panggilan?

Semua yang terjadi pada panggilan yang dilakukan atau diterima melalui Calling API, dalam satu field dengan satu event per tahap. Panggilan yang dimulai bisnis menghasilkan event connect, pembaruan status, dan event terminate. Panggilan yang ditangani melalui SIP melaporkan call_created alih-alih connect, tanpa sesi SDP. Satu event terkait ada di tempat lain: saat pelanggan menjawab permintaan izin panggilan, balasannya tiba di field messages sebagai pesan interaktif bertipe 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.

Seperti apa webhook panggilan?

Envelope yang sama dengan setiap webhook WhatsApp, dengan array calls di bawah value dan field diatur ke calls. direction berisi BUSINESS_INITIATED atau USER_INITIATED, from dan to memuat nomor telepon, to_user_id berisi BSUID pelanggan, dan salah satu nomor bisa tidak ada untuk pelanggan yang memakai username. metadata.phone_number_id mengidentifikasi nomor Anda, seperti pada field lain. Ini contoh Call Connect dari Meta, dengan placeholder seperti yang ditulis 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"
        }
      ]
    }
  ]
}

Field apa yang ditambahkan event terminate?

terminate adalah event yang paling sering disimpan sistem, karena event ini menutup panggilan. Field-nya, menurut referensi Meta:

  • status: COMPLETED saat panggilan berakhir tanpa kesalahan tak terduga, termasuk panggilan yang tidak dijawab; FAILED saat panggilan tidak tersambung atau terputus.
  • start_time, end_time, dan duration dalam detik: hanya ada saat pihak lain mengangkat.
  • errors: code, message, href, dan error_data.details pada panggilan FAILED.
  • biz_opaque_callback_data: string pelacakan Anda sendiri, jika Anda mengirimkannya saat memulai atau menerima panggilan.

Apakah webhook panggilan berfungsi pada nomor Coexistence?

Panduan Coexistence dari Meta menjawab ini dalam tabel fiturnya: panggilan suara dan video tidak berubah di aplikasi WhatsApp Business dan tidak didukung di Cloud API untuk nomor yang di-onboard dengan cara ini. Prasyarat Calling API juga mengatakan hal yang sama dari sisi lain: nomor bisnis harus digunakan dengan Cloud API, bukan aplikasi WhatsApp Business. Jadi pada nomor Coexistence, pelanggan tetap menelepon seperti biasa, panggilan berdering di aplikasi di ponsel, dan field calls tidak memiliki apa pun untuk dilaporkan. Bisnis yang membutuhkan panggilan di perangkat lunak menggunakan nomor di Cloud API saja.

Bagaimana event dari satu panggilan saling terhubung?

Melalui ID panggilan, yang diawali wacid dan berulang di setiap event dari panggilan tersebut. Panggilan yang dimulai bisnis melaporkan connect dengan SDP answer, status RINGING lalu ACCEPTED atau REJECTED, dan terakhir terminate. Panggilan yang dimulai pengguna melaporkan connect dengan SDP offer untuk dijawab oleh stack Anda, lalu terminate. Event rekaman dan transkrip, jika diaktifkan, datang setelah terminate. Simpan event berdasarkan id ditambah event, karena sistem mencoba kembali mengirimkannya dan urutan kedatangan tidak dijamin. Daftar lengkap prasyarat Calling API ada di halaman tentang panggilan pada nomor Coexistence.

Apa yang bisa dilakukan AI Anda terhadap panggilan pada nomor Coexistence?

Bekerja di chat, sementara panggilan tetap ditangani orang di ponsel. easyCoexistence tidak berlangganan field calls dan tidak memiliki tool panggilan; konektor dan otomasinya mencakup pesan dan template. Dalam praktiknya, balasan AI dapat memberi tahu pelanggan kapan seseorang tersedia untuk bicara dan nomor mana yang harus dihubungi, otomasi kata kunci dapat menjawab "call" atau "phone" dengan informasi itu, dan pemilik mengangkat panggilan di aplikasi WhatsApp Business seperti biasa.

Kesalahan umum

  • Berlangganan calls untuk nomor Coexistence lalu menunggu event. Meta mencantumkan panggilan sebagai tidak didukung di Cloud API untuk nomor ini.
  • Mengharapkan start_time dan duration di setiap terminate. Keduanya hanya muncul saat panggilan dijawab; panggilan yang tidak dijawab tetap berakhir COMPLETED.
  • Mencari balasan izin di field calls. Balasan tiba di messages, sebagai call_permission_reply interaktif.
  • Membiarkan rekaman dan transkrip di Meta. Keduanya dapat diunduh selama 7 hari setelah webhook-nya, lalu hilang.
Melakukan ini dengan EasyCoexistence

Setiap nomor dipantau 24/7, termasuk aturan 14 hari yang memutus nomor yang aplikasinya tidak dibuka. US$ 9 turun ke US$ 0.75 per nomor per bulan, makin turun saat Anda menambah nomor, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Apakah pelanggan kehilangan tombol panggilan saat nomor terhubung ke API melalui Coexistence?

Panduan Coexistence dari Meta mencantumkan panggilan suara dan video sebagai tidak berubah di aplikasi WhatsApp Business. Pelanggan menelepon nomor yang sama, dan pemilik menjawab di aplikasi di ponsel.

Apakah Calling API dihargai seperti pesan?

Tidak. Halaman harga Meta menyatakan Calling API memiliki harga yang berbeda dan mengarah ke dokumen harga panggilan terpisah, sehingga biaya panggilan tidak muncul di objek pricing pada status pesan.

Apakah panggilan Calling API dapat direkam atau ditranskrip?

Ya, jika perekaman atau transkripsi diaktifkan. Setelah panggilan, Meta mengirim call_recording_available dengan media id audio atau call_transcription_available dengan document id JSON, biasanya dalam satu menit.

Bisakah webhook panggilan dikirim ke endpoint yang berbeda dari endpoint aplikasi?

Bisa. calls adalah salah satu field yang dapat diarahkan oleh WhatsApp Business Account atau nomor telepon ke URL callback alternatif, bersama messages dan field Coexistence.

Lanjut membaca

Siap memulai?

Konfigurasikan WhatsApp Coexistence dalam hitungan menit, bukan bulan. Aplikasi tetap berfungsi di ponsel.

Mulai uji coba gratis

Diverifikasi pada