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

API pengembang WhatsApp, yang terintegrasi ke dalam produk Anda.

Kirim templat, balas di obrolan, terima kembali melalui webhook, dan teruskan ke tim Anda. Satu URL dasar, satu token bearer.

Terakhir diperbarui

  • 16.000+bisnis di 190+ negara
  • 4,6/5rata-rata ulasan di G2
  • ResmiMitra Bisnis Meta dan BSP WhatsApp
Pemimpin G2, ChatbotPemimpin G2 Pasar Menengah, ChatbotPemimpin Momentum G2, ChatbotPaling Mudah Diterapkan G2, Pemasaran WhatsAppISO 27001GDPR

Satu API. Setiap percakapan WhatsApp.

Mulai dengan templat, lanjutkan di obrolan, ikuti melalui webhook, dan selesaikan di kotak masuk tim Anda.

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

Kirim. Balas. Terima tanggapan. Serahkan.

Siaran

Pesan pribadi, dikirim secara massal.

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

Pesan

Balas lebih dari sekadar teks.

Dalam jendela 24 jam, kirim teks, gambar, file, tombol balas, dan pemilih daftar, 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.

Webhook

Setiap balasan, tepat saat pesan masuk.

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

Kotak masuk tim

Kode yang memulai. Manusia yang menyelesaikan.

Balasan mendarat di 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 (Embedded Signup) Meta di dalam Wati.

  2. Autentikasi

    Dapatkan token

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

  3. Kirim

    Lakukan panggilan pertama Anda

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

Penjelasan permintaan pertama Anda

Berikut adalah rincian dari satu permintaan dan lokasi kemunculan setiap bagian dalam pesan.

  1. Siapa

    Nomor WhatsApp pelanggan, beserta kode negara.

    phone_number14155552671
  2. Pesan mana

    Nama templat yang telah disetujui Meta di akun Anda.

    template_nameorder_update
  3. Apa yang harus diisi

    Nilai untuk bagian kosong pada templat, satu nilai 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

    Kode 200 berarti Wati menerima pesan tersebut, beserta broadcast_id. Status terkirim (delivered) dan dibaca (read) akan menyusul melalui webhook.

    200broadcast_id

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

Kode siap salinSembunyikan kode
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" }
        ]
      }
    ]
  }'
200 Contoh responsBentuk dari contoh dokumentasi
{
  "success": true,
  "broadcast_id": "broadcast_123456",
  "recipients": [
    {
      "local_message_id": "local-msg-123",
      "phone_number": "14155552671",
      "errors": []
    }
  ]
}
Fitur Bawaan

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

Pendaftaran nomor

Terhubung melalui Pendaftaran Tersemat Meta. Akun WhatsApp Business terdaftar untuk 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 gagal, Wati akan mengirimkan email kepada Anda.

Batasan tingkat dan antrean

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

Alih tangan ke manusia

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

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.

Estimasi biaya terlebih dahulu

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

Di balik layar

Endpoint, berdasarkan kapabilitasnya.

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 biayanya 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 salah satunya untuk kontak tertentu.

Dokumentasi →
GET/chatbotsPOST/chatbots/start

Webhook

Kelola langganan dan buat daftar jenis peristiwa 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 label.

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 obrolan Messenger dengan teks.

Lihat ke-19 jenis peristiwa 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

Interaksi dan panggilan

  • chatbotTriggered
  • ctaUrlClicked
  • call.status

Versi BSUID dari beberapa peristiwa juga tersedia. Dokumentasi webhook

Batasan dan paket

Batasan yang jelas. Dipublikasikan.

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 bentuk bebas

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

429 Retry-After

Saat Anda bergerak terlalu cepat

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

Detail batasan tingkat dan ketersediaan paket
Batasan tingkat 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 memuat hingga 1.000 kontak. Perpesanan inti, templat, dan endpoint kontak tersedia di setiap paket. Penugasan tim, status obrolan, chatbot, dan segmen kustom memerlukan Pro atau Business. Memperbarui atribut untuk banyak kontak sekaligus memerlukan Business. Ketersediaan endpoint berdasarkan paket. Untuk batasan yang lebih tinggi, bicarakan kasus penggunaan Anda dengan Wati.

FAQ

Pertanyaan yang sering diajukan

Referensi API lengkap bersifat publik. Baca dokumentasi

Apakah Wati memiliki WhatsApp API?

Ya. Wati API mencakup templat, siaran, perpesanan, kontak, segmen, tindakan kotak masuk tim, dan webhook WhatsApp. Integrasi baru sebaiknya menggunakan v3 di https://live-mt-server.wati.io/api/ext/v3 dengan token pembawa (bearer token). Referensi lengkapnya bersifat publik di docs.wati.io.

Haruskah saya menggunakan v3 atau API v1 versi lama?

Gunakan v3 untuk pekerjaan baru. Titik akhir (endpoint) v3 memiliki permintaan dan tanggapan bertipe, galat terstruktur, serta token API berlingkup. Titik akhir v1 versi lama, di bawah /{tenantId}/api/v1, tetap didukung.

Apakah Wati API dapat bekerja dengan Instagram atau Messenger?

WhatsApp adalah inti dari API ini. Untuk Instagram, API mencakup komentar: mencantumkan postingan dan komentar, membalas secara publik, mengirim balasan pribadi, serta memeriksa izin. Melalui server Wati MCP, agen AI juga dapat membalas DM Instagram dan obrolan Messenger dengan teks.

Apakah saya harus bisa ngoding?

Lebih sedikit dari sebelumnya. Pembuat aplikasi AI dapat menulis panggilan API dari instruksi bahasa Inggris sederhana, 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 yang menulis kode, 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. Saat Anda mencapai batas, Anda akan mendapatkan HTTP 429 dengan tajuk 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 24 jam yang terbuka. 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 di seluruh kotak masuk tim.

Titik akhir mana saja yang ada di paket saya?

Titik akhir perpesanan inti, templat, dan kontak tersedia di setiap paket. Penugasan tim, status obrolan, chatbot, dan segmen kustom memerlukan paket Pro atau Business. Dokumentasi mencantumkan ketersediaan titik akhir berdasarkan paket.

Pesan pertama Anda hanya berjarak satu permintaan.

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