Pembina MaviBot juga menyokong API WhatsApp Business rasmi.

Cara menyambung WhatsApp Business

Untuk menyambung API WhatsApp Business (WABA) ke projek anda, pergi ke bahagian Messengers dan pilih WhatsApp Business API.

Menyambung API WhatsApp Business

Dalam tetingkap yang terbuka, log masuk dengan akaun Facebook anda. Kemudian klik butang "Connect via Facebook".

Jika perlu, masukkan kata laluan Facebook anda untuk meneruskan.

Persediaan kini selesai. Anda tidak perlu memastikan telefon anda dalam talian sepanjang masa; bot akan beroperasi dengan stabil dan autonomi.

Templat mesej untuk API WhatsApp Business

Apabila menggunakan API WhatsApp Business, pengguna tidak boleh menulis kepada pelanggan pada bila-bila masa dan menghantar mesej tanpa had semasa mencipta bot, seperti WhatsApp kelabu, di luar tetingkap perkhidmatan pelanggan 24 jam.

Di luar tetingkap 24 jam, hanya templat mesej WhatsApp (atau mesej templat WhatsApp) boleh digunakan, di mana komunikasi berlaku secara percuma dalam kategori yang dipilih.

Fungsi ini digunakan dalam WhatsApp untuk mengelakkan spam melalui pengehadan bilangan mesej yang dibenarkan dalam selang masa tertentu, serta dengan menetapkan kategori kepada templat.

Terdapat kategori mesej berikut yang dipasang untuk API WhatsApp Business oleh Meta:

  1. Templat berguna (mengandungi maklumat khusus tentang transaksi, invois, pembayaran, dll.);

  2. Templat untuk pemasaran (maklumat tentang syarikat, organisasi, strategi, pengiklanan dan promosi);

  3. Templat untuk pengesahan dan autentikasi.

Templat yang dicipta untuk WABA sedang melalui proses moderasi.

Sebab utama penolakan templat

Sejumlah besar templat gagal dalam moderasi WhatsApp atas beberapa sebab:

  1. Pengiklanan berlebihan: WhatsApp Business menolak templat yang dibebankan dengan iklan dan kandungan promosi. Jika moderator atau AI platform menentukan bahawa pengiklanan mengatasi mesej teras, templat akan disekat.
  2. Pelanggaran Dasar Produk: templat yang mempromosikan item terlarang seperti narkotik, bahan psikotropik, alkohol, tembakau, perkhidmatan intim, atau sebarang kandungan yang dianggap merendahkan martabat manusia akan ditolak.
  3. Kekaburan, peninggalan, atau kepalsuan: jika moderator WhatsApp mengesan sebarang subteks tersembunyi, maklumat mengelirukan, atau kekurangan butiran jelas tentang syarikat atau perkhidmatan anda, templat tidak akan diluluskan.
  4. Pengumpulan maklumat sulit: templat yang direka untuk mengumpul data sensitif pengguna (cth., nombor pasport, butiran kad bank, nombor ID peribadi, alamat rumah) akan gagal dalam moderasi.
  5. Kandungan menyinggung: sebarang mesej yang mengandungi maklumat yang boleh menyinggung pengguna berdasarkan bangsa, kewarganegaraan, jantina, identiti, atau kriteria lain akan ditolak.
  6. Penolakan budi bicara: moderator WhatsApp berhak menolak templat tanpa memberikan sebab khusus.

Cara memasang templat mesej

Oleh kerana templat dicipta daripada blok, anda mesti mencipta blok dalam aliran anda terlebih dahulu sebelum menggunakannya untuk templat API WhatsApp Business.

  • Kos & mesej pertama: Menghantar mesej templat adalah percuma dalam tetingkap perbualan 24 jam. Mesej pertama kepada pelanggan hanya boleh menjadi templat yang telah diluluskan oleh Meta (Facebook).
  • Selepas 24 jam: Sebaik sahaja 24 jam berlalu sejak sembang dibuka, anda hanya boleh menghantar templat lain yang diluluskan untuk menarik semula pengguna.
  • Nota moderasi: Templat mungkin gagal dalam moderasi jika ia mengandungi pemboleh ubah (dalam skrip Cyrillic atau Latin).

Mencipta templat dalam MaviBot

  1. Pergi ke bahagian Channels, pilih WhatsApp Business API, dan kemudian pilih Message templates.

  1. Klik butang "Create template". Ini membuka halaman penciptaan templat.
  2. Templat dipautkan kepada blok dalam aliran anda. Secara lalai, kandungan templat diambil daripada blok, tetapi anda boleh menentukan teks dan butang tersuai.

  1. Templat mesej akan dihantar untuk moderasi semasa penciptaan. Anda hanya boleh menggunakan templat yang diluluskan. Moderasi biasanya mengambil masa kira-kira 8 jam, dengan maksimum 48 jam.

Jenis templat

Terdapat 3 jenis templat yang boleh dipilih.

Anda boleh melampirkan imej pada templat MARKETING dalam format berikut: SVG, PNG, JPG, dan GIF.

Cara menghantar pemboleh ubah dalam templat

