Cara Menggunakan API Papo untuk Mengirim Template Pesan WhatsApp (HSM)

Open in

View as Markdown

Open in ChatGPT Open in Claude

Vitor

Terakhir diperbarui saat Oct 19, 2026

Dengan Papo (https://papo.global/), Anda dapat menggunakan API REST untuk mengirim template pesan yang disetujui (HSM) di WhatsApp, mengotomatiskan notifikasi transaksional dan kampanye tanpa mengakses antarmuka. API ini memungkinkan Anda mendaftar kotak masuk Cloud API dari akun Anda, mengambil template yang disetujui oleh Meta, dan mengirimkannya ke satu atau beberapa kontak, asalkan Anda memiliki token API dan template telah disinkronkan di platform.

Tindakan API	Apa yang dilakukan	Contoh penggunaan
Daftar kotak masuk WhatsApp	Mengembalikan kotak masuk WhatsApp Cloud API yang terkait dengan akun	Pilih kotak yang benar sebelum pengiriman
Daftar template yang disetujui	Mengembalikan template pesan (HSM) dengan status "disetujui" untuk kotak masuk tertentu	Periksa HSM yang tersedia untuk pengiriman
Kirim HSM ke satu kontak	Mengirim template yang disetujui ke satu nomor telepon, mengisi variabel	Notifikasi pesanan, pengingat jadwal
Kirim HSM ke beberapa kontak	Mengirim template yang sama ke daftar kontak sekaligus	Kampanye pemasaran, pengumuman massal

Cara kerja pengiriman HSM melalui API

API Papo mencerminkan fungsionalitas platform. Untuk mengirim template pesan WhatsApp, Anda tidak perlu membuat sesuatu yang baru melalui kode: template dibuat dan dikirimkan langsung di Meta Business Manager dan, setelah disetujui, secara otomatis muncul di akun Papo Anda. API hanya menanyakan daftar template yang disetujui dan melakukan pengiriman.

Alur integrasi yang umum terdiri dari:

Buat token API di panel Papo.
Identifikasi kotak masuk WhatsApp Cloud API tempat template disinkronkan.
Dapatkan daftar template yang disetujui (HSM) dari kotak tersebut.
Siapkan permintaan dengan parameter yang diperlukan: ID template, bahasa, nomor penerima dengan kode negara, dan nilai variabel (jika template berisi {{1}}, {{2}}, dll.).
Kirim permintaan — baik untuk satu kontak atau untuk sekumpulan nomor, masing-masing dengan variabel khususnya.

Langkah-langkah menggunakan API

1. Buat token API

Di menu pengaturan akun Papo Anda, akses bagian API atau token akses. Buat token dengan izin yang diperlukan untuk mengelola percakapan dan pesan. Simpan token di tempat yang aman; token akan dikirim di header semua permintaan.

2. Daftar kotak WhatsApp yang tersedia

Sebelum mengirim template apa pun, Anda perlu mengetahui kotak masuk (inbox) mana yang berisi template yang disetujui. Gunakan endpoint yang mengembalikan kotak WhatsApp Cloud API dari akun Anda. Catat pengidentifikasi kotak yang ingin Anda gunakan — itu akan wajib pada langkah berikutnya.

3. Periksa template yang disetujui (HSM)

Dengan pengidentifikasi kotak di tangan, panggil endpoint yang mendaftar template dengan status APPROVED. Respons akan memberikan untuk setiap template nama, bahasa yang tersedia, kategori (Marketing, Utilitas, atau Autentikasi), dan parameter yang diharapkan. Langkah ini penting untuk mengonfirmasi bahwa template telah dirilis dan untuk mengetahui variabel mana yang harus diisi.

4. Susun permintaan pengiriman

Operasi pengiriman ke satu kontak pada dasarnya memerlukan:

ID template (atau nama, tergantung implementasi).
Bahasa template (misalnya, pt_BR).
Nomor telepon kontak, termasuk kode negara (contoh: 5511999999999).
Objek dengan nilai variabel, jika template berisi placeholder.

Untuk pengiriman massal (beberapa kontak), panggilan menerima daftar penerima, masing-masing dengan nomornya dan, secara opsional, variabelnya sendiri. Template sama untuk semua.

5. Kirim dan verifikasi respons

API mengembalikan konfirmasi sinkron bahwa permintaan pengiriman telah diterima. Untuk melacak status pengiriman sebenarnya (terkirim, dibaca, gagal), Anda dapat mengonfigurasi webhook outbound — Papo memberi tahu secara real-time peristiwa percakapan. Artikel tentang penerimaan peristiwa real-time (terdaftar di "Baca juga") menjelaskan cara mengaktifkan fitur ini.

Siapa yang harus menggunakan API untuk pengiriman HSM

Bisnis apa pun yang ingin mengotomatiskan komunikasi transaksional dari sistem eksternal akan mendapatkan manfaat dari API ini. Daripada bergantung pada antarmuka Papo untuk setiap notifikasi, Anda dapat mengintegrasikan pengiriman langsung ke ERP, CRM, atau platform e-commerce Anda. Contoh umum:

Konfirmasi pembelian atau pembaruan status pesanan.
Pengingat konsultasi atau jadwal yang dikirim 24 jam sebelumnya.
Penagihan faktur jatuh tempo dengan tautan pembayaran.
Komunikasi perubahan penerbangan atau reservasi.

API ini sangat berguna ketika aturan yang menentukan kapan mengirim template berada di perangkat lunak lain — misalnya, sistem logistik yang mengirim notifikasi pengiriman begitu paket keluar untuk transportasi.

Pertanyaan yang sering diajukan

Apakah API Papo memiliki biaya tambahan?

API tersedia dalam paket Papo. Anda dapat membuat token dan menggunakan endpoint sesuai paket yang dipilih. Detail batas dan biaya per permintaan ada di halaman paket dan dokumentasi API.

Apakah saya perlu membuat template pesan melalui API?

Tidak. Template harus dibuat dan dikirim untuk persetujuan di Meta Business Manager. Setelah disetujui, mereka secara otomatis disinkronkan di Papo dan muncul di daftar template API.

Bisakah saya mengirim HSM ke nomor yang tidak ada di CRM Papo?

Ya. Penerima tidak perlu terdaftar sebelumnya di CRM platform. Cukup berikan nomor WhatsApp (dengan kode negara dan kode area) dalam permintaan. Namun, Anda harus mendapatkan persetujuan (opt-in) dari pelanggan untuk menerima komunikasi, terutama jika template termasuk kategori Marketing.

Bagaimana saya tahu jika pesan telah terkirim?

Respons langsung dari API mengonfirmasi bahwa permintaan telah diterima dan dikirim ke WhatsApp. Untuk memantau kegagalan, pengiriman, dan pembacaan secara real-time, Anda perlu mengaktifkan webhook peristiwa (outbound) Papo. Lihat panduan webhook di pusat bantuan.

Apakah ada batas kecepatan untuk pengiriman via API?

Ya. Papo menerapkan batas laju untuk melindungi stabilitas layanan dan menghormati kebijakan WhatsApp. Disarankan untuk menjaga kecepatan sedang — menghindari lonjakan mendadak membantu menjaga kesehatan nomor. Nilai pastinya ada di dokumentasi API.

Bisakah saya menggunakan API untuk kampanye pemasaran massal?

Ya, asalkan Anda hanya menggunakan template yang disetujui dari kategori Marketing dan memiliki opt-in eksplisit dari penerima. Mengirim pesan yang tidak diinginkan dapat menghasilkan laporan dan menempatkan nomor Anda pada risiko pemblokiran. Rencanakan pengiriman dengan kontrol irama dan selalu patuhi kebijakan WhatsApp.