Setiap balasan, tepat saat masuk.
Webhook mendorong pesan baru, tanda baca, klik, dan kegagalan ke URL Anda. Tanpa polling.
API Webhook WhatsApp
Pesan baru, tanda terima terkirim dan dibaca, klik tombol, pengiriman gagal, dan peninjauan templat tiba di URL Anda sebagai JSON. 19 jenis peristiwa, dicoba ulang jika server Anda down.
Bagian dari API pengembang WhatsApp.
Terakhir diperbarui
Hentikan polling. Wati mendorong peristiwa dan menunggu 200 dari Anda.
Webhook mendorong pesan baru, tanda baca, klik, dan kegagalan ke URL Anda. Tanpa polling.
Pilih templat yang disetujui dan kirim ke hingga 10.000 penerima. Setiap orang mendapatkan variabel mereka sendiri, dan setiap hasil kembali berdasarkan nomor.
Dalam jendela 24 jam, kirim teks, gambar, file, tombol balasan, dan pemilih daftar, lengkap dengan indikator pengetikan saat Anda bekerja.
Sistem toko, pemesanan, atau penagihan Anda mengirimkan templat yang disetujui saat ada perubahan. Pelanggan mengetuk tombol atau membalas.
Webhook pesan membawa setiap pesan baru ke server Anda. Balas dengan endpoint pengiriman, atau mulai chatbot Wati pada paket Pro dan Business.
Balasan mendarat di kotak masuk tim Wati. Tetapkan operator, atur status, dan tambahkan label melalui API, sehingga orang yang tepat dapat menanganinya.
Buat dan perbarui kontak dengan atribut kustom, lalu pratinjau segmen sebelum Anda mengirim pesan.
Daftarkan komentar pada postingan Anda, balas secara publik atau kirim balasan pribadi.
Tautkan nomor WhatsApp Anda melalui Pendaftaran Tersemat (Embedded Signup) Meta di dalam Wati.
Buat token API di Wati dan berikan cakupan (scope) yang Anda perlukan saja. Simpan di server Anda.
Kirim templat yang disetujui dengan satu permintaan. Kemudian tambahkan webhook untuk memantau pengiriman.
Berikut adalah isi dari satu permintaan, dan di mana setiap bagian akan muncul pada pesan.
Nomor WhatsApp pelanggan, beserta kode negara.
phone_number14155552671Nama templat yang telah disetujui oleh Meta di akun Anda.
template_nameorder_updateNilai untuk bagian kosong di dalam templat, satu per orang.
custom_paramsname = Mayaorder_id = 10482Token API Anda, dikirimkan bersama setiap permintaan. Simpan di server Anda.
Authorization: Bearer <token>Nilai 200 berarti Wati menerima pesan tersebut, beserta broadcast_id. Status terkirim dan dibaca akan menyusul melalui webhook.
200broadcast_idTeks pesan dan order_update adalah contoh. Templat yang Anda setujui akan menentukan kata-katanya.
Komentar yang Anda balas. Anda akan mendapatkan ID-nya saat mengambil daftar komentar pada postingan.
comment_iddi jalur URLAkun Instagram Anda yang terhubung ke Wati.
channelOrang yang menulis komentar, diambil dari komentar yang sama.
userIduserNameTeks biasa hingga 1.000 karakter, atau templat dengan tombol.
type = texttexttype = templateNilai 200 dengan ok diatur ke true berarti balasan privat berhasil dikirim. Gunakan header Authorization yang sama seperti panggilan lainnya.
ok: trueresult: successPOST /api/ext/v3/comments/{comment_id}/privateReply. Komentar dan teks balasan adalah contoh. Lihat permintaan di dokumentasi
Terhubung melalui Pendaftaran Tersemat Meta. Akun WhatsApp Business terdaftar atas nama bisnis Anda.
Perubahan persetujuan, kualitas, dan kategori tiba sebagai webhook, sehingga Anda mengetahuinya sebelum pengiriman gagal.
Hingga 144 kali percobaan ulang, setiap 10 menit. Jika endpoint Anda terus mengalami kegagalan, Wati akan mengirimkan email kepada Anda.
Jika mengirim terlalu cepat, Anda akan mendapatkan kode 429 dengan header Retry-After. Pesan yang diterima akan menunggu di dalam antrean.
Kotak masuk tim bersama untuk percakapan yang seharusnya tidak dijawab oleh kode Anda sendirian.
v3 mendukung token berlingkup, sehingga setiap integrasi hanya mendapatkan akses yang dibutuhkannya.
Jadwalkan pengiriman templat untuk nanti dengan satu panggilan. Wati akan mengirimkannya tepat waktu.
Perkirakan biaya siaran (broadcast) sebelum ada pesan yang dikirim.
Mulai percakapan dengan templat yang disetujui, sekarang atau terjadwal.
Dokumentasi →GET/messageTemplatesPOST/messageTemplates/sendPOST/messageTemplates/scheduleBaca hasil kampanye dan status per penerima, serta perkirakan biaya terlebih dahulu.
Dokumentasi →GET/broadcastsGET/broadcasts/{broadcast_id}/recipientsPOST/broadcasts/estimate-costBalas dengan teks, media, atau tombol dalam jendela 24 jam.
Dokumentasi →POST/conversations/messages/textPOST/conversations/messages/fileViaUrlPOST/conversations/messages/interactivePOST/conversations/typingIndicatorDaftar chatbot Wati Anda dan mulai satu chatbot untuk kontak.
Dokumentasi →GET/chatbotsPOST/chatbots/startKelola langganan dan daftar jenis event yang dapat Anda terima.
Dokumentasi →GET/webhooksGET/webhooks/event-typesPUT/webhooks/{id}Sinkronkan kontak dan atribut dari CRM Anda, lalu targetkan segmen.
Dokumentasi →POST/contactsPUT/contactsPOST/segments/evaluateTetapkan operator, ubah status, tambah atau hapus tag.
Dokumentasi →PUT/conversations/{target}/operatorPUT/conversations/{target}/statusPOST/conversations/{target_conv}/tagsDaftar 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}/permissionsPath 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 chat Messenger dengan teks.
Versi BSUID dari beberapa event juga tersedia. Dokumentasi webhook
Panggilan untuk mengirim templat, tergantung pada paket Anda (Growth, Pro, atau Business).
Satu templat, hingga 10.000 orang, masing-masing dengan variabel mereka sendiri.
Teks, media, dan tombol membutuhkan jendela layanan pelanggan yang terbuka. Di luar itu, kirimkan templat.
Wati memberi tahu Anda berapa lama harus menunggu. Pesan yang diterima akan diproses dalam antrean.
| 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, dicantumkan berdasarkan nama endpoint. Panggilan massal v1 memerlukan hingga 1.000 kontak. Endpoint inti perpesanan, templat, 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 batas yang lebih tinggi, bicarakan dengan Wati mengenai kasus penggunaan Anda.
19 jenis peristiwa WhatsApp, termasuk message, sentMessageDELIVERED_v2, sentMessageREAD_v2, sentMessageREPLIED_v2, templateMessageFailed, templateReviewed, ctaUrlClicked, chatbotTriggered, dan call.status. GET /webhooks/event-types mencantumkan peristiwa yang tersedia untuk ruang kerja Anda.
Wati mengharapkan HTTP 200 untuk setiap peristiwa. Jika tidak mendapatkannya, Wati akan mencoba ulang peristiwa tersebut hingga 144 kali, setiap 10 menit. Jika webhook terus gagal, Wati akan menandainya sebagai rusak dan mengirimkan email kepada Anda.
Daftarkan URL Anda dan pilih jenis peristiwa di dasbor Wati atau melalui API. Anda dapat mencantumkan, memperbarui, dan menghapus langganan dengan endpoint v3 /webhooks. Jaga agar penangan tetap cepat: kembalikan 200 terlebih dahulu, baru lakukan prosesnya.
Tidak sebanyak dulu. Pembuat aplikasi AI dapat menulis panggilan API dari instruksi bahasa Inggris sederhana, dan contoh-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 yang menulis kodenya, pastikan token Anda tetap berada di server.
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 paket Growth, Pro, dan Business. Ketika Anda mencapai batasan, Anda akan mendapatkan HTTP 429 dengan header Retry-After. Untuk batasan yang lebih tinggi, hubungi Wati.
Di WhatsApp, teks bentuk bebas, media, dan pesan interaktif memerlukan jendela layanan pelanggan terbuka selama 24 jam. Di luar jendela tersebut, mulailah percakapan dengan templat yang telah disetujui oleh Meta.
Aplikasi Business ditujukan 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 banyak, mengotomatiskan balasan, menerima webhook, dan membagikan satu nomor ke kotak masuk tim.
Endpoint pesan inti, templat, dan kontak tersedia di setiap paket. Penugasan tim, status obrolan, chatbot, dan segmen kustom membutuhkan paket Pro atau Business. Dokumentasi mencantumkan ketersediaan endpoint berdasarkan paket.
Mulai gratis, hubungkan nomor WhatsApp Anda di Wati, dan lakukan panggilan pertama Anda.