🚀 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 →

API Webhook WhatsApp

API webhook WhatsApp: ketahui saat apa pun berubah.

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.

Terakhir diperbarui

  • 16.000+bisnis di 190+ negara
  • 4,6/5peringkat rata-rata di G2
  • ResmiMitra Bisnis Meta dan BSP WhatsApp
G2 Leader, ChatbotsG2 Leader Mid-Market, ChatbotsG2 Momentum Leader, ChatbotsG2 Most Implementable, WhatsApp MarketingISO 27001GDPR

Satu URL. Setiap status, secara real-time.

Hentikan polling. Wati mendorong peristiwa dan menunggu 200 dari Anda.

  • Dimulai dengan templatTemplat yang disetujui membuka percakapan, untuk satu pelanggan atau 10.000 pelanggan.
  • Dilanjutkan dalam obrolanTeks, media, dan tombol setelah pelanggan membalas.
  • Berakhir dengan tim AndaWebhook memberi tahu kode Anda. Kotak masuk tim memberi tahu staf Anda.
Produk

Kirim. Balas. Dapatkan tanggapan. Lanjutkan ke staf.

Webhook

Setiap balasan, tepat saat masuk.

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

Siaran

Pesan personal, dikirim dalam skala besar.

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

Pesan

Balas dengan 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.

Sistem toko, pemesanan, atau penagihan Anda mengirimkan templat yang disetujui saat ada perubahan. Pelanggan mengetuk tombol atau membalas.

Balasan otomatis dan chatbot

Kode Anda yang menjawab.

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

Kotak masuk tim

Kode yang memulainya. Manusia yang menyelesaikannya.

Balasan mendarat di 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 mengirim pesan.

InstagramKomentar dan DM Instagram

Bangun otomatisasi Instagram juga.

Daftarkan komentar pada postingan Anda, balas secara publik atau kirim balasan pribadi.

Mulai

Aktif dalam tiga langkah.

  1. Hubungkan

    Hubungkan nomor Anda

    Tautkan nomor WhatsApp Anda melalui Pendaftaran Tersemat (Embedded Signup) Meta di dalam Wati.

  2. Autentikasi

    Dapatkan token

    Buat token API di Wati dan berikan cakupan (scope) yang Anda perlukan saja. Simpan di server Anda.

  3. Kirim

    Lakukan panggilan pertama Anda

    Kirim templat yang disetujui dengan satu permintaan. Kemudian tambahkan webhook untuk memantau pengiriman.

Permintaan pertama Anda, dijelaskan

Berikut adalah isi dari satu permintaan, dan di mana setiap bagian akan muncul pada pesan.

  1. Siapa

    Nomor WhatsApp pelanggan, beserta kode negara.

    phone_number14155552671
  2. Pesan yang mana

    Nama templat yang telah disetujui oleh Meta di akun Anda.

    template_nameorder_update
  3. Apa yang harus diisi

    Nilai untuk bagian kosong di dalam templat, satu per orang.

    custom_paramsname = Mayaorder_id = 10482
  4. Kunci Anda

    Token API Anda, dikirimkan bersama setiap permintaan. Simpan di server Anda.

    Authorization: Bearer <token>
  5. Apa yang Anda dapatkan kembali

    Nilai 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 Anda setujui akan menentukan kata-katanya.

Kode siap salinSembunyikan kode
WEBHOOKperistiwa pesan masuk, POST /api/ext/v3/conversations/messages/text keluar
# 1. Wati mengirim POST untuk setiap pesan baru ke URL webhook Anda (event: message).
# 2. Kode Anda mengambil jawaban dan mengirimkannya kembali:
curl -X POST "https://live-mt-server.wati.io/api/ext/v3/conversations/messages/text" \
  -H "Authorization: Bearer $WATI_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "target": "14155552671",
    "text": "Ya, kami buka dari pukul 09.00 hingga 21.00."
  }'
