🚀 Get TikTok DMs and Ads in Wati Team Inbox and convert social engagement into revenue See TikTok on Wati🚀 TikTok DMs + Ads now in Team Inbox →

WhatsApp Broadcast APIKirim satu template ke hingga 10.000 pelanggan per panggilan API.

Q: Berapa banyak orang yang dapat saya jangkau dengan satu panggilan Broadcast API?

Hingga 10.000 penerima per panggilan pengiriman v3. Anda mengirim satu templat yang disetujui, dan setiap penerima dapat memiliki variabelnya sendiri, seperti nama atau nomor pesanan. Pengiriman templat dibatasi hingga 30, 60, atau 100 panggilan per 10 detik, tergantung pada paket Anda. Batas perpesanan Meta dan kualitas templat nomor Anda tetap berlaku, jadi hangatkan nomor baru sebelum pengiriman besar-besaran.

Q: Bisakah saya menjadwalkan siaran dan memeriksa biayanya terlebih dahulu?

Ya. POST /messageTemplates/schedule mengirim pada waktu yang Anda pilih, dan POST /broadcasts/estimate-cost memperkirakan biaya sebelum ada yang dikirim.

Q: Bagaimana cara melihat siapa saja yang menerima dan membaca siaran?

Panggil GET /broadcasts untuk kampanye Anda dan GET /broadcasts/{broadcast_id}/recipients untuk status per penerima. Untuk pembaruan waktu nyata, berlanggananlah ke webhook seperti sentMessageDELIVERED_v2, sentMessageREAD_v2, dan templateMessageFailed.

Q: Bagaimana cara mencocokkan hasil dengan catatan saya sendiri?

Berikan local_message_id kepada setiap penerima, seperti ID pesanan Anda. Wati mengembalikannya dalam hasil per penerima dari panggilan pengiriman, di sebelah kesalahan apa pun untuk nomor tersebut.

Q: Bisakah saya memilih nomor WhatsApp mana yang mengirim siaran?

Ya. Lewatkan channel dengan nama atau nomor nomor pengirim. Kosongkan untuk mengirim dari saluran default Anda.

Q: Apakah saya perlu tahu cara membuat kode?

Lebih sedikit dari sebelumnya. Pembuat aplikasi AI dapat menulis panggilan API dari instruksi bahasa Inggris biasa, dan contoh di halaman ini menunjukkan setiap panggilan. Anda tetap memerlukan nomor WhatsApp yang terhubung ke Wati, token API, dan templat yang telah disetujui oleh Meta sebelum Anda dapat memulai percakapan. Jika alat AI menulis kodenya, pastikan token Anda tetap berada di server.

Q: Apa saja batas tingkat (rate limit) API?

Panggilan kontak dan riwayat pesan dibatasi hingga 10 permintaan per 10 detik pada setiap paket. Pengiriman templat dibatasi hingga 30, 60, atau 100 permintaan per 10 detik pada Growth, Pro, dan Business. Saat Anda mencapai batas, Anda akan mendapatkan HTTP 429 dengan header Retry-After. Untuk batas yang lebih tinggi, hubungi Wati.

Satu permintaan mengirimkan template yang disetujui ke hingga 10.000 orang, masing-masing dengan detail mereka sendiri. Jadwalkan, perkirakan biayanya terlebih dahulu, lalu baca hasil per penerima.

Dapatkan akses API Lihat panggilan kirim

Lebih suka tanpa kode? Kirim broadcast WhatsApp dari Wati.

16.000+bisnis di 190+ negara
4,6/5peringkat rata-rata di G2
ResmiMeta Business Partner dan WhatsApp BSP

Satu permintaan. Hingga 10.000 pelanggan.

Setiap orang mendapatkan nama, pesanan, atau tanggal mereka sendiri. Setiap hasil dikembalikan berdasarkan nomor.

