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

API Panggilan Bisnis WhatsApp: suara dan obrolan dalam satu nomor.

Pelanggan mengetuk ikon panggilan di obrolan yang sudah mereka gunakan, dan panggilan tersebut masuk ke kotak masuk tim Wati Anda di sebelah pesan. Tarik log panggilan, rekaman, transkrip, dan ringkasan ke sistem Anda sendiri melalui API.

  • Segera hadirLog panggilan, rekaman, transkrip, ringkasan, dan webhook call.status

Terakhir diperbarui

Posisi Panggilan WhatsApp saat ini

KapabilitasCara Anda menggunakannyaStatus
Log panggilan, rekaman, transkrip, dan ringkasanREST APISegera hadir

Diskusikan kasus penggunaan Anda dengan kami.

  • 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 utas. Obrolan, panggilan, dan transkrip.

Setiap panggilan berada di sebelah pesan di sekitarnya, lengkap dengan rekaman, transkrip, dan ringkasannya.

  • 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 orang-orang Anda.
Produk

Kirim. Balas. Dapatkan respons. Serahkan.

Siaran

Pesan pribadi, dikirim dalam skala besar.

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 dengan 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 di Pro dan Business.

Webhook

Setiap balasan, tepat saat pesan diterima.

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

Kotak masuk tim

Kode yang memulai. Orang 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 mengirim pesan.

InstagramKomentar dan DM Instagram

Bangun otomatisasi Instagram juga.

Cantumkan 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 Meta di dalam Wati.

  2. Autentikasi

    Dapatkan token

    Buat token API di Wati dan berikan hanya cakupan yang Anda perlukan. Simpan di server Anda.

  3. Kirim

    Lakukan panggilan pertama Anda

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

Permintaan pertama Anda, dijelaskan

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

  1. Siapa

    Nomor WhatsApp pelanggan, dengan kode negara.

    phone_number14155552671
  2. Pesan yang mana

    Nama templat yang telah disetujui Meta di akun Anda.

    template_nameorder_update
  3. Apa yang harus diisi

    Nilai untuk bagian kosong dalam 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

    Angka 200 berarti Wati menerima pesan tersebut, beserta broadcast_id. Status Terkirim dan Dibaca akan tiba belakangan 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.

Onboarding nomor

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

Status templat

Persetujuan, perubahan 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 laju dan antrean

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

Alih tangan ke manusia

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

Token API bersaklar (scoped)

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

Pengiriman terjadwal

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

Estimasi biaya di awal

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

Di balik layar

Endpoint berdasarkan kapabilitas.

Templat

Mulai percakapan dengan templat yang disetujui, sekarang atau dijadwalkan.

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

Siaran (Broadcast)

Baca hasil kampanye dan status per penerima, serta dapatkan estimasi 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 salah satunya untuk kontak tertentu.

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 tertentu.

Dokumentasi →
POST/contactsPUT/contactsPOST/segments/evaluate

Kotak masuk tim

Tetapkan operator, ubah status, serta 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, Wati MCP server 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

Interaksi dan panggilan

  • chatbotTriggered
  • ctaUrlClicked
  • call.status

Versi BSUID dari beberapa event juga tersedia. Dokumentasi webhook

Batas dan paket

Batas yang jelas. Dipublikasikan secara terbuka.

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 berjalan terlalu cepat

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

Detail batas laju dan ketersediaan paket
Batas 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

Batas seperti yang dipublikasikan di Errors & Rate Limits, tercantum berdasarkan nama endpoint. Panggilan massal v1 memerlukan hingga 1.000 kontak. Endpoint pesan inti, 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 Business. Ketersediaan endpoint berdasarkan paket. Untuk batas yang lebih tinggi, diskusikan kasus penggunaan Anda dengan Wati.

FAQ

Pertanyaan yang sering diajukan

Referensi API lengkap bersifat publik. Baca dokumentasi

Apa itu API Panggilan WhatsApp?

Ini adalah ekstensi suara resmi dari Meta untuk Platform WhatsApp Business. Bisnis dapat melakukan dan menerima panggilan suara di dalam utas WhatsApp yang sama yang digunakan pelanggan untuk mengirim pesan. Wati adalah Solusi Bisnis Resmi (Business Solution Provider), dan panggilan akan muncul di kotak masuk tim Wati bersama dengan riwayat obrolan.

Apa saja yang dicakup oleh API Panggilan Wati?

Log panggilan dengan GET /calls, serta rekaman, transkrip, dan ringkasan setiap panggilan, satu per satu atau dalam bentuk batch. Webhook call.status memberi tahu sistem Anda saat status panggilan berubah.

Bisakah bisnis saya menelepon pelanggan di WhatsApp?

Ya, dengan izin mereka. Pelanggan dapat menelepon Anda dari obrolan. Untuk panggilan yang dimulai oleh bisnis, Meta mengharuskan pelanggan untuk menerima permintaan izin panggilan terlebih dahulu: satu permintaan per pelanggan setiap 24 jam, maksimal dua dalam 7 hari, dan panggilan harus dilakukan dalam waktu 72 jam setelah disetujui.

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 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 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 header Retry-After. Untuk batas 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 diperuntukkan bagi 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 membagikan satu nomor ke seluruh 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 memerlukan paket Pro atau Business. Dokumentasi mencantumkan ketersediaan endpoint berdasarkan paket.

Pesan pertama Anda berjarak satu permintaan saja.

Hubungkan nomor WhatsApp Anda di Wati dan lakukan panggilan pertama Anda. Hubungi kami jika Anda ingin data panggilan masuk ke dalam sistem Anda sendiri.