IN Yang dikirim Wati ke URL AndaContoh dari dokumentasi, diringkas
{
  "eventType": "message",
  "id": "69282478274a880fe782b2d9",
  "conversationId": "68c8d56157578adb12ada249",
  "waId": "14155552671",
  "senderName": "Maya",
  "type": "text",
  "text": "Apakah besok kalian buka?",
  "owner": false,
  "timestamp": "1764238453"
}
Fitur Bawaan

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

Onboarding nomor

Terhubung melalui Pendaftaran Tersemat Meta. Akun WhatsApp Business terdaftar atas nama bisnis Anda.

Status templat

Perubahan persetujuan, kualitas, dan kategori tiba sebagai webhook, sehingga Anda mengetahuinya sebelum pengiriman gagal.

Percobaan ulang webhook

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

Batas tarif dan antrean

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

Pengalihan ke manusia

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

Token API berlingkup

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.

Templat

Mulai percakapan dengan templat yang disetujui, sekarang atau terjadwal.

Dokumentasi →
GET/messageTemplatesPOST/messageTemplates/sendPOST/messageTemplates/schedule

Siaran (Broadcast)

Baca hasil kampanye dan status per penerima, serta perkirakan 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+

Daftar chatbot Wati Anda dan mulai satu chatbot untuk kontak.

Dokumentasi →
GET/chatbotsPOST/chatbots/start

Webhook

Kelola langganan dan daftar 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

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 chat 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

Templat dan akun

  • templateReviewed
  • templateQualityUpdated
  • templateCategoryUpdated
  • wabaStatusReviewUpdate
  • PhoneNumberQualityUpdatedEvent
  • accountUpdated
  • accountDeleted
  • phoneNumberDeleted

Keterlibatan dan panggilan

  • chatbotTriggered
  • ctaUrlClicked
  • call.status

Versi BSUID dari beberapa event juga tersedia. Dokumentasi webhook

Batasan dan paket

Batasan yang jelas. Dipublikasikan.

30 hingga 100 per 10 dtk

Pengiriman templat

Panggilan untuk mengirim templat, tergantung pada paket Anda (Growth, Pro, atau Business).

10.000 penerima

Per panggilan pengiriman v3

Satu templat, hingga 10.000 orang, masing-masing dengan variabel mereka sendiri.

24 jam jendela

Balasan bentuk bebas

Teks, media, dan tombol membutuhkan jendela layanan pelanggan yang terbuka. Di luar itu, kirimkan templat.

429 Retry-After

Saat Anda mengirim terlalu cepat

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

Batasan tarif dan ketersediaan paket secara detail
Batasan tarif yang didokumentasikan berdasarkan paket
EndpointGrowthProBusiness
/addContact, /getContacts10 / 10 dtk10 / 10 dtk10 / 10 dtk
/getMessages10 / 10 dtk10 / 10 dtk10 / 10 dtk
/sendTemplateMessage30 / 10 dtk60 / 10 dtk100 / 10 dtk
/sendTemplateMessages30 / 10 dtk60 / 10 dtk100 / 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.

FAQ

Pertanyaan yang sering diajukan

Referensi API lengkap bersifat publik. Baca dokumentasi

Peristiwa apa saja yang dapat dikirimkan oleh webhook Wati?

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.

Apa yang terjadi jika server saya down?

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.

Bagaimana cara menyiapkan webhook WhatsApp?

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.

Apakah saya harus tahu cara melakukan coding?

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.

Berapa batasan 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 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.

Bisakah saya mengirim pesan ke pelanggan kapan saja?

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.

Apa perbedaan antara aplikasi WhatsApp Business dan API?

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 mana saja yang tersedia di paket saya?

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.

Pesan pertama Anda hanya berjarak satu permintaan.

Mulai gratis, hubungkan nomor WhatsApp Anda di Wati, dan lakukan panggilan pertama Anda.