Cara agen AI mengirim templat, foto, atau video ke pelanggan
Agar agen AI Anda dapat mengirim foto, video, atau file ke pelanggan, sertakan kolom template_ids berisi id templat AnyLinga dalam respons ke callback_url. Anda dapat menyertakan hingga 5 id; kolom reply_text bersifat opsional.
Cara lampiran dikirim
Templat adalah teks dan lampiran yang sudah Anda simpan di AnyLinga. Agen Anda memilih templat yang diperlukan, lalu AnyLinga mengirimkannya ke pelanggan.
Dapatkan daftar templat
1. Minta templat yang tersedia
- Jalankan
GET /api/connect/templatesdengan headerAuthorization: Bearer <Token callback>yang sama. - Respons akan memuat kolom
id,name,category,provider,body, dan lampiranattachmentsuntuk setiap templat. Templat WhatsApp Business API juga memiliki blokmeta. - Pilih templat yang diperlukan dan ambil
iduntuk mengirimkannya.
Sertakan templat dalam respons agen
2. Tambahkan template_ids ke respons
- Dalam respons ke
callback_url, sertakan arraytemplate_idsberisi hingga 5 id templat. - Tambahkan
reply_textjika Anda perlu mengirim teks terpisah sebelum templat. Jika tidak diperlukan, kolom ini tidak perlu disertakan.
{
"correlation_id": "b1e7d0c4-2f3a-4e8b-9c6d-7a5f1e2d3c4b",
"reply_text": "Berikut katalog kami dan video tentang pengiriman.",
"template_ids": ["7d1f0c2a-4b3e-4a9d-8c61-2e5f9b0a7d34"]
}
Dalam responsnya, AnyLinga akan mengembalikan daftar templates dengan hasil untuk setiap templat: ok, parts_sent, atau code kesalahan. Jika tidak ada teks dan tidak ada satu pun templat yang terkirim, responsnya adalah 502.
Templat juga dapat disertakan dengan cara yang sama di /api/connect/send saat agen menghubungi pelanggan terlebih dahulu.
Urutan pengiriman dan batasan
reply_text dikirim terlebih dahulu beserta terjemahannya, lalu templat dikirim satu per satu. Teks templat dan lampiran dikirim sebagai pesan terpisah. Video dikirim sebagai video.
Teks templat tidak diterjemahkan: pelanggan akan menerimanya persis seperti yang tertulis dalam templat.
Hanya templat yang sudah dipublikasikan yang dapat digunakan. Templat WhatsApp Business API harus disetujui oleh Meta. Jika tidak, AnyLinga akan mengembalikan 404 beserta template_id templat tersebut.
Templat diperiksa sebelum respons diterima. Jika ada kesalahan pada id, perbaiki lalu kirim ulang respons dengan correlation_id yang sama.
Pertanyaan terkait
Templat balasan cepat · Templat WhatsApp · Cara agen menghubungi pelanggan terlebih dahulu
Masih ada pertanyaan?
Kami membalas pada jam kerja.