Tin nhắn làm quen

Tin nhắn làm quen cung cấp phương thức để người dùng bắt đầu cuộc trò chuyện với doanh nghiệp thông qua một danh sách các câu hỏi thường gặp. Bạn có thể đặt tối đa 4 câu hỏi qua API Tin nhắn làm quen.

Kể từ ngày 19/10/2021, Tin nhắn làm quen hỗ trợ tính năng bản địa hóa để các doanh nghiệp có thể đặt câu hỏi tùy chỉnh theo ngôn ngữ của người dùng. API này sẽ có định dạng mới và chúng tôi khuyến khích các nhà phát triển tận dụng định dạng mới này để đặt và truy xuất thông tin về Tin nhắn làm quen. Bạn có thể xem danh sách các ngôn ngữ được hỗ trợ tại đây.

Thiết lập Tin nhắn làm quen

Định dạng mới (khuyên dùng)

curl -X POST -H "Content-Type: application/json" -d '{
     "platform": "instagram",
     "ice_breakers":[
       {
          "call_to_actions":[
             {
                "question":"

Định dạng cũ (không nên dùng để thiết lập Tin nhắn làm quen mới)

curl -X POST -H "Content-Type: application/json" -d '{
  "platform": "instagram",
  "ice_breakers":[
     {
        "question": "

Nhận Tin nhắn làm quen

Tùy theo cách thiết lập Tin nhắn làm quen, yêu cầu GET sẽ trả về một định dạng khác. Hành vi dưới đây được áp dụng:

• Nếu bạn thiết lập Tin nhắn làm quen theo định dạng Cũ, yêu cầu GET sẽ trả về phản hồi theo định dạng Cũ.
• Nếu bạn thiết lập Tin nhắn làm quen theo định dạng Mới, yêu cầu GET sẽ trả về phản hồi theo định dạng Mới.

Nhà phát triển nên chuyển sang định dạng mới vì chúng tôi sẽ ngừng sử dụng định dạng cũ trong tương lai.

curl -X GET "https://graph.facebook.com/v11.0/me/messenger_profile?fields=ice_breakers&platform=instagram&access_token=<PAGE_ACCESS_TOKEN>

Phản hồi theo định dạng mới

{
   "data": [
        {
          "call_to_actions" : [
               {
                "question": "

Phản hồi theo định dạng cũ

{
   "data": [
        {
          "ice_breakers": [
            {
                "question": "

Xóa Tin nhắn làm quen

curl -X DELETE -H "Content-Type: application/json" -d '{
  "fields": [
    "ice_breakers",
  ]
}' "https://graph.facebook.com/v11.0/me/messenger_profile?platform=instagram&access_token=%lt;PAGE_ACCESS_TOKEN>"

Sự kiện webhook

Để nhận webhook đăng lại từ Tin nhắn làm quen, bạn cần cần đăng ký webhook messaging_postbacks v8.0 trở lên cho ứng dụng trong chủ đề Instagram trên phần cài đặt ứng dụng.

Webhook sẽ nhận được phần tải dữ liệu json tương tự như ví dụ bên dưới.

{
  "object": "instagram",
  "entry": [
    {
      "id": "<IGID>",
      "time": 1502905976963,
      "messaging": [
        {
          "sender": {
            "id": "<IGSID>"
          },
          "recipient": {
            "id": "<IGID>"
          },
          "timestamp": 1502905976377,
          "postback": {
            "title": "<SELECTED_ICEBREAKER_QUESTION>",
            "payload": "<USER_DEFINED_PAYLOAD>",
          }
        }
      ]
    }
  ]
}