Dimulai dengan templateTemplate yang disetujui membuka percakapan, untuk satu pelanggan atau hingga 10.000 per panggilan.
Dilanjutkan dalam obrolan, atau melalui panggilanTeks, media, dan tombol setelah pelanggan membalas, atau panggilan suara di utas yang sama.
Berakhir dengan tim AndaWebhook memberi tahu kode Anda. Kotak masuk tim memberi tahu orang-orang Anda.

Produk

Kirim. Balas. Dapatkan respons. Teruskan.

Broadcast

Pesan personal, dikirim secara massal.

Pilih templat yang disetujui dan jangkau hingga 10.000 penerima. Setiap orang mendapatkan variabel mereka sendiri, dan setiap hasil kembali berdasarkan nomor.

Perpesanan

Balas lebih dari sekadar teks.

Dalam jendela 24 jam, kirim teks, gambar, file, tombol balasan, dan pemilih daftar, lengkap dengan indikator pengetikan saat Anda bekerja.

Pembaruan dan peringatan pesanan

Pembaruan yang tepat, saat hal itu terjadi.

Toko, sistem pemesanan, atau sistem penagihan Anda akan mengirimkan templat yang disetujui saat terjadi perubahan. Pelanggan mengetuk tombol atau membalas.

Balasan otomatis dan chatbot

Kode Anda yang menjawab.

Webhook pesan membawa setiap pesan baru ke server Anda. Balas menggunakan endpoint pengiriman, atau mulai chatbot Wati pada paket Pro dan Business.

Webhook

Setiap balasan, tepat saat pesan diterima.

Webhook mendorong pesan baru, tanda telah dibaca, klik, dan kegagalan ke URL Anda. Tanpa polling.

Kotak masuk tim

Kode yang memulai. Manusia yang menyelesaikan.

Balasan masuk ke kotak masuk tim Wati. Tetapkan operator, atur status, dan tambahkan label melalui API, sehingga orang yang tepat dapat menanganinya.

Kontak dan segmen

CRM Anda, tercermin di Wati.

Buat dan perbarui kontak dengan atribut kustom, lalu pratinjau segmen sebelum Anda mengirimkan pesan.

InstagramKomentar Instagram

Bangun otomatisasi Instagram juga.

Daftar komentar di postingan Anda, balas secara publik, atau kirim balasan privat. DM Instagram juga berfungsi: balas percakapan aktif melalui REST atau melalui server Wati MCP.

Mulai

Aktif dalam tiga langkah.

Hubungkan
Hubungkan nomor Anda
Tautkan nomor WhatsApp Anda melalui Pendaftaran Sematan (Embedded Signup) Meta di dalam Wati.
Autentikasi
Dapatkan token
Buat token API di Wati dan berikan cakupan (scope) yang Anda perlukan saja. Simpan di server Anda.
Kirim
Lakukan panggilan pertama Anda
Kirimkan templat yang disetujui dengan satu permintaan (request). Kemudian tambahkan webhook untuk melacak pengiriman.

Penjelasan permintaan pertama Anda

Berikut adalah isi dari satu permintaan, dan letak kemunculan setiap bagian pada pesan.

Siapa
Nomor WhatsApp pelanggan, beserta kode negara.
phone_number14155552671
Pesan apa
Nama templat yang telah disetujui Meta di akun Anda.
template_nameorder_update
Apa yang harus diisi
Nilai untuk bagian yang kosong pada templat, satu per orang.
custom_paramsname = Mayaorder_id = 10482
Kunci Anda
Token API Anda, dikirimkan dengan setiap permintaan. Simpan di server Anda.
Authorization: Bearer <token>
Apa yang Anda dapatkan
Status 200 berarti Wati menerima pesan tersebut, beserta broadcast_id. Status terkirim dan dibaca akan menyusul melalui webhook.
200broadcast_id

Teks pesan dan order_update adalah contoh. Templat yang disetujui menentukan susunan kata Anda.

