API Pengelolaan WhatsApp Business

Pengaturan Webhooks

Silakan berlangganan Webhooks untuk mendapatkan notifikasi perubahan pada pengaturan Akun WhatsApp Business dan sinyal kualitas Anda.

Pengaturan Webhooks tidak akan memengaruhi nomor telepon pada Aplikasi WhatsApp Business Anda. Hanya setelah Anda memigrasi nomor Anda ke Platform WhatsApp Business, Anda tidak bisa lagi menggunakan nomor itu di Aplikasi WhatsApp Business.

Membuat Endpoint

Sebelum Anda dapat mulai menerima notifikasi, Anda harus membuat endpoint di server Anda untuk menerima notifikasi.

Endpoint harus dapat memproses dua jenis permintaan HTTPS: Permintaan Verifikasi dan Notifikasi Peristiwa. Karena kedua permintaan ini menggunakan HTTP, server harus memiliki TLS yang valid atau sertifikat SSL yang secara tepat dikonfigurasi dan diinstal. Sertifikat yang ditandatangani sendiri tidak didukung.

Pelajari selengkapnya tentang Memverifikasi Permintaan dan Notifikasi Peristiwa

Berlangganan Webhooks

Untuk berlangganan Webhooks, Anda harus mendapatkan ID dan izin Aplikasi Meta. Untuk melakukan ini, buka Dasbor Aplikasi Meta. Di sana Anda akan:

  1. Membuat Aplikasi Meta di Dasbor Aplikasi Meta
  2. Menambahkan Produk Webhooks ke aplikasi Meta Anda di Dasbor Aplikasi

    Setiap saat, setiap Aplikasi Meta hanya dapat memiliki satu endpoint yang dikonfigurasi. Jika Anda perlu mengirim pembaruan Webhooks ke beberapa endpoint, Anda memerlukan beberapa Aplikasi Meta.

Ketika Anda siap meningkatkan skala berkirim pesan bisnis, Anda mungkin perlu:

  1. Menambahkan izin whatsapp_business_management di Dasbor Aplikasi Anda
  2. Berhasil menyelesaikan Tinjauan Aplikasi Meta – Langkah ini akan memakan waktu tetapi Anda dapat terus menguji selama seluruh proses tinjauan.

Kolom Langganan yang Tersedia

Kolom Langganan yang Tersedia

Nama Kolom Deskripsi

account_review_update

Notifikasi dikirimkan kepada Anda ketika Akun WhatsApp Business telah ditinjau.

account_update

Notifikasi dikirimkan kepada Anda ketika telah terjadi perubahan pada akun WhatsApp Business Anda. Perubahan ini dapat mencakup pembaruan nomor telepon, pelanggaran kebijakan, Akun WhatsApp Business telah diblokir, dan banyak lagi.

business_capability_update

Notifikasi dikirimkan kepada Anda ketika kemampuan telah diperbarui. Ini dapat mencakup perubahan untuk jumlah maksimum nomor telepon yang dapat dimiliki WABA atau jumlah percakapan per nomor telepon.

message_template_status_update

Notifikasi dikirimkan kepada Anda ketika template pesan telah disetujui atau ditolak, atau jika telah dinonaktifkan.

messages

Notifikasi dikirimkan kepada Anda ketika bisnis Anda telah menerima pesan dari pelanggan, saat Anda mengirim pesan kepada pelanggan, saat pesan disampaikan kepada pelanggan, dan saat pesan Anda dibaca oleh pelanggan.

phone_number_name_update

Notifikasi dikirimkan kepada Anda ketika nama yang terkait dengan nomor telepon telah disetujui atau ditolak.

phone_number_quality_update

Notifikasi dikirimkan kepada Anda ketika ada pembaruan status terkait kualitas untuk nomor telepon.

security

Notifikasi dikirimkan kepada Anda ketika:

  • Anda meminta untuk menonaktifkan kode verifikasi dua langkah
  • kode verifikasi dua langkah dinonaktifkan
  • kode verifikasi dua langkah diperbarui

    • Kunjungi Referensi Webhooks Akun WhatsApp Business untuk informasi selengkapnya tentang setiap kolom muatan dan Referensi Webhooks Cloud API WhatsApp untuk informasi selengkapnya tentang berbagi jenis notifikasi messages yang dapat Anda terima.

    Payload Notifikasi

    Semua notifikasi memiliki format umum berikut:

    [{
    "object": "whatsapp_business_account",
    "entry": [{
       "id": "{whatsapp-business-account-id}",
        "time": {unix-timestamp},
        "changes": [{
            "field": "{subscribed-field}",
            "value": {
                # Information that was update
            }
          }]
      }]
  }]

    Array level teratas berisi dua objek utama:

    ParameterDeskripsi

    object

    Ini adalah objek langganan.

    entry

    Objek ini berisi detail perubahan yang memicu panggilan Webhooks.

    Lihat Komponen untuk semua objek Webhooks yang tersedia.

    Contoh Endpoint Aplikasi