Thành phần trò chuyện
Thành phần trò chuyện là các tính năng trong đoạn chat mà bạn có thể bật cho số điện thoại của doanh nghiệp. Các thành phần này giúp người dùng WhatsApp tương tác với doanh nghiệp của bạn dễ dàng hơn. Bạn có thể đặt cấu hình các lệnh dễ sử dụng, cung cấp tin nhắn bắt chuyện soạn sẵn mà người dùng có thể nhấn vào, cũng như chào người dùng lần đầu tiên bằng tin nhắn chào mừng.
Giới hạn
Nếu người dùng WhatsApp nhấn vào một liên kết chung (tức là liên kết wa.me) được đặt cấu hình có văn bản điền sẵn, giao diện người dùng cho tin nhắn bắt chuyện sẽ tự động bị bỏ qua.
Đặt cấu hình qua Trình quản lý WhatsApp (WAM)
Bạn có thể đặt cấu hình tất cả những tính năng này trong Trình quản lý WhatsApp cho các số điện thoại cụ thể mà bạn chọn:
- Chuyển đến bảng điều khiển Ứng dụng của tôi trên trang web Meta for Developers.
- Chọn ứng dụng của bạn rồi chọn Cấu hình trong phần WhatsApp trên bảng điều khiển bên trái.
- Trong phần Số điện thoại, chọn Quản lý số điện thoại.
- Ở phía ngoài cùng bên phải của số điện thoại bạn muốn đặt cấu hình, chọn Biểu tượng bánh răng trong phần Cài đặt.
- Chọn Tin trả lời tự động.
- Truy cập và đặt cấu hình Thành phần trò chuyện.
Đối tác giải pháp cũng có thể đặt cấu hình các tính năng này cho khách hàng nếu họ có quyền truy cập vào Tài khoản WhatsApp Business của khách hàng trong Trình quản lý WhatsApp.
Tin nhắn chào mừng
Tin nhắn chào mừng hiện không hoạt động như dự kiến.
Rất tiếc, chúng tôi chưa có lịch trình dự kiến thời điểm sẽ triển khai tính năng này trong tương lai.
Bạn có thể gửi mọi loại tin nhắn dạng tự do, tin nhắn tương tác và tin nhắn mẫu dưới dạng tin nhắn chào mừng. Hệ thống sẽ áp dụng mức giá nhắn tin được phân loại.
Bạn có thể nhận được thông báo qua webhook mỗi khi có người dùng WhatsApp mở đoạn chat với bạn lần đầu tiên. Đây có thể là phương án hữu ích nếu bạn muốn trả lời những người dùng này bằng tin nhắn chào mừng đặc biệt do chính mình thiết kế.
Tin nhắn chào mừng rất hữu ích cho hoạt động tương tác về dịch vụ, chẳng hạn như hỗ trợ khách hàng hoặc chăm sóc tài khoản. Ví dụ: bạn có thể nhúng một nút WhatsApp vào ứng dụng hoặc trang web của mình. Khi nhấn vào nút đó, người dùng sẽ được chuyển hướng đến WhatsApp. Tại đây, người dùng sẽ nhận được tin nhắn chào mừng cung cấp ngữ cảnh về cách tương tác với bạn.
Nếu bạn bật tính năng này và một người dùng nhắn tin cho bạn, ứng dụng WhatsApp sẽ kiểm tra xem hiện có chuỗi tin nhắn nào giữa người dùng đó và số điện thoại của doanh nghiệp bạn hay không. Nếu không có, ứng dụng này sẽ kích hoạt webhook messages với type được đặt là request_welcome. Sau đó, bạn có thể trả lời người dùng bằng một tin nhắn chào mừng của riêng mình.
Webhook request_welcome sẽ kích hoạt một khung thời gian chăm sóc khách hàng để doanh nghiệp của bạn có thể gửi tin nhắn dạng tự do khi trả lời khách hàng.
Tin nhắn mẫu quay vòng dưới dạng Tin nhắn chào mừng
Phần tải dữ liệu webhook
{
"object": "whatsapp_business_account",
"entry": [
{
"id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
"changes": [
{
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
"phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
},
"contacts": [
{
"profile": {
"name": "<WHATSAPP_USER_NAME>"
},
"wa_id": "<WHATSAPP_USER_ID>"
}
],
"messages": [
{
"from": "<WHATSAPP_USER_PHONE_NUMBER_ID>",
"id": "<WHATSAPP_MESSAGE_ID>",
"timestamp": "<TIMESTAMP>",
"type": "request_welcome" // Indicates first time message from WhatsApp user
}
]
},
"field": "messages"
}
]
}
]
}Tin nhắn bắt chuyện
Tin nhắn bắt chuyện là chuỗi văn bản có thể tùy chỉnh và nhấn vào, xuất hiện trong chuỗi tin nhắn vào lần đầu tiên bạn chat với người dùng. Ví dụ: "Lên kế hoạch cho chuyến đi" hoặc "Tạo kế hoạch tập luyện".
Tin nhắn bắt chuyện rất hữu ích cho hoạt động tương tác về dịch vụ, chẳng hạn như hỗ trợ khách hàng hoặc chăm sóc tài khoản. Ví dụ: bạn có thể nhúng một nút WhatsApp vào ứng dụng hoặc trang web của mình. Khi nhấn vào nút đó, người dùng sẽ được chuyển hướng đến WhatsApp. Tại đây, người dùng có thể chọn trong hàng loạt gợi ý tùy chỉnh được, hướng dẫn họ cách tương tác với dịch vụ của bạn.
Bạn có thể đặt cấu hình tối đa 4 tin nhắn bắt chuyện cho một số điện thoại của doanh nghiệp. Mỗi tin nhắn bắt chuyện có thể dài tối đa 80 ký tự. Không hỗ trợ biểu tượng cảm xúc.
Khi một người dùng nhấn vào tin nhắn bắt chuyện, hệ thống sẽ kích hoạt webhook thông báo đã nhận tiêu chuẩn với chuỗi tin nhắn bắt chuyện được chỉ định cho thuộc tính body trong phần tải dữ liệu. Nếu người dùng cố nhắn tin cho bạn thay vì nhấn vào tin nhắn bắt chuyện, bàn phím sẽ hiện ra dưới dạng lớp phủ. Tuy nhiên, họ có thể bỏ qua lớp phủ này để lại nhìn thấy menu tin nhắn bắt chuyện.
Nếu người dùng WhatsApp nhấn vào một liên kết chung (liên kết wa.me hoặc api.whatsapp.com) được đặt cấu hình có văn bản điền sẵn, giao diện người dùng cho tin nhắn bắt chuyện sẽ tự động bị bỏ qua.
Phần tải dữ liệu webhook
{
"object": "whatsapp_business_account",
"entry": [
{
"id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
"changes": [
{
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
"phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
},
"contacts": [
{
"profile": {
"name": "<WHATSAPP_USER_NAME>"
},
"wa_id": "<WHATSAPP_USER_ID>"
}
],
"messages": [
{
"from": "<WHATSAPP_USER_PHONE_NUMBER_ID>",
"id": "<WHATSAPP_MESSAGE_ID>",
"timestamp": "<TIMESTAMP>",
"text": {
"body": "Plan a trip"
},
"type": "text"
}
]
},
"field": "messages"
}
]
}
]
}Lệnh
Lệnh là chuỗi văn bản mà người dùng WhatsApp có thể nhìn thấy khi nhập dấu gạch chéo lên trong chuỗi tin nhắn với doanh nghiệp của bạn.
Lệnh được hình thành từ chính lệnh đó và một gợi ý, giúp người dùng biết được chuyện gì có thể xảy ra khi họ sử dụng lệnh. Ví dụ: bạn có thể xác định lệnh như sau:
/imagine - Create images using a text prompt
Khi một người dùng WhatsApp nhập /imagine cars racing on Mars, hệ thống sẽ kích hoạt webhook thông báo đã nhận với thuộc tính body được chỉ định đúng chuỗi văn bản đó. Sau đó, bạn có thể tạo và trả về hình ảnh những chiếc ô tô đang đua trên hành tinh sao Hỏa.
Bạn có thể xác định tối đa 30 lệnh. Mỗi lệnh dài tối đa 32 ký tự và mỗi gợi ý dài tối đa 256 ký tự. Không hỗ trợ biểu tượng cảm xúc.
Phần tải dữ liệu webhook
{
"object": "whatsapp_business_account",
"entry": [
{
"id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
"changes": [
{
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
"phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
},
"contacts": [
{
"profile": {
"name": "<WHATSAPP_USER_NAME>"
},
"wa_id": "<WHATSAPP_USER_ID>"
}
],
"messages": [
{
"from": "<WHATSAPP_USER_PHONE_NUMBER_ID>",
"id": "<WHATSAPP_MESSAGE_ID>",
"timestamp": "<TIMESTAMP>",
"text": {
"body": "/imagine cars racing on Mars"
},
"type": "text"
}
]
},
"field": "messages"
}
]
}
]
}Đặt cấu hình qua API
Ngoài ra, bạn có thể sử dụng API để đặt cấu hình thành phần trò chuyện và xem bất kỳ giá trị nào đã đặt cấu hình.
API Thành phần trò chuyện có 2 điểm cuối:
POST </PHONE_NUMBER_ID>/conversational_automation được dùng để đặt cấu hình thành phần trò chuyện cho một số điện thoại cụ thể.
GET /<PHONE_NUMBER_ID>/conversational_automation trả về giá trị hiện tại của các trường enable_welcome_message, commands và prompts cho một số điện thoại cụ thể.
Đặt cấu hình Thành phần trò chuyện qua API
Bạn có thể đặt cấu hình Thành phần trò chuyện cho một số điện thoại cụ thể bằng cách gọi điểm cuối POST.
Cú pháp yêu cầu
// Enable or disable the Welcome Message for the given phone number ID POST /<PHONE_NUMBER_ID>/conversational_automation?enable_welcome_message=<ENABLE_DISABLE> // Configure Commands with names and descriptions POST /<PHONE_NUMBER_ID>/conversational_automation?commands=<COMMAND_LIST> // Configure Prompts POST /<PHONE_NUMBER_ID>/conversational_automation?prompts=<PROMPT>
Thuộc tính nội dung
| Phần giữ chỗ | Mô tả | Giá trị mẫu |
|---|---|---|
Số nguyên | Bắt buộc. ID số điện thoại trên tài khoản WhatsApp Business. |
|
Boolean | Không bắt buộc. Giá trị boolean để bật hoặc tắt tin nhắn chào mừng cho số điện thoại này. |
|
JSON | Không bắt buộc. Danh sách lệnh cần đặt cấu hình. | "commands": {
"command_name": "generate"
"command_description": "Create a new image",
“command_name”: “rethink”
“command_description”: “Generate new images from existing images”,
} |
Danh sách string | Không bắt buộc. (Các) gợi ý cần đặt cấu hình. |
|
Yêu cầu mẫu
curl -X POST \
'https://graph.facebook.com/v19.0/PHONE_NUMBER_ID/conversational_automation' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"enable_welcome_message": true/false,
"commands": [
{
"command_name": "tickets",
"command_description": "Book flight tickets",
},
{
"command_name": "hotel",
"command_description": "Book hotel",
}
],
"prompts": ["Book a flight","plan a vacation"]
}'Phản hồi mẫu
{
"success": true
}Xem cấu hình hiện tại qua API
Bạn có thể xem cấu hình hiện tại của Thành phần trò chuyện cho một số điện thoại cụ thể bằng cách gọi điểm cuối GET.
Cú pháp yêu cầu
GET /<PHONE_NUMBER_ID>?fields=conversational_automation
Phản hồi mẫu
{
"conversational_automation": {
"enable_welcome_message": true
"prompts": [
"Find the best hotels in the area",
"Find deals on rental cars"
],
"commands": [
{
"command_name": "tickets",
"command_description": "Book flight tickets",
},
{
"command_name": "hotel",
"command_description": "Book hotel",
}
],
}
"id": "123456"
}Thử nghiệm
Để thử nghiệm các thành phần trò chuyện sau khi bạn đặt cấu hình, hãy mở ứng dụng WhatsApp và bắt đầu một đoạn chat với số điện thoại của doanh nghiệp bạn.
Đối với tin nhắn chào mừng và tin nhắn bắt chuyện, nếu đã có đoạn chat với số điện thoại này của doanh nghiệp thì trước tiên, bạn phải xóa đoạn chat đó:
- Mở đoạn chat trong ứng dụng WhatsApp.
- Nhấn vào hồ sơ thuộc số điện thoại của doanh nghiệp
- Nhấn vào Xóa nội dung chat > Xóa tất cả tin nhắn.
- Xóa đoạn chat.
- Bắt đầu đoạn chat mới với doanh nghiệp này.
Sau đó, bạn có thể gửi tin nhắn đến số điện thoại nêu trên của doanh nghiệp. Lúc này, webhook request_welcome sẽ được kích hoạt.