Komentar yang mana
Komentar yang Anda balas. Anda akan mendapatkan ID-nya saat mencantumkan komentar sebuah postingan.
comment_iddi jalur URL
Dari akun mana
Akun Instagram Anda yang terhubung ke Wati.
channel
Kepada siapa
Orang yang menulis komentar, diambil dari komentar yang sama.
userIduserName
Apa yang dikirim
Teks biasa hingga 1.000 karakter, atau templat dengan tombol.
type = texttexttype = template
Apa yang Anda dapatkan
Status 200 dengan ok bernilai true berarti balasan privat berhasil terkirim. Gunakan header Authorization yang sama seperti pemanggilan lainnya.
ok: trueresult: success

POST /api/ext/v3/comments/{comment_id}/privateReply. Teks komentar dan balasan adalah contoh. Lihat permintaan di dokumentasi

Fragment 2 of 2. Translate only the text inside this item.

Contoh dalam cURL, Node, Python, dan PHP. Permintaan yang dipilih cocok dengan halaman ini.

POST/api/ext/v3/messageTemplates/send

curl -X POST "https://live-mt-server.wati.io/api/ext/v3/messageTemplates/send" \
  -H "Authorization: Bearer $WATI_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "template_name": "order_update",
    "broadcast_name": "order_update_api",
    "recipients": [
      {
        "phone_number": "14155552671",
        "custom_params": [
          { "name": "name", "value": "Maya" },
          { "name": "order_id", "value": "10482" }
        ]
      }
    ]
  }'

200Contoh responsBentuk dari contoh dokumentasi

{
  "success": true,
  "broadcast_id": "broadcast_123456",
  "recipients": [
    {
      "local_message_id": "local-msg-123",
      "phone_number": "14155552671",
      "errors": []
    }
  ]
}

URL Server untuk wilayah ruang kerja Anda

Globalhttps://mcp.wati.io/mcp

EUhttps://eu-mcp.wati.io/mcp

Klien dengan konfigurasi mcpServers

{
  "mcpServers": {
    "wati": {
      "url": "https://mcp.wati.io/mcp"
    }
  }
}

Claude Code

claude mcp add --transport http wati https://mcp.wati.io/mcp

Masuk dengan OAuth saat klien Anda meminta. Tidak ada kunci API yang dimasukkan ke dalam konfigurasi. Untuk ruang kerja EU, gunakan URL EU. Dokumentasi MCP

Bawaan

Hal-hal yang ditangani Wati sehingga Anda tidak perlu repot.

Pendaftaran nomor

Hubungkan melalui Embedded Signup Meta. Akun WhatsApp Business didaftarkan ke bisnis Anda.

Status templat

Persetujuan, kualitas, dan perubahan kategori dikirimkan sebagai webhook, sehingga Anda tahu sebelum pengiriman gagal.

Percobaan ulang webhook

Hingga 144 kali percobaan ulang, setiap 10 menit. Jika endpoint Anda terus gagal, Wati akan mengirimkan email kepada Anda.

Batasan tingkat (rate limit) dan antrean

Jika mengirim terlalu cepat, Anda akan mendapatkan kode 429 beserta header Retry-After. Pesan yang diterima akan menunggu dalam antrean.

Alih tangan ke agen manusia

Kotak masuk tim bersama untuk percakapan yang seharusnya tidak dijawab sendirian oleh kode Anda.

Token API berlingkup (scoped)

v3 mendukung token berlingkup, sehingga setiap integrasi hanya mendapatkan akses yang dibutuhkannya.

Pengiriman terjadwal

Jadwalkan pengiriman templat untuk nanti dengan satu panggilan. Wati akan mengirimkannya tepat waktu.

Perkiraan biaya terlebih dahulu

Perkirakan biaya siaran (broadcast) sebelum ada pesan yang dikirim.

Di balik layar

Endpoint berdasarkan kapabilitas.

Apa saja yang ada dalam panggilan siaran (broadcast)

