Nền tảng Messenger

Màn hình chào mừng

Tài liệu này hướng dẫn bạn cách tạo màn hình chào mừng cho trải nghiệm Messenger. Màn hình chào mừng hiển thị tên Trang Facebook của doanh nghiệp bạn, ảnh đại diện và ảnh bìa trên Trang Facebook đó, thời gian mà doanh nghiệp bạn thường trả lời tin nhắn, một tin nhắn chào mừng không bắt buộc và nút Bắt đầu. Khi một người nhấp vào nút Bắt đầu, tin nhắn Bắt đầu sẽ được đăng trong cuộc trò chuyện, sau đó ứng dụng của bạn có thể gửi tin nhắn cho người này.

Cách hoạt động

Khi một người nhấp vào nút Bắt đầu trong trải nghiệm Messenger của bạn, hệ thống sẽ gửi cho bạn một thông báo webhook. Bạn có thể sử dụng thông báo này để gửi tin nhắn chào mừng ban đầu, chẳng hạn như tin nhắn văn bản hoặc tập hợp các câu trả lời nhanh.

Trước khi bạn bắt đầu

Hướng dẫn này giả định rằng bạn đã đọc phần Tổng quan về Nền tảng Messenger, đã triển khai các thành phần cần thiết - chẳng hạn như Trang Facebook của doanh nghiệp bạn (hoặc Trang thử nghiệm), đã đăng ký với vai trò nhà phát triển của Meta và đã tạo ID ứng dụng kinh doanh trên Meta với sản phẩm Messenger.

Bạn sẽ cần:

  • Mã truy cập Trang do một người có thể thực hiện tác vụ MESSAGING trên Trang đó yêu cầu
  • Quyền pages_messaging
  • Đăng ký nhận sự kiện webhook messaging_postbacks

Các giới hạn

Đối với ứng dụng có Quyền truy cập tiêu chuẩn, màn hình chào mừng sẽ chỉ hiển thị với những người có vai trò trên ứng dụng.

Lệnh

Nếu Trang của bạn sử dụng Lệnh, màn hình chào mừng sẽ hiển thị danh sách các lệnh mà trải nghiệm nhắn tin hỗ trợ, giúp mọi người dễ dàng hiểu rõ những hành động mà trải nghiệm Messenger có thể được yêu cầu thực hiện.

Triển khai nút Bắt đầu

Để đặt phần tải dữ liệu yêu cầu đăng lại, hãy gửi một yêu cầu POST cho API Trang cá nhân Messenger:

curl -X POST -H "Content-Type: application/json" -d '{
  "get_started": {"payload": "

Để biết đầy đủ thông tin chi tiết, hãy xem tài liệu tham khảo về thuộc tính get_started.

Cách làm tốt nhất

  • Nên trình bày các bước tiếp theo để khuyến khích phản hồi trong tin nhắn chào mừng của bạn. Bạn có thể sử dụng các nút để thêm cấu trúc vào tin nhắn của mình và kêu gọi hành động cụ thể mà mọi người có thể thực hiện.
  • Nên chia sẻ các lệnh cơ bản trong tin nhắn chào mừng của bạn. Hãy nêu rõ những từ khóa hoặc cụm từ mọi người có thể dùng để yêu cầu trợ giúp, nhận thông tin cập nhật, v.v., từ đó tìm được thứ họ muốn nhanh hơn.
  • Nên thay đổi trải nghiệm tích hợp khi trải nghiệm bot của bạn thay đổi. Hãy truy cập lại văn bản chào mừng và tin nhắn chào mừng khi bạn cập nhật tính năng của mình để đảm bảo tính năng đó vẫn phù hợp.
  • Đừng quên rằng mọi nội dung trên màn hình đều tác động lẫn nhau. Ngữ cảnh bạn cung cấp trong Lời chào trên Messenger cần hỗ trợ cho nút "Bắt đầu".
  • Không trình bày quá chung chung. Hãy thử xưng hô với mọi người bằng tên để làm cho tin nhắn mang tính cá nhân và xem đây là cơ hội để hướng dẫn họ biết cách sử dụng và kiểm soát trải nghiệm.

Đặt văn bản chào mừng

Văn bản chào mừng trên màn hình chào mừng là cơ hội đầu tiên để bạn cho một người biết về lý do họ nên bắt đầu cuộc trò chuyện với bot Messenger của bạn. Một số nội dung bạn có thể đưa vào văn bản chào mừng bao gồm phần mô tả ngắn về chức năng của bot, chẳng hạn như các tính năng chính hoặc tagline. Đây cũng là nơi thích hợp để bắt đầu thiết lập văn phong và ngữ điệu cho bot của bạn.

Bạn có thể cung cấp văn bản chào mừng mặc định và được bản địa hóa.

Để đặt văn bản chào mừng, hãy gửi một yêu cầu POST đến API Trang cá nhân Messenger:

curl -X POST -H "Content-Type: application/json" -d '{
  "greeting": [
    {
      "locale":"default",
      "text":"Hello!" 
    }, {
      "locale":"en_US",
      "text":"Timeless apparel for the masses."
    }
  ]
}' "https://graph.facebook.com/v2.6/me/messenger_profile?access_token=

Để biết đầy đủ thông tin chi tiết, hãy xem tài liệu tham khảo về greeting property.

Cá nhân hóa

Bạn có thể cá nhân hóa văn bản chào mừng bằng tên của người dùng. Bạn có thể sử dụng các chuỗi mẫu sau đây:

  • {{user_first_name}}
  • {{user_last_name}}
  • {{user_full_name}}

Ví dụ

"greeting":[
  {
    "locale":"default",
    "text":"Hello {{user_first_name}}!"
  }
]

Cách làm tốt nhất

  • Nên xem lời chào là phần giới thiệu và tóm tắt về trải nghiệm của bạn. Lời chào có tối đa 160 ký tự nên hãy trình bày thật súc tích.
  • Nên giới thiệu chức năng chính của bạn. Ngữ cảnh giúp mọi người hiểu cách tương tác với bạn và đặt ra kỳ vọng về các tính năng của bạn.
  • Không nên xem lời chào là sổ tay hướng dẫn. Vì lời chào của bạn sẽ biến mất nên hãy sử dụng tin nhắn thực tế để giới thiệu chức năng và lệnh cụ thể.
  • Không nên sử dụng quá nhiều định dạng văn bản (ví dụ: giãn cách, dấu câu, dấu quay lại) trong lời chào để bạn có thể khai thác tối đa giới hạn ký tự.

Xem thêm

  • https://developers.facebook.com/docs/graph-api/reference/v14.0/page/messenger_profile