ประโยคเริ่มการสนทนา

ประโยคเริ่มการสนทนาเป็นช่องทางที่ช่วยให้ผู้ใช้เริ่มการสนทนากับธุรกิจได้ผ่านรายการคำถามที่พบบ่อย โดยสามารถตั้งคำถามได้สูงสุดถึง 4 คำถามผ่าน API ประโยคเริ่มการสนทนา

นับตั้งแต่วันที่ 19 ตุลาคม 2021 ประโยคเริ่มการสนทนารองรับการแปลเพื่อช่วยให้ธุรกิจสามารถตั้งคำถามแบบกำหนดเองตามรูปแบบภาษาของผู้ใช้ได้ API จะมีรูปแบบใหม่ และเราส่งเสริมให้ผู้พัฒนาใช้ประโยชน์จากรูปแบบใหม่นี้ในการตั้งค่าและเรียกดูข้อมูลประโยคเริ่มการสนทนา คุณสามารถเข้าดูรายการรูปแบบภาษาที่รองรับได้ที่นี่

การตั้งค่าประโยคเริ่มการสนทนา

รูปแบบใหม่ (แนะนำ)

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

รูปแบบเก่า (ไม่ควรนำมาใช้กับการตั้งค่าประโยคเริ่มการสนทนาใหม่)

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

การเรียกดูประโยคเริ่มการสนทนา

คำขอ GET จะส่งคืนรูปแบบที่แตกต่างออกไป ทั้งนี้ขึ้นอยู่กับว่าตั้งค่าประโยคเริ่มการสนทนาไว้อย่างไร ประโยคเริ่มการสนทนาจะมีลักษณะการทำงานดังต่อไปนี้

• หากตั้งค่าประโยคเริ่มการสนทนาโดยใช้รูปแบบเก่า คำขอ GET ก็จะส่งคืนการตอบกลับที่เป็นรูปแบบเก่า
• หากตั้งค่าประโยคเริ่มการสนทนาโดยใช้รูปแบบใหม่ คำขอ GET ก็จะส่งคืนการตอบกลับที่เป็นรูปแบบใหม่

เราขอแนะนำให้ผู้พัฒนาเปลี่ยนมาใช้รูปแบบใหม่ เนื่องจากเรากำลังจะเลิกใช้รูปแบบเก่า

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

การตอบกลับที่เป็นรูปแบบใหม่

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

การตอบกลับที่เป็นรูปแบบเก่า

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

การลบประโยคเริ่มการสนทนา

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>"

เหตุการณ์ Webhook

ในการรับ Webhooks โพสต์ย้อนกลับจากประโยคเริ่มการสนทนา แอพจำเป็นต้องติดตาม Webhook messaging_postbacks เวอร์ชั่น 8.0 ขึ้นไปภายใต้หัวข้อ Instagram ในการตั้งค่าแอพ

Webhook จะได้รับเพย์โหลด JSON คล้ายกับตัวอย่างด้านล่าง

{
  "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>",
          }
        }
      ]
    }
  ]
}