Field permintaan untuk POST /messageTemplates/send
Field	Wajib	Catatan
`template_name`	Ya	Template yang disetujui di akun Anda. Cantumkan dengan `GET /messageTemplates`.
`broadcast_name`	Ya	Label Anda sendiri untuk pengiriman ini
`recipients`	Ya	1 hingga 10.000 orang, masing-masing dengan `phone_number`
`custom_params`	Per penerima	Pasangan nama dan nilai untuk variabel template
`local_message_id`	Tidak	ID Anda sendiri, dikembalikan dalam hasil per penerima
`channel`	Tidak	Nomor pengirim, berdasarkan nama atau nomor. Saluran default jika dikosongkan.

Dari skema endpoint pengiriman v3. Respons memiliki success, broadcast_id, dan errors per penerima.

Template

Mulai percakapan dengan template yang disetujui, sekarang atau terjadwal.

Dokumentasi →

GET/messageTemplatesPOST/messageTemplates/sendPOST/messageTemplates/schedule

Siaran (Broadcast)

Baca hasil kampanye dan status per penerima, serta estimasikan biaya terlebih dahulu.

Dokumentasi →

GET/broadcastsGET/broadcasts/{broadcast_id}/recipientsPOST/broadcasts/estimate-cost

Perpesanan

Balas dengan teks, media, atau tombol dalam jendela 24 jam.

Dokumentasi →

POST/conversations/messages/textPOST/conversations/messages/fileViaUrlPOST/conversations/messages/interactivePOST/conversations/typingIndicator

Chatbot Pro+

Daftarkan chatbot Wati Anda dan mulai chatbot untuk kontak.

Dokumentasi →

GET/chatbotsPOST/chatbots/start

Webhook

Kelola langganan dan cantumkan jenis event yang dapat Anda terima.

Dokumentasi →

GET/webhooksGET/webhooks/event-typesPUT/webhooks/{id}

Kontak & segmen

Sinkronkan kontak dan atribut dari CRM Anda, lalu targetkan segmen.

Dokumentasi →

POST/contactsPUT/contactsPOST/segments/evaluate

Kotak masuk tim

Tetapkan operator, ubah status, tambah atau hapus tag.

Dokumentasi →

PUT/conversations/{target}/operatorPUT/conversations/{target}/statusPOST/conversations/{target_conv}/tags

Panggilan

Baca log panggilan, rekaman, transkrip, dan ringkasan. Hanya-baca.

Dokumentasi →

GET/callsGET/calls/{call_id}/transcriptGET/calls/{call_id}/summary

Instagram

Daftar postingan dan komentar, balas secara publik atau pribadi, periksa izin.

Dokumentasi →

GET/posts/{post_id}/commentsPOST/comments/{comment_id}/repliesPOST/comments/{comment_id}/privateReplyGET/channels/{channel}/permissions

Path bersifat relatif terhadap https://live-mt-server.wati.io/api/ext/v3. Pembuatan webhook menggunakan path lama POST /{tenantId}/api/v2/webhookEndpoints.

Untuk agen AI, server Wati MCP mencakup tindakan WhatsApp yang sama, dan dapat membalas DM Instagram serta obrolan Messenger dengan teks.

Lihat semua 19 jenis event webhook WhatsApp

Pesan

message
newContactMessageReceived
sessionMessageSent_v2
templateMessageSent_v2

Status pengiriman

sentMessageDELIVERED_v2
sentMessageREAD_v2
sentMessageREPLIED_v2
templateMessageFailed

Template dan akun

templateReviewed
templateQualityUpdated
templateCategoryUpdated
wabaStatusReviewUpdate
PhoneNumberQualityUpdatedEvent
accountUpdated
accountDeleted
phoneNumberDeleted

Keterlibatan dan panggilan

chatbotTriggered
ctaUrlClicked
call.status

Event WhatsApp saja: belum ada event webhook Instagram. Versi BSUID dari beberapa event juga tersedia. Dokumentasi Webhook