Pemboleh ubah dalam templat dikendalikan dengan cara yang sama seperti di seluruh MaviBot, bukan mengikut format asli WhatsApp.

Sistem kami disesuaikan untuk pemboleh ubah MaviBot dan tidak menyokong pemboleh ubah dalam format {{1}}

Menggunakan pemboleh ubah dalam mesej templat WhatsApp

Jika anda perlu menggunakan pemboleh ubah dalam templat mesej, ikut peraturan ini: sentiasa tulis nama pemboleh ubah menggunakan huruf Latin sahaja, contohnya, #{example}. Selepas menghantar, sahkan bahawa pemboleh ubah diproses dengan betul dengan menyemak mesej melalui pautan yang disediakan.

Jika templat mengandungi pemboleh ubah, tetapi bot tidak memberikan nilai kepadanya atau nilai itu hilang, mesej tidak akan dihantar!

Cara butang berfungsi dalam templat

Templat mesej menyokong butang. Dalam MaviBot, butang ditetapkan serupa dengan sintaks

API Facebook. Anda boleh membiasakan diri dengannya melalui pautan:

Butang ditetapkan dalam format tatasusunan JSON.

Parameter penciptaan butang:

Parameter Diperlukan Penerangan
type Ya Nilai: PHONE_NUMBER, URL, dan QUICK_REPLY
text Ya Teks butang
url Tidak

URL yang akan dibuka

apabila butang diklik. Anda boleh menggunakan pemboleh ubah untuk

mencipta pautan dinamik.
phone_number Tidak

Nombor telefon yang akan

dihubungi apabila butang ditekan
example Tidak

Menyediakan contoh data yang mungkin untuk templat anda. Ini membantu dalam proses semakan dan kelulusan supaya anda dapat

memahami mesej yang anda rancang untuk hantar. Pastikan

bahawa ini adalah contoh dan tidak mengandungi sebarang maklumat sulit atau peribadi.

Contohnya: Mesej dengan dua butang: [{"type":"QUICK_REPLY", "text": "Ya, sesuai"}, {"type":"QUICK_REPLY", "text": "Tidak sesuai"}]

Ciri butang dalam templat

Terdapat dua jenis butang yang tersedia dalam mesej templat:

  1. Call-To-Action (CTA): Butang untuk pautan atau nombor telefon (dipaparkan dengan ikon pautan atau telefon di sebelah teksnya).
  2. Quick Reply: Butang teks standard dengan had 20 aksara.

Had:

  • Satu templat boleh mengandungi sehingga 3 butang Quick Reply dan sehingga 2 butang Call-to-Action. Walau bagaimanapun, anda tidak boleh menggunakan dua pautan atau dua nombor telefon secara serentak.
  • Butang tidak boleh mengandungi pemboleh ubah, pemisah baris, emoji, atau simbol pemformatan.

Tingkah laku:

  • Mengklik butang Quick Reply menghantar teksnya sebagai mesej balasan daripada pengguna.
  • Butang Call-to-Action boleh membuka pautan ke fail.
  • Mengklik butang Call-to-Action untuk panggilan telefon membuka pendail standard. Pada WhatsApp Web, pemberitahuan akan muncul yang menyatakan bahawa panggilan tidak boleh dibuat dari versi desktop.

Bagaimana moderasi templat berfungsi

Setiap templat dihantar untuk moderasi sejurus selepas penciptaan. Proses ini biasanya mengambil masa kira-kira 8 jam, dengan masa semakan maksimum 48 jam.

Anda boleh menjejaki status moderasi dalam senarai templat anda.

Jika templat ditolak, sebab penolakan akan diberikan.

Templat dengan kebarangkalian kelulusan tinggi biasanya:

  • Menggunakan bahasa yang jelas dan profesional.
  • Melayani kes penggunaan khusus yang sah (cth., peringatan janji temu, kemas kini pesanan).

Penting: Teks dalam italik boleh menjadi pemboleh ubah dan disesuaikan.

Hello, kami tidak dapat menghubungi anda. Adakah sesuai untuk anda meneruskan komunikasi di sini?

Hello, anda meninggalkan mesej di laman web dan meminta saya menghubungi anda. (tertakluk kepada perubahan)

Hello, saya John Smith dari MaviBot. Sebelum ini anda memohon untuk penciptaan chatbot. Kami gembira memaklumkan bahawa kami mempunyai beberapa berita untuk anda.

Templat yang tidak akan lulus moderasi:

sebarang teks pengiklanan

Cara menyemak sama ada anda berada dalam tetingkap 24 jam

Anda boleh menentukan berapa hari telah berlalu sejak mesej terakhir pelanggan dengan menggunakan fungsi days_from_last_message() dalam keadaan pencetus anda.

Contoh semakan untuk tetingkap 24 jam:

days_from_last_message() == 0

Sekatan untuk akaun yang tidak disahkan

Akaun Perniagaan Facebook yang tidak disahkan menghadapi had berikut:

  • 50 mesej templat sehari (termasuk dalam yuran bulanan).
  • Tiada sekatan pada mesej masuk.

