Lewati ke konten utama

Node whatsapp

Node whatsapp menyediakan integrasi dengan WhatsApp Business Cloud API (Meta). Ini memungkinkan alur untuk mengirim pesan teks reguler dan pesan template yang disetujui dengan penggantian variabel kepada pengguna.

Pengaturan untuk node whatsapp​

Edit

1. wa_phone_number_id​

Pengidentifikasi untuk nomor pengirim di Meta. Anda dapat menemukannya di bagian WhatsApp → Memulai di Meta Business Manager.

Mendukung Mustache.

Contoh:

{{flow.phoneNumberId}}

2. wa_access_token​

Token akses permanen dari Meta Business Manager.

Mendukung Mustache — token dapat disimpan dalam variabel alur dan diganti menggunakan {{variable}}.

Contoh:

{{flow.whatsappToken}}

3. wa_api_version​

Versi Graph API yang akan digunakan untuk permintaan. Ini adalah bidang statis.

Contoh:

v19.0

4. wa_action​

Jenis pesan yang sedang dikirim. Opsi yang tersedia:

  • text — pesan teks reguler. Mengaktifkan bidang text.
  • template — pesan template yang telah disetujui sebelumnya di Meta. Mengaktifkan bidang templateName, locale, dan components.

5. wa_to​

Nomor telepon penerima dalam format internasional: dengan kode negara, tanpa tanda +, dan tanpa spasi.

Mendukung Mustache.

Contoh:

{{payload.user.phone}}

atau secara statis: 79001234567

6. wa_text​

Teks pesan. Digunakan hanya ketika action: text.

Mendukung Mustache.

Contoh:

Pesanan Anda №{{payload.orderId}} telah berhasil dibuat. Harap tunggu pengiriman.

7. wa_template_name​

Nama template yang disetujui di Meta Business Manager. Digunakan hanya ketika action: template.

Mendukung Mustache.

Contoh:

konfirmasi_pesanan

8. wa_locale​

Bahasa template dalam format language_REGION. Harus persis cocok dengan bahasa template di pengaturan Meta.

Contoh:

  • en_US — Inggris (AS)
  • fr_FR — Prancis

9. wa_components​

Parameter template — nilai variabel yang akan diganti ke dalam template saat mengirim. Digunakan hanya ketika action: template.

Setiap elemen berisi tiga bidang:

  • type — bagian dari template: header (header) atau body (isi utama).
  • name — nama variabel seperti yang ditentukan dalam akun pribadi WhatsApp Business.
  • text — nilai yang akan diganti untuk variabel. Mendukung Mustache.

Contoh:

type: body  |  name: order_id   |  text: {{payload.orderId}}
type: body  |  name: amount     |  text: {{payload.totalPrice}}

Contoh Penggunaan​

Contoh 1: Notifikasi Teks untuk Pesanan​

Alur:

[events: order_created] ---> [whatsapp]

Pengaturan Node:

  • accessToken: {{flow.whatsappToken}}
  • phoneNumberId: {{flow.phoneNumberId}}
  • apiVersion: v19.0
  • action: text
  • to: {{payload.order.phone}}
  • text: Pesanan Anda №{{payload.order.id}} telah diterima. Total: {{payload.order.totalPrice}} rub.

Hasil:
Ketika pesanan dibuat, pengguna akan menerima pesan WhatsApp dengan rincian pesanan.

Contoh 2: Pesan Template dengan Variabel​

Alur:

[cms-events: order_status_changed] ---> [whatsapp]

Pengaturan Node:

  • action: template
  • to: {{payload.order.phone}}
  • templateName: order_status_update
  • locale: en_US
  • components: 
    type: body  |  name: order_id    |  text: {{payload.order.id}}
    type: body  |  name: status      |  text: {{payload.order.status}}

Hasil:
Pengguna akan menerima pesan template yang disetujui dengan nilai yang diganti untuk nomor pesanan dan status.

info

Pesan template harus dibuat sebelumnya dan disetujui di Meta Business Manager. Nilai dari bidang templateName dan locale harus persis cocok dengan parameter template yang disetujui.