Nhảy đến nội dung

Nút whatsapp

Nút whatsapp cung cấp tích hợp với WhatsApp Business Cloud API (Meta). Với nó, luồng có thể gửi tin nhắn văn bản thông thường và tin nhắn mẫu đã được phê duyệt với việc thay thế biến cho người dùng.

Cài đặt nút whatsapp​

Edit

1. wa_phone_number_id​

Định danh số điện thoại người gửi trong Meta. Bạn có thể tìm thấy nó trong phần WhatsApp → Bắt đầu với Meta Business Manager.

Hỗ trợ Mustache.

Ví dụ:

{{flow.phoneNumberId}}

2. wa_access_token​

Mã thông báo truy cập cố định từ Meta Business Manager.

Hỗ trợ Mustache — mã thông báo có thể được lưu trữ trong biến luồng và thay thế qua {{biến}}.

Ví dụ:

{{flow.whatsappToken}}

3. wa_api_version​

Phiên bản Graph API sẽ được sử dụng cho các yêu cầu. Trường tĩnh.

Ví dụ:

v19.0

4. wa_action​

Loại tin nhắn được gửi. Các tùy chọn có sẵn:

  • text — tin nhắn văn bản thông thường. Kích hoạt trường text.
  • template — tin nhắn mẫu đã được phê duyệt trước trong Meta. Kích hoạt các trường templateName, locale và components.

5. wa_to​

Số điện thoại của người nhận theo định dạng quốc tế: có mã quốc gia, không có dấu + và không có khoảng trắng.

Hỗ trợ Mustache.

Ví dụ:

{{payload.user.phone}}

hoặc tĩnh: 79001234567

6. wa_text​

Nội dung tin nhắn. Chỉ được sử dụng khi action: text.

Hỗ trợ Mustache.

Ví dụ:

Đơn hàng của bạn №{{payload.orderId}} đã được xác nhận. Vui lòng chờ giao hàng.

7. wa_template_name​

Tên mẫu đã được phê duyệt trong Meta Business Manager. Chỉ được sử dụng khi action: template.

Hỗ trợ Mustache.

Ví dụ:

order_confirmation

8. wa_locale​

Ngôn ngữ của mẫu theo định dạng language_REGION. Phải chính xác khớp với ngôn ngữ của mẫu trong cài đặt Meta.

Ví dụ:

  • en_US — tiếng Anh (Mỹ)
  • fr_FR — tiếng Pháp

9. wa_components​

Tham số của mẫu — giá trị của các biến sẽ được thay thế vào mẫu khi gửi. Chỉ được sử dụng khi action: template.

Mỗi phần tử chứa ba trường:

  • type — phần của mẫu: header (tiêu đề) hoặc body (nội dung chính).
  • name — tên biến, như đã được định nghĩa trong mẫu trong tài khoản WhatsApp Business.
  • text — giá trị sẽ được thay thế cho biến. Hỗ trợ Mustache.

Ví dụ:

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

Ví dụ sử dụng​

Ví dụ 1: Thông báo văn bản về đơn hàng​

Luồng:

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

Cài đặt nút:

  • accessToken: {{flow.whatsappToken}}
  • phoneNumberId: {{flow.phoneNumberId}}
  • apiVersion: v19.0
  • action: text
  • to: {{payload.order.phone}}
  • text: Đơn hàng của bạn №{{payload.order.id}} đã được nhận. Tổng số: {{payload.order.totalPrice}} rub.

Kết quả:
Khi đơn hàng được tạo, người dùng sẽ nhận được tin nhắn WhatsApp với chi tiết đơn hàng.

Ví dụ 2: Tin nhắn mẫu với các biến​

Luồng:

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

Cài đặt nút:

  • 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}}

Kết quả:
Người dùng sẽ nhận được tin nhắn mẫu đã được phê duyệt với các giá trị của số đơn hàng và trạng thái được thay thế.

thông tin

Các tin nhắn mẫu cần được tạo trước và nhận phê duyệt trong Meta Business Manager. Các giá trị của trường templateName và locale phải chính xác khớp với các tham số của mẫu đã được phê duyệt.