แพลตฟอร์ม Messenger

ลิงก์ m.me

เอกสารนี้จะแสดงให้คุณเห็นวิธีสร้างลิงก์ m.me สำหรับประสบการณ์การใช้งาน Messenger ของคุณ

m.me เป็นบริการ URL ที่ให้บริการโดย Meta โดยจะเปลี่ยนเส้นทางผู้คนไปยังบุคคล เพจ หรือการสนทนาใน Messenger คุณสามารถใช้ลิงก์นี้บนเว็บไซต์ จดหมายข่าวทางอีเมล และอีกมากมาย

วิธีการทำงาน

รูปแบบของลิงก์ m.me จะเป็นดังต่อไปนี้ โดยที่ PAGE-NAME คือเพจ Facebook ที่ลิงก์กับแอพรับส่งข้อความของคุณ

http://m.me/PAGE-NAME

เมื่อมีคนคลิกลิงก์ m.me ระบบจะเปลี่ยนเส้นทางของผู้ใช้ไปยังการสนทนาใหม่กับธุรกิจของคุณ หรือไปยังการสนทนาที่มีอยู่แล้วหากผู้ใช้รายนั้นเคยส่งข้อความถึงธุรกิจของคุณ ข้อความเริ่มต้น "คุณร่วมการสนทนานี้โดยการใช้ลิงก์ เราได้แจ้งให้ PAGE-NAME ทราบแล้วว่าคุณมาที่นี่" จะปรากฏขึ้นในการสนทนา

คุณสามารถเพิ่มพารามิเตอร์ text เพื่อรวมข้อความแบบกำหนดเองไว้ได้ด้วยเช่นกัน

http://m.me/PAGE-NAME?text=Hello%20and%20Welcome

ธุรกิจสามารถแชร์ลิงก์ที่เปลี่ยนเส้นทางไปยังเว็บไซต์หรือเธรดอื่นๆ ได้ โดยบางรายการอาจมีข้อความที่ป้อนล่วงหน้ารวมอยู่ด้วย

เมื่อมีคนคลิกปุ่ม "เริ่มต้นใช้งาน" เพื่อเริ่มการสนทนากับธุรกิจของคุณ ระบบจะส่งการแจ้งเตือน Webhook messaging_postbacks ไปยังเซิร์ฟเวอร์ Webhooks ของคุณ อ็อบเจ็กต์ postback จะมีอ็อบเจ็กต์ referral ที่มีพารามิเตอร์ ref โดยเป็นส่วนหนึ่งของการแจ้งเตือน Webhook นี้

เมื่อมีคนคลิกลิงก์ m.me และมีการสนทนาระหว่างธุรกิจของคุณกับบุคคลนั้นอยู่แล้ว ลิงก์ดังกล่าวจะนำบุคคลไปยังการสนทนาที่มีอยู่ การดำเนินการนี้จะรีเซ็ตช่วงเวลาการส่งข้อความมาตรฐาน 24 ชั่วโมง ช่วยให้แอพรับส่งข้อความของคุณตอบกลับบุคคลนั้นได้ และระบบจะส่งการแจ้งเตือน Webhook messaging_referrals ไปยังเซิร์ฟเวอร์ Webhooks ของคุณ พารามิเตอร์ ref จากลิงก์ m.me จะถูกรวมเอาไว้ด้วยโดยเป็นส่วนหนึ่งของการแจ้งเตือน Webhook นี้

พารามิเตอร์อ้างอิง

ลิงก์ m.me สามารถมีพารามิเตอร์ ref ที่เมื่อมีคนคลิกลิงก์จะให้บริบทเพิ่มเติมเกี่ยวกับการสนทนาแก่ธุรกิจของคุณ เช่น ลิงก์บนเว็บไซต์ของคุณกับลิงก์ในร้านค้า ลิงก์ประเภทนี้ยังสามารถนำบุคคลไปยังเนื้อหาหรือฟีเจอร์ที่เฉพาะเจาะจงซึ่งมีอยู่ในประสบการณ์การใช้งาน Messenger ของคุณได้ด้วย

http://m.me/PAGE-NAME?ref=REF-PARAMETER-INFORMATION

คิวอาร์โค้ด

คุณสามารถฝังลิงก์ m.me พร้อมพารามิเตอร์ ref ในคิวอาร์โค้ดได้ โดยคุณสามารถสแกนคิวอาร์โค้ดได้ด้วยกล้องที่มาพร้อมกับโทรศัพท์ เมื่อสแกนแล้ว ระบบจะเปิดแอพ Messenger และการสนทนาด้วยข้อความกับธุรกิจของคุณขึ้นมา

ตัวอย่างคิวอาร์โค้ด

คิวอาร์โค้ดตัวอย่างนี้มีการเข้ารหัส http://m.me/OriginalCoastClothing?ref=summer_coupon ซึ่งจะทริกเกอร์ให้เกิดขั้นตอนตัวอย่างเกี่ยวกับคูปองส่วนลดบน Messenger

