🚀 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 Pesan WhatsApp

API WhatsApp: kirim pesan, jawab balasannya.

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.

Terakhir diperbarui

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

Satu obrolan. Pembaruan, jawaban, foto, dan tombol.

Template memulai percakapan. Segala sesuatu setelahnya adalah balasan yang dapat dikirim oleh kode Anda.

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

Kirim. Balas. Dapatkan respons. Serahkan.

Pesan

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.

Siaran

Pesan personal, dikirim dalam skala besar.

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

Pembaruan dan peringatan pesanan

Pembaruan yang tepat, saat hal itu terjadi.

Sistem toko, pemesanan, atau penagihan Anda mengirimkan template 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.

Webhook

Setiap balasan, tepat saat pesan masuk.

Webhook mengirimkan pesan baru, tanda terima 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 tag 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 dan DM Instagram

Bangun otomatisasi Instagram juga.

Daftar komentar pada postingan Anda, balas secara publik atau kirim balasan privat.

Mulai

Aktif dalam tiga langkah.

  1. Hubungkan

    Hubungkan nomor Anda

    Tautkan nomor WhatsApp Anda melalui Pendaftaran Tersemat Meta di dalam Wati.

  2. Autentikasi

    Dapatkan token

    Buat token API di Wati dan berikan ruang lingkup (scopes) yang Anda perlukan saja. Simpan token di server Anda.

  3. Kirim

    Lakukan panggilan pertama Anda

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

Permintaan pertama Anda, dijelaskan

Berikut adalah rincian dari sebuah permintaan, dan tempat kemunculan setiap bagian dalam pesan.

  1. Kepada Siapa

    Nomor WhatsApp pelanggan, beserta kode negara.

    phone_number14155552671
  2. Pesan Mana

    Nama templat yang telah disetujui oleh Meta di akun Anda.

    template_nameorder_update
  3. Yang Perlu Diisi

    Nilai untuk bagian yang kosong pada templat, satu per orang.

    custom_paramsname = Mayaorder_id = 10482
  4. Kunci Anda

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

    Authorization: Bearer <token>
  5. Apa yang Anda Dapatkan Kembali

    Status 200 berarti Wati menerima pesan tersebut, beserta broadcast_id. Status Terkirim (Delivered) dan Dibaca (Read) akan diterima nanti melalui webhook.

    200broadcast_id

Teks pesan dan order_update hanyalah contoh. Templat yang Anda setujui menentukan kata-katanya.

Kode siap-salinSembunyikan kode
POST/api/ext/v3/conversations/messages/text
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": "Pesanan Anda 10482 sedang dikirim. Balas di sini untuk mengubah alamat."
  }'
200 Contoh responsContoh dokumentasi, dipangkas
{
  "message": {
    "id": "507f1f77bcf86cd799439011",
    "type": "text",
    "text": "Pesanan Anda 10482 sedang dikirim. Balas di sini untuk mengubah alamat.",
    "owner": true,
    "local_message_id": "88aed3c93a050b3c53978463",
    "conversation_id": "685bd235e6119686e693a093",
    "created": "2026-07-14T16:15:38.3992421Z",
    "event_type": "message"
  }
}
Fitur Bawaan

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

Onboarding nomor

Terhubung melalui Embedded Signup Meta. WhatsApp Business Account didaftarkan atas nama bisnis Anda.

Status templat

Perubahan persetujuan, kualitas, dan kategori dikirim 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 laju dan antrean

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

Peralihan ke agen manusia

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

Token API bersakelar

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

Pengiriman terjadwal

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

Estimasi biaya di awal

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

Di balik layar

Endpoint berdasarkan kapabilitas.

Templat

Mulai percakapan dengan templat yang telah disetujui, sekarang atau terjadwal.

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

Siaran

Baca hasil kampanye dan status per penerima, serta dapatkan estimasi biaya di awal.

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 chatbot untuk kontak tertentu.

Dokumentasi →
GET/chatbotsPOST/chatbots/start

Webhook

Kelola langganan dan lihat 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 tertentu.

Dokumentasi →
POST/contactsPUT/contactsPOST/segments/evaluate

Kotak masuk tim

Tugaskan operator, ubah status, serta tambah atau hapus label.

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

Instagram

Daftar 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}/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 ke-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 secara transparan.

30 hingga 100 per 10 dtk

Pengiriman templat

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

10.000 penerima

Per panggilan pengiriman v3

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

24 jam jendela

Balasan bebas

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

429 Retry-After

Saat Anda mengirim terlalu cepat

Wati memberi tahu Anda berapa lama waktu tunggu yang diperlukan. Pesan yang diterima diproses dalam antrean.

Detail batasan laju dan ketersediaan paket
Batasan laju 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 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.

FAQ

Pertanyaan yang sering diajukan

Referensi API lengkap bersifat publik. Baca dokumentasi

Bisakah saya mengirim pembaruan pesanan dan pengingat menggunakan API?

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.

Apa yang dapat saya kirim setelah pelanggan membalas?

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.

Bagaimana saya tahu bahwa pesan telah dikirim?

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.

Apakah saya harus bisa ngoding?

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.

Berapa batas tingkat (rate limit) API?

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.

Apa perbedaan antara aplikasi WhatsApp Business dan API?

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

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.

Pesan pertama Anda hanya berjarak satu permintaan.

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