Lewati ke konten utama
Version: 1.0

Pengantar API Whatsapp Business

Pada halaman ini dijabarkan penggunaan API Whatsapp Business Platform.

Alur Penggunaan​

  • Daftarkan Akun Whatsapp Oficial.
  • Ajukan template pesan dan tunggu status template untuk disetujui.
  • Gunakan template yang telah disetujui untuk mengirim pesan broadcast (lihat bagian Kirim Pesan Broadcast di bawah).
  • Untuk mengirim pesan Balasan dan Interaktif, diperlukan ruang percakapan aktif antara Gateway Anda dan penerima.

Tipe Pesan​

Broadcast​

Kirim pesan menggunakan template yang telah disetujui.

Pesan Balasan​

Kirim pesan teks bebas, media, atau dokumen. Jenis pesan ini memerlukan ruang percakapan aktif untuk dapat mengirim jenis pesan ini.

Interaktif​

Jenis pesan ini mirip dengan pesan Balasan, yang memerlukan ruang percakapan aktif untuk dapat mengirim jenis pesan ini.

Ada 3 jenis pesan interaktif:

  • Daftar Tombol: pesan dengan daftar pilihan
  • Tombol Balasan: pesan dengan hingga tiga balasan yang telah ditentukan sebelumnya untuk dipilih pengguna.
  • Tombol URL: mengirim tombol URL ajakan bertindak (CTA) interaktif

Message Template​

Template pesan memungkinkan sebuah bisnis menggunakan template yang telah disetujui sebelumnya untuk mengirim pesan terstruktur kepada pelanggannya.

Template terdiri dari empat komponen utama yang Anda tentukan saat membuat template: header, body, footer, dan buttons. Komponen yang Anda pilih untuk setiap template harus berdasarkan kebutuhan bisnis Anda.

Satu-satunya komponen yang diwajibkan adalah komponen body.

Header (Opsional)​

Ada 2 tipe header yaitu teks dan media:

Teks​

Header bertipe teks adalah elemen opsional yang dapat ditambahkan ke bagian atas pesan template. Setiap template hanya dapat menyertakan satu header teks.

Saat pembuatannya, header TEXT mungkin memiliki satu parameter tunggal (opsional).

peringatan

Pemformatan teks menggunakan karakter khusus seperti *, _, dll tidak didukung dalam komponen ini.

Media​

Header bertipe media dapat berupa gambar, video, gif, atau dokumen seperti PDF. Berikut jenis media:

  • DOCUMENT: doc, docx, pdf, ppt, pptx, txt, xlx, and xlsx
    Max: 50 MB
  • IMAGE: jpeg and png
    Max: 5 MB
  • VIDEO: mp4
    Max: 15 MB
  • TEXT: txt

Body (Wajib)​

Komponen body mewakili teks inti pesan template Anda dan merupakan komponen template teks saja. Anda dapat menggunakan format teks, menambahkan emoji.

Teks pesan di komponen body menerima beberapa parameter. Parameter teks ini membantu menyertakan informasi unik untuk setiap pesan.

Add a short line of text to the bottom of your message template.

Buttons (Optional)​

Buttons are optional interactive components that perform specific actions when tapped.

Template dapat memiliki kombinasi hingga 10 komponen tombol secara total, meskipun ada batasan untuk tombol individual (dari jenis yang sama) serta batasan kombinasi berbeda jenis.

Batas dan kombinasi ini dapat Anda lihat saat membuat template di situs web kami.

Status Pesan​

Status pesan untuk pesan adalah

  • sent: pesan akan dikirim ke penerima
  • delivered: pesan telah dikirim ke penerima
  • read: penerima pesan telah membaca pesan
  • failed: pesan gagal dikirim
Alur Status Pesan

Alur status pesan ideal setelah dikirim melalui API atau Antarmuka Web

  1. sent: menunjukkan bahwa Server Whatsapp (Meta) mencoba mengirim pesan ke penerima
  2. delivered: aplikasi WhatsApp penerima (ponsel atau web) menerima pesan.
  3. read: pesan dibaca oleh penerima (jika read receipt si penerima aktif)

Namun, setelah status sent dapat diperbarui menjadi read, kemudian delivered. Ini karena status delivered dan read dikirim ke sistem kami hampir bersamaan.

Dalam beberapa kasus, status pesan mungkin failed.

Daftar Istilah​

Ruang Percakapan​

Ruang percakapan (conversation room) dimulai ketika seseorang mengirim pesan ke gateway Anda. Percakapan ini akan terbuka selama 24 jam. Dalam waktu ini saja, Anda dapat mengirim pesan bertipe teks bebas (balasan) dan pesan interaktif menggunakan endpoint Balasan dan Interaktif.

Gateway​

Gateway adalah akun Whatsapp Business Resmi Anda, yang terintegrasi dengan NusaSMS.

Status Template​

Template harus memiliki status APPROVED sebelum dapat dikirim dalam pesan template. Status template awal adalah PENDING dan yang ditolak adalah REJECTED.