การแจ้งเตือน Webhook

เมื่อคุณได้รับการแจ้งเตือน Webhook การแจ้งเตือนนี้จะมีข้อมูลจากบุคคลที่เริ่มการสนทนากับธุรกิจของคุณ หรือจากบุคคลที่มีการสนทนากับธุรกิจของคุณอยู่แล้ว

เริ่มการสนทนา

เมื่อมีคนคลิกปุ่มเริ่มต้นใช้งานเพื่อเริ่มการสนทนากับธุรกิจของคุณ เราจะส่งพารามิเตอร์ ref ซึ่งเป็นส่วนหนึ่งของการแจ้งเตือน Webhook messaging_postbacks

{
  "sender":{
    "id":"PSID"
  },
  "recipient":{
    "id":"PAGE-ID"
  },
  "timestamp":1458692752478,
  "postback":{
    "payload":"POSTBACK-PAYLOAD-YOU-CONFIGURED",
    "referral": {
      "ref": "REF-PARAMETER-INFORMATION",
      "source": "SHORTLINK",
      "type": "OPEN_THREAD",
    }
  }
}

สนทนาต่อในการสนทนาที่มีอยู่แล้ว

หากมีการสนทนาระหว่างธุรกิจของคุณกับบุคคลที่คลิกลิงก์ m.me อยู่แล้ว เราจะส่งการแจ้งเตือน Webhook messaging_referrals

{
  "sender":{
    "id":"PSID"
  },
  "recipient":{
    "id":"PAGE-ID"
  },
  "timestamp":1458692752478,
  "referral": {
    "ref": "REF-PARAMETER-INFORMATION",
    "source": "SHORTLINK",
    "type": "OPEN_THREAD",
  }
}

ก่อนเริ่มต้น

คู่มือนี้จะถือว่าคุณได้อ่านภาพรวมของแพลตฟอร์ม Messenger และปรับใช้องค์ประกอบต่างๆ ที่จำเป็นในการรับและส่งข้อความและการแจ้งเตือนแล้ว

คุณจะต้องดำเนินการดังต่อไปนี้

  • สิทธิ์การเข้าถึงระดับสูงสำหรับแอพที่ลิงก์กับเพจ Facebook ของธุรกิจคุณ
  • ปุ่มเริ่มต้นใช้งาน สำหรับประสบการณ์การใช้งาน Messenger ของคุณสำหรับการสนทนาใหม่
  • แอพที่ลิงก์กับเพจ Facebook ของธุรกิจต้องสมัครรับข้อมูลจากช่อง Webhooks messaging_postbacks และ messaging_referrals

ข้อจำกัด

  • แอพที่มีสิทธิ์การเข้าถึงแบบมาตรฐานสามารถเรียกดูข้อมูลได้เฉพาะจากผู้ใช้ที่มีบทบาทเป็นผู้พัฒนา ผู้ทดสอบ หรือผู้ดูแลในแอพรับส่งข้อความของคุณเท่านั้น

คำขอเลือกใช้ข้อความทางการตลาด

URL m.me/rn จะอนุญาตให้คุณสร้างคำขอให้เลือกรับการแจ้งเตือนประจำพร้อมลิงก์ m.me รูปแบบสำหรับลิงก์ m.me/rn ต้องมีการระบุหัวข้อเอาไว้สำหรับข้อความทางการตลาด ทั้งนี้ คุณสามารถกำหนดความถี่ของข้อความทางการตลาดได้ แต่หากไม่ได้กำหนดไว้ ระบบจะใช้ค่าเริ่มต้นเป็นแบบรายวัน

http://m.me/rn/PAGE-NAME?topic=TOPIC&cadence=MESSAGE-FREQUENCY

ข้อจำกัด

  • ต้องใช้ iOS เวอร์ชั่น 383 จึงจะใช้งานลิงก์ m.me/rn ได้ดี ระบบจะนำผู้ที่คลิกลิงก์ของคุณไปยัง URL m.me พื้นฐาน ซึ่งคือ URL http://m.me/PAGE-NAME

ลิงก์ตัวอย่างข้อความทางการตลาด

https://m.me/rn/OriginalCoastClothing?topic=weekly%20deals&cadence=weekly

ลงทะเบียนหัวข้อของคุณ

ก่อนที่คุณจะสามารถใช้ URL m.me/rn กับหัวข้อใหม่ได้ คุณจะต้องลงทะเบียนหัวข้อใหม่ก่อน

หากคุณใช้หัวข้อที่คุณใช้ใน URL m.me/rn ก่อนหน้าแล้ว และผู้คนเลือกรับข้อความทางการตลาด คุณก็ไม่ต้องลงทะเบียนหัวข้อใหม่อีกครั้ง

คุณสามารถลงทะเบียนหัวข้อใหม่ได้โดยทำตามขั้นตอนต่อไปนี้