Batasan dan paket

Batasan yang jelas. Dipublikasikan.

30 hingga 100 per 10 dtk

Pengiriman template

Panggilan untuk mengirim template, bergantung pada paket Anda (Growth, Pro, atau Business).

10.000 penerima

Per panggilan pengiriman v3

Satu template, hingga 10.000 orang, masing-masing dengan variabelnya sendiri.

24 jam jendela

Balasan bentuk bebas

Teks, media, dan tombol memerlukan jendela layanan pelanggan yang terbuka. Di luar itu, kirimkan template.

429 Retry-After

Saat Anda terlalu cepat

Wati memberi tahu Anda berapa lama harus menunggu. Pesan yang diterima diproses dalam antrean.

Batasan rate limit dan ketersediaan paket secara detail

Batasan rate limit yang didokumentasikan berdasarkan paket
Endpoint	Growth	Pro	Business
`/addContact`, `/getContacts`	10 / 10 dtk	10 / 10 dtk	10 / 10 dtk
`/getMessages`	10 / 10 dtk	10 / 10 dtk	10 / 10 dtk
`/sendTemplateMessage`	30 / 10 dtk	60 / 10 dtk	100 / 10 dtk
`/sendTemplateMessages`	30 / 10 dtk	60 / 10 dtk	100 / 10 dtk

Batasan seperti yang dipublikasikan pada Errors & Rate Limits, tercantum berdasarkan nama endpoint. Panggilan massal v1 memerlukan hingga 1.000 kontak. Endpoint perpesanan inti, template, dan kontak tersedia di setiap paket. Penugasan tim, status obrolan, chatbot, dan segmen kustom memerlukan paket Pro atau Business. Memperbarui atribut untuk banyak kontak sekaligus memerlukan paket Business. Ketersediaan endpoint berdasarkan paket. Untuk batasan yang lebih tinggi, bicarakan dengan Wati mengenai kasus penggunaan Anda.

Jelajahi Wati API

FAQ

Pertanyaan yang sering diajukan

Referensi API lengkap bersifat publik. Baca dokumentasi

Berapa banyak orang yang dapat saya jangkau dengan satu panggilan Broadcast API?

Hingga 10.000 penerima per panggilan kirim v3. Anda mengirim satu templat yang disetujui, dan setiap penerima dapat memiliki variabelnya sendiri, seperti nama atau nomor pesanan. Pengiriman templat dibatasi hingga 30, 60, atau 100 panggilan per 10 detik, tergantung pada paket Anda. Batas perpesanan Meta dan kualitas templat nomor Anda tetap berlaku, jadi hangatkan nomor baru sebelum pengiriman massal.

Bisakah saya menjadwalkan siaran dan memeriksa biayanya terlebih dahulu?

Ya. POST /messageTemplates/schedule mengirim pada waktu yang Anda pilih, dan POST /broadcasts/estimate-cost memperkirakan biaya sebelum ada yang dikirim.

Bagaimana cara melihat siapa saja yang menerima dan membaca siaran?

Panggil GET /broadcasts untuk kampanye Anda dan GET /broadcasts/{broadcast_id}/recipients untuk status per penerima. Untuk pembaruan waktu nyata, berlangganan webhook seperti sentMessageDELIVERED_v2, sentMessageREAD_v2, dan templateMessageFailed.

Bagaimana cara mencocokkan hasil dengan catatan saya sendiri?

Berikan local_message_id kepada setiap penerima, seperti ID pesanan Anda. Wati mengembalikannya dalam hasil per-penerima dari panggilan pengiriman, di sebelah kesalahan apa pun untuk nomor tersebut.

Bisakah saya memilih nomor WhatsApp mana yang mengirimkan siaran?

Ya. Teruskan channel dengan nama atau nomor dari nomor pengirim. Kosongkan untuk mengirim dari saluran default Anda.

