Balas dengan lebih dari sekadar teks.
Dalam jendela 24 jam, kirim teks, gambar, file, tombol balas, dan pemilih daftar, lengkap dengan indikator pengetikan saat Anda bekerja.
API Pesan WhatsApp
Kirim pembaruan pesanan, pengingat, dan peringatan dengan template yang disetujui. Saat pelanggan membalas, jawab dengan teks, foto, tombol, atau daftar, dan tampilkan indikator pengetikan saat Anda bekerja.
Bagian dari API pengembang WhatsApp.
Terakhir diperbarui
Template memulai percakapan. Segala sesuatu setelahnya adalah balasan yang dapat dikirim oleh kode Anda.
Dalam jendela 24 jam, kirim teks, gambar, file, tombol balas, dan pemilih daftar, lengkap dengan indikator pengetikan saat Anda bekerja.
Pilih template yang disetujui dan kirimkan hingga 10.000 penerima. Setiap orang mendapatkan variabel mereka sendiri, dan setiap hasil kembali berdasarkan nomor.
Sistem toko, pemesanan, atau penagihan Anda mengirimkan template 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.
Webhook mengirimkan pesan baru, tanda terima telah dibaca, klik, dan kegagalan ke URL Anda. Tanpa polling.
Balasan masuk ke kotak masuk tim Wati. Tetapkan operator, atur status, dan tambahkan tag melalui API, sehingga orang yang tepat dapat menanganinya.
Buat dan perbarui kontak dengan atribut kustom, lalu pratinjau segmen sebelum Anda mengirimkan pesan.
Daftar komentar pada postingan Anda, balas secara publik atau kirim balasan privat.
Tautkan nomor WhatsApp Anda melalui Pendaftaran Tersemat Meta di dalam Wati.
Buat token API di Wati dan berikan ruang lingkup (scopes) yang Anda perlukan saja. Simpan token di server Anda.
Kirim templat yang disetujui dengan satu permintaan. Lalu tambahkan webhook untuk memantau pengiriman.
Berikut adalah rincian dari sebuah permintaan, dan tempat kemunculan setiap bagian dalam pesan.
Nomor WhatsApp pelanggan, beserta kode negara.
phone_number14155552671Nama templat yang telah disetujui oleh Meta di akun Anda.
template_nameorder_updateNilai untuk bagian yang kosong pada templat, satu per orang.
custom_paramsname = Mayaorder_id = 10482Token API Anda, dikirimkan dengan setiap permintaan. Simpan di server Anda.
Authorization: Bearer <token>Status 200 berarti Wati menerima pesan tersebut, beserta broadcast_id. Status Terkirim (Delivered) dan Dibaca (Read) akan diterima nanti melalui webhook.
200broadcast_idTeks pesan dan order_update hanyalah contoh. Templat yang Anda setujui menentukan kata-katanya.
Komentar yang Anda balas. Anda akan mendapatkan ID-nya saat melihat daftar komentar postingan.
comment_iddi jalur URLAkun Instagram Anda yang terhubung ke Wati.
channelOrang yang menulis komentar tersebut, diambil dari komentar yang sama.
userIduserNameTeks biasa hingga 1.000 karakter, atau templat dengan tombol.
type = texttexttype = templateStatus 200 dengan ok bernilai true berarti balasan pribadi berhasil dikirim. Gunakan header Authorization yang sama seperti panggilan lainnya.
ok: trueresult: successPOST /api/ext/v3/comments/{comment_id}/privateReply. Komentar dan teks balasan hanyalah contoh. Lihat permintaan di dokumentasi
Terhubung melalui Embedded Signup Meta. WhatsApp Business Account didaftarkan atas nama bisnis Anda.
Perubahan persetujuan, kualitas, dan kategori dikirim 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 terlalu cepat, Anda akan mendapatkan kode 429 dengan header Retry-After. Pesan yang diterima akan menunggu dalam antrean.
Kotak masuk tim bersama untuk percakapan yang seharusnya tidak dijawab oleh kode Anda sendirian.
v3 mendukung token bersakelar, 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 telah disetujui, sekarang atau terjadwal.
Dokumentasi →GET/messageTemplatesPOST/messageTemplates/sendPOST/messageTemplates/scheduleBaca hasil kampanye dan status per penerima, serta dapatkan estimasi biaya di awal.
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 chatbot untuk kontak tertentu.
Dokumentasi →GET/chatbotsPOST/chatbots/startKelola langganan dan lihat 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 tertentu.
Dokumentasi →POST/contactsPUT/contactsPOST/segments/evaluateTugaskan operator, ubah status, serta tambah atau hapus label.
Dokumentasi →PUT/conversations/{target}/operatorPUT/conversations/{target}/statusPOST/conversations/{target_conv}/tagsDaftar postingan dan komentar, balas secara publik atau pribadi, serta 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 obrolan Messenger dengan teks.
Versi BSUID dari beberapa event juga tersedia. Dokumentasi webhook
Panggilan untuk mengirim templat, bergantung pada paket Anda (Growth, Pro, atau Business).
Satu templat, hingga 10.000 orang, masing-masing dengan variabelnya sendiri.
Teks, media, dan tombol memerlukan jendela layanan pelanggan yang terbuka. Di luar itu, kirimkan templat.
Wati memberi tahu Anda berapa lama waktu tunggu yang diperlukan. Pesan yang diterima 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 dapat memuat hingga 1.000 kontak. Endpoint perpesanan inti, templat, dan kontak tersedia di semua 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, konsultasikan kasus penggunaan Anda dengan Wati.
Ya. Panggil POST /messageTemplates/send dengan templat yang disetujui dan detail pelanggan, seperti nama atau nomor pesanan. Templat dapat memulai percakapan kapan saja, sehingga cocok untuk pembaruan pesanan, pengingat, dan peringatan.
Selama 24 jam setelah pesan terakhir pelanggan, Anda dapat mengirim pesan bebas: teks dengan /conversations/messages/text, file dengan /conversations/messages/fileViaUrl, serta tombol balas atau pemilih daftar dengan /conversations/messages/interactive. Di luar rentang waktu tersebut, kirimkan templat sebagai gantinya.
Respons 200 berarti Wati telah menerima pesan, bukan berarti pesan telah terkirim. Pembaruan pengiriman, dibaca, dan gagal akan diterima melalui webhook, misalnya sentMessageDELIVERED_v2, sentMessageREAD_v2, dan templateMessageFailed.
Tidak sesulit dulu. Pembuat aplikasi AI dapat menulis panggilan API berdasarkan instruksi bahasa sehari-hari, 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.
Panggilan kontak dan riwayat pesan dibatasi hingga 10 permintaan per 10 detik di setiap paket. Pengiriman templat dibatasi hingga 30, 60, atau 100 permintaan per 10 detik pada paket Growth, Pro, dan Business. Ketika Anda mencapai batas, Anda akan mendapatkan HTTP 429 dengan header Retry-After. Untuk batas yang lebih tinggi, hubungi Wati.
Aplikasi Business ditujukan untuk obrolan manual di ponsel, dengan hingga 5 perangkat tertaut dan daftar siaran (broadcast) 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 berbagi satu nomor di kotak masuk tim (team inbox).
Endpoint perpesanan 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 buat panggilan pertama Anda.