ขั้นตอนที่ 1 ส่งคำขอให้เลือกรับข้อความทางการตลาดที่มีหัวข้อให้กับผู้ใช้ที่มีบทบาทในแอพของคุณด้วยตนเอง เราขอแนะนำให้เพิ่มเพย์โหลดเพื่อระบุว่านี่เป็นการลงทะเบียนหัวข้อของคุณ

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"PSID"
  },
  "message":{
    "attachment":{
      "type":"template", 
      "payload":{
         "template_type":"notification_messages", 
          "title":"TITLE",
          "payload": "Registering a new topic: TOPIC-NAME",
          "notification_messages_frequency": MESSAGE-FREQUENCY,
      }
    }
  }
}' "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

เมื่อดำเนินการสำเร็จ แอพของคุณจะได้รับการตอบกลับแบบ JSON ดังต่อไปนี้

{ 
        "recipient": {
          "id":"PSID",
          "message_id":"MESSAGE-ID",
}

ขั้นตอนที่ 2 โปรดตรวจสอบให้แน่ใจว่าได้คลิกที่ปุ่มเลือกรับในการสนทนา เราจะส่งการแจ้งเตือน Webhook ในการเลือกรับให้กับคุณ ขณะนี้ หัวข้อของคุณได้รับการลงทะเบียนและพร้อมใช้งานแบบสาธารณะแล้ว

ระบบจะนำผู้ที่คลิกลิงก์ m.me/rn ที่มีหัวข้อที่ยังไม่ได้ลงทะเบียนไปยัง URL การแจ้งเตือนพื้นฐานของคุณ ซึ่งคือ URL http://m.me/rn/PAGE-NAME

ขณะลงทะเบียนหัวข้อ หากคุณส่งคำขอให้เลือกรับถึงตัวคุณเองแต่ไม่ได้คลิกที่ปุ่มเลือกรับ หัวข้อของคุณก็จะไม่ได้รับการลงทะเบียน

ตัวอย่างคำขอ

มีการจัดรูปแบบเพื่อให้อ่านได้ง่าย
curl -X POST "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/notification_messages_dev_support
    ?recipient={
        "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN"
    }
    &developer_action=ENABLE_FOLLOWUP_MESSAGE
    &access_token=PAGE-ACCESS-TOKEN"

เมื่อดำเนินการสำเร็จ แอพของคุณจะได้รับการตอบกลับแบบ JSON ดังต่อไปนี้

{ "success": true }

การแจ้งเตือน Webhook messaging_optins

เมื่อคุณได้รับการแจ้งเตือน Webhook การแจ้งเตือนนี้จะมีข้อมูลจากบุคคลที่เริ่มการสนทนากับธุรกิจของคุณ หรือจากบุคคลที่มีการสนทนากับธุรกิจของคุณอยู่แล้ว

{
  "sender": {
    "id": "PSID",
  },
  "recipient": {
    "id": "PAGE-ID",
  },
  "timestamp": "TIMESTAMP",
  "optin": {
    "type": "notification_messages", 
    "title": "TITLE-FOR-NOTIFICATION-MESSAGE",
    "ref": "REF-PARAMETER-INFORMATION",
    "payload": "",
    "source":"SHORTLINK"
    "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN", 
    "notification_messages_topic": "RECURRING-NOTIFICATION-TOPIC", 
    "notification_messages_frequency": "MESSAGE-FREQUENCY",
    "notification_messages_timezone": "TIMEZONE-ID",
    "token_expiry_timestamp": "TIMESTAMP",
    "user_token_status": "TOKEN-STATUS"
    }
}

การอ้างอิง m.me

ชื่อพารามิเตอร์คำอธิบาย

cadence

enum { daily, monthly, weekly }

ความถี่ของข้อความสำหรับคำขอเลือกรับลิงก์ m.me/rn ค่าเริ่มต้นจะเป็น daily

ref

สตริง

บริบทเกี่ยวกับการสนทนา เช่น ลิงก์บนเว็บไซต์ของคุณกับลิงก์ในร้านค้า ซึ่งมีการส่งไว้ในการแจ้งเตือน Webhook messaging_referrals พารามิเตอร์นี้ต้องได้รับการเข้ารหัส URL เมื่อใช้งานบนลิงก์ m.me โดยค่านี้จะต้องมีความยาวไม่เกิน 2,083 อักขระ

text

สตริง

ข้อความแบบกำหนดเองที่คุณส่งเมื่อมีคนคลิกที่ลิงก์ m.me ของคุณเพื่อเข้าสนทนา

topic

สตริง 		ต้องระบุ

หัวข้อสำหรับคำขอให้เลือกรับลิงก์ m.me/rn เช่น โปรโมชั่นประจำสัปดาห์หรือสินค้าที่กำลังจะเปิดตัว พารามิเตอร์นี้ต้องได้รับการเข้ารหัส URL เมื่อใช้งานบนลิงก์ m.me มีทั้งตัวเลขและตัวอักษร, ไม่มีอักขระพิเศษ, มีการเข้ารหัส URL

ขั้นตอนถัดไป

ดูเพิ่มเติม