Apakah saya harus bisa membuat kode (coding)?

Tidak sebanyak sebelumnya. Pembuat aplikasi AI dapat menulis panggilan API dari instruksi bahasa Inggris biasa, dan contoh di halaman ini menunjukkan setiap panggilan.

Anda tetap memerlukan nomor WhatsApp yang terhubung ke Wati, token API, dan templat yang telah disetujui Meta sebelum Anda dapat memulai percakapan. Jika alat AI menulis kodenya, pastikan token Anda tetap berada di server.

Apa saja batas laju (rate limits) API?

Panggilan riwayat kontak dan pesan dibatasi hingga 10 permintaan per 10 detik pada setiap paket. Pengiriman templat dibatasi hingga 30, 60, atau 100 permintaan per 10 detik pada Growth, Pro, dan Business. Saat Anda mencapai batas, Anda akan mendapatkan HTTP 429 dengan header Retry-After. Untuk batas yang lebih tinggi, hubungi Wati.

Bisakah saya mengirim pesan ke pelanggan kapan saja?

Di WhatsApp, teks bentuk bebas, media, dan pesan interaktif memerlukan jendela layanan pelanggan 24 jam yang terbuka. Di luar jendela tersebut, mulai percakapan dengan templat yang telah disetujui oleh Meta.

Apa perbedaan antara aplikasi WhatsApp Business dan API?

Aplikasi Business adalah untuk obrolan manual di ponsel, dengan hingga 5 perangkat tertaut dan daftar siaran yang dibatasi hingga 256 kontak. API menghubungkan WhatsApp ke sistem Anda sendiri. Anda dapat mengirim templat yang disetujui dalam jumlah besar, mengotomatiskan balasan, menerima webhook, dan membagikan satu nomor di kotak masuk tim.

Pesan pertama Anda hanya berjarak satu permintaan.

Dapatkan akses, hubungkan nomor WhatsApp Anda di Wati, dan lakukan panggilan pertama Anda.

Dapatkan akses API Baca dokumentasi

WhatsApp Broadcast APIKirim satu template ke hingga 10.000 pelanggan per panggilan API.

Satu permintaan. Hingga 10.000 pelanggan.

Kirim. Balas. Dapatkan respons. Teruskan.

Pesan personal, dikirim secara massal.

Balas lebih dari sekadar teks.

Pembaruan yang tepat, saat hal itu terjadi.

Kode Anda yang menjawab.

Setiap balasan, tepat saat pesan diterima.

Kode yang memulai. Manusia yang menyelesaikan.

CRM Anda, tercermin di Wati.

Bangun otomatisasi Instagram juga.

Aktif dalam tiga langkah.

Hubungkan nomor Anda

Dapatkan token

Lakukan panggilan pertama Anda

Penjelasan permintaan pertama Anda

URL Server untuk wilayah ruang kerja Anda

Klien dengan konfigurasi mcpServers

Claude Code

Hal-hal yang ditangani Wati sehingga Anda tidak perlu repot.

Pendaftaran nomor

Status templat

Percobaan ulang webhook

Batasan tingkat (rate limit) dan antrean

Alih tangan ke agen manusia

Token API berlingkup (scoped)

Pengiriman terjadwal

Perkiraan biaya terlebih dahulu

Endpoint berdasarkan kapabilitas.

Apa saja yang ada dalam panggilan siaran (broadcast)

Template

Siaran (Broadcast)

Perpesanan

Chatbot Pro+

Webhook

Kontak & segmen

Kotak masuk tim

Panggilan

Instagram

Pesan

Status pengiriman

Template dan akun

Keterlibatan dan panggilan

Batasan yang jelas. Dipublikasikan.

Pengiriman template

Per panggilan pengiriman v3

Balasan bentuk bebas

Saat Anda terlalu cepat

Jelajahi Wati API

Pertanyaan yang sering diajukan

Pesan pertama Anda hanya berjarak satu permintaan.