Untuk mengangkat sekatan ini, syarikat anda mesti melengkapkan proses Pengesahan Perniagaan, yang biasanya mengambil masa 2–3 minggu.

Sistem pembayaran

Semak dengan penjual semula anda untuk harga mesej masuk dan keluar untuk akaun yang tidak disahkan.

Pembayaran dibuat terus kepada 360dialog.

Ralat penghantaran mesej

Sebab yang mungkin untuk kegagalan penghantaran:

  1. Nombor telefon penerima tidak didaftarkan di WhatsApp.
  2. Percubaan untuk menghantar templat dari kategori "Authentication" kepada pengguna WhatsApp dengan kod negara +91 (India). Pada masa ini, templat kategori Authentication tidak boleh dihantar kepada pengguna di India.
  3. Penerima tidak menerima Terma Perkhidmatan dan Dasar Privasi yang dikemas kini.
  4. Mesej tidak dihantar untuk mengekalkan pengalaman pengguna berkualiti tinggi (ini adalah sekatan dasar umum).

Penukaran Iklan Click-to-WhatsApp

Tambahan kepada dokumentasi untuk fungsi fb_pixel_event().

Meta* menandakan setiap klik daripada iklan Click-to-WhatsApp dengan pengecam klik ctwa_clid. Ia diterima bersama dengan mesej WhatsApp pertama pelanggan dan digunakan untuk mengaitkan penukaran daripada perbualan kepada iklan tertentu — serupa dengan cara peristiwa piksel dikaitkan dengan klik laman web.

Tandatangan

fb_pixel_event(
    event_name,
    pixel_id,
    access_token,
    event_source_url,
    action_source,
    fbc,
    test_event_code,
    data,
    ctwa_clid,
    messaging_channel
)

Parameter Baharu

Parameter Penerangan
ctwa_clid Pengecam klik untuk iklan Klik-ke-WhatsApp. Jika parameter ini tidak disediakan, pemboleh ubah klien ctwa_clid, yang disimpan secara automatik oleh bot, digunakan. Pilihan.
messaging_channel Saluran pemesejan di mana penukaran berlaku. Lalai kepada whatsapp. Pilihan.

Nilai action_source Baharu

Baris berikut ditambah ke jadual nilai action_source:

Nilai Penerangan
business_messaging Penukaran berlaku dalam perbualan selepas pelanggan mengklik iklan Klik-ke-WhatsApp.

Satu peristiwa dihantar sebagai penukaran pemesejan jika sekurang-kurangnya satu daripada syarat berikut dipenuhi:

  • action_source="business_messaging" disediakan;
  • ctwa_clid disediakan;
  • messaging_channel disediakan.

Dalam kes ini, Meta* menerima gabungan action_source + messaging_channel + ctwa_clid. Tanpa gabungan ini, klik iklan tidak akan dikaitkan dengan penukaran.

Nilai website tidak boleh digunakan untuk penukaran pemesejan: peristiwa akan sampai ke piksel, tetapi ia tidak akan dikaitkan dengan iklan.

Pemboleh Ubah Klien

Apabila pelanggan menghantar mesej WhatsApp selepas mengklik iklan, bot menyimpan data klik ke pemboleh ubah klien pelanggan. Anda tidak perlu mengisi pemboleh ubah ini secara manual.

Pemboleh Ubah Penerangan
ctwa_clid Pengecam klik. Ditambah secara automatik ke peristiwa.
ctwa_clid_time Masa apabila pengecam diterima, dalam format masa Unix. Ia boleh digunakan untuk menentukan berapa banyak masa telah berlalu sejak klik.
wa_ads_data Data iklan dalam format JSON: URL iklan, ID iklan (source_id), tajuk, penerangan, jenis kreatif, dan URL kreatif.

Pengecam klik diambil secara automatik dari pemboleh ubah klien, jadi anda tidak perlu menghantarnya ke fungsi secara eksplisit.

Nombor telefon pelanggan ditambah secara automatik ke peristiwa jika ia tidak disediakan dalam data.

Parameter event_source_url tidak digunakan untuk penukaran pemesejan.

Had

Pengecam klik diterima hanya dengan mesej pertama pelanggan selepas mereka mengklik butang dalam iklan. Ia tidak disertakan dalam mesej berikutnya. Oleh itu, peristiwa boleh dihantar pada bila-bila masa semasa perbualan, tetapi hanya jika mesej pertama berasal dari iklan.

Meta* menyediakan ctwa_clid untuk klik dari aplikasi Facebook* dan Instagram* pada Android dan iOS.

Pengecam tidak disediakan apabila pelanggan mengklik dari penyemak imbas atau mengklik siaran biasa dan bukannya butang iklan. Penukaran daripada interaksi sedemikian tidak boleh dikaitkan dengan iklan.

Jika pelanggan mengklik iklan lain kemudian, pemboleh ubah akan ditimpa. Penukaran dikaitkan dengan iklan terbaru yang pelanggan datang daripadanya.

Jika pengecam klik hilang kedua-duanya dari parameter fungsi dan pemboleh ubah klien, fungsi mengembalikan ralat No ctwa_clid variable in client variables dan peristiwa tidak dihantar.