ข้อมูลอ้างอิงเหตุการณ์ Webhook messaging_referrals

การเรียกกลับนี้จะเกิดขึ้นเมื่อผู้ใช้มีเธรดกับบอทอยู่แล้ว และผู้ใช้เข้ามายังเธรดนั้นจากการทำสิ่งต่อไปนี้

• การไปตามลิงก์ m.me ที่มีพารามิเตอร์อ้างอิง
• การคลิกที่โฆษณาการสนทนาใน Messenger
• การเริ่มการสนทนาหรือการสนทนาต่อจากปลั๊กอินแชทของลูกค้า

โปรดดูการติดตามการอ้างอิงในเธรดใหม่ๆ ที่เหตุการณ์โพสต์ย้อนกลับ

หากต้องการเริ่มรับเหตุการณ์เหล่านี้ คุณจำเป็นต้องสมัครรับข้อมูล messaging_referrals ในการตั้งค่า Webhook สำหรับแอพของคุณ

เนื้อหา

• ตัวอย่าง

  • ลิงก์ m.me
  • การอ้างอิงโฆษณา
  • ปลั๊กอินแชทของลูกค้า
• คุณสมบัติ

ตัวอย่าง

ลิงก์ m.me

{
  "sender": {
    "id": "<PSID>"
  },
  "recipient": {
    "id": "<PAGE_ID>"
  },
  "timestamp": 1458692752478,
  "referral": {
    "ref": <REF_DATA_PASSED_IN_M.ME_PARAM>,
    "source": "SHORTLINK",
    "type": "OPEN_THREAD",
  }
}

การอ้างอิงโฆษณา

{
  "sender": {
    "id": "<PSID>"
  },
  "recipient": {
    "id": "<PAGE_ID>"
  },
  "timestamp": 1458692752478,
  "referral": {
    "ref": <REF_DATA_IF_SPECIFIED_IN_THE_AD>,
    "ad_id": <ID_OF_THE_AD>,
    "source": "ADS",
    "type": "OPEN_THREAD",
    "ads_context_data": {
      "ad_title": <TITLE_OF_THE_AD>,
      "photo_url": <URL_OF_THE_IMAGE_FROM_AD_THE_USER_IS_INTERESTED_IN>,
      "video_url": <THUMBNAIL_URL_OF_THE_VIDEO_FROM_THE_AD>,
      "post_id": <ID_OF_THE_POST>,
      "product_id": <PRODUCT_ID>
    }
  }
}

ปลั๊กอินแชทของลูกค้า

เหตุการณ์ Webhook การอ้างอิงแบบใหม่ (API กราฟเวอร์ชั่น 7.0 ขึ้นไปและ API กราฟทุกเวอร์ชั่นตั้งแต่วันที่ 2 พ.ย. 2020 เป็นต้นไป)

{
  "sender":{
    "user_ref":"<USER_REF>"
  },
  "recipient":{
    "id":"<PAGE_ID>"
  },
  "timestamp": 1458692752478,
  "referral": {
     "ref": "<REF_DATA_PASSED_IN_CODE>",
     "source": "CUSTOMER_CHAT_PLUGIN",
     "type": "OPEN_THREAD",
     "referer_uri": "<WEBSITE_URL>"
  }
}

เหตุการณ์ Webhook การอ้างอิงแบบเก่า (API กราฟเวอร์ชั่น 6.0 ลงมา - ใช้งานได้จนถึงวันที่ 2 พ.ย. 2020)

{
  "sender":{
    "id":"<PSID>"
  },
  "recipient":{
    "id":"<PAGE_ID>"
  },
  "timestamp": 1458692752478,
  "referral": {
     "ref": "<REF_DATA_PASSED_IN_CODE>",
     "source": "CUSTOMER_CHAT_PLUGIN",
     "type": "OPEN_THREAD",
     "referer_uri": "<WEBSITE_URL>"
  }
}

คุณสมบัติ

sender

recipient

referral

ads_context_data