การลิงก์บัญชี

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

การลิงก์บัญชีช่วยให้คุณสามารถเชิญผู้ใช้ให้เข้าสู่ระบบโดยใช้ขั้นตอนการยืนยันตัวตนของคุณเอง และรับ ID ในเพจ (PSID) บน Messenger เมื่อผู้ใช้เข้าสู่ระบบเรียบร้อยแล้ว ทำให้คุณสามารถมอบประสบการณ์ที่ปลอดภัย ได้รับการปรับให้เหมาะกับแต่ละบุคคล และมีความเกี่ยวข้องกับผู้ใช้มากขึ้นได้

เนื้อหา

• ขั้นตอนการลิงก์
• การเรียกกลับ
• เหตุการณ์ Webhook
• ตำแหน่งข้อมูลการยกเลิกการลิงก์บัญชี
• หลักปฏิบัติที่ดีที่สุด

ขั้นตอนการลิงก์

การลิงก์บัญชีมีขั้นตอนง่ายๆ ไม่กี่ขั้นตอนดังนี้

1. ลงทะเบียน URL การเรียกกลับโดยใช้ปุ่มเข้าสู่ระบบ
2. แพลตฟอร์ม Messenger จะเรียกใช้ URL ที่ลงทะเบียนไว้เมื่อผู้ใช้เริ่มขั้นตอนการลิงก์บัญชี โดยพารามิเตอร์ redirect_uri และ account_linking_token จะถูกนำมาต่อท้ายการเรียกกลับที่คุณลงทะเบียนไว้
3. เมื่อทำการลิงก์เรียบร้อยแล้ว ให้เปลี่ยนเส้นทางผู้ใช้ไปยังตำแหน่งที่ redirect_uri ระบุ และนำพารามิเตอร์ authorization_code (ที่คุณกำหนดไว้) มาต่อท้ายเพื่อยืนยันการลิงก์
4. นอกจากนี้ คุณสามารถเรียกดู ID ในเพจ (PSID) ของผู้ใช้โดยใช้ตำแหน่งข้อมูลการลิงก์บัญชีได้เช่นกัน แต่คุณควรใช้ขั้นตอนนี้เฉพาะในกรณีที่ต้องการให้ PSID ของผู้ใช้เป็นส่วนหนึ่งของขั้นตอนการลิงก์เท่านั้น

การยกเลิกการลิงก์บัญชีสามารถทำได้ดังนี้

• เมื่อผู้ใช้แตะปุ่มออกจากระบบที่ส่งมาจากผู้พัฒนา
• เมื่อธุรกิจใช้ตำแหน่งข้อมูลการยกเลิกการลิงก์บัญชี

การเรียกกลับ

แพลตฟอร์ม Messenger จะเรียกใช้ URL การลิงก์บัญชีเมื่อผู้ใช้ทริกเกอร์การลิงก์บัญชี โดยพารามิเตอร์ redirect_uri และ account_linking_token จะถูกนำมาต่อท้าย URL การเรียกกลับ

<yourAccountLinkingUrl>
  ?account_linking_token=ACCOUNT_LINKING_TOKEN
  &redirect_uri=CALLBACK_URL

หากลิงก์บัญชีสำเร็จ คุณจะต้องดำเนินขั้นตอนให้เสร็จสมบูรณ์โดยเปลี่ยนเส้นทางเบราว์เซอร์ไปยัง URL ที่ระบุไว้ในพารามิเตอร์ redirect_uri และนำพารามิเตอร์ authorization_code ที่คุณกำหนดไว้มาต่อท้าย โปรดทราบว่า URL ดังกล่าวอาจมีพารามิเตอร์อยู่แล้ว ดังนั้น คุณควรนำรหัสการให้อนุญาตมาต่อท้ายพารามิเตอร์นั้น:

<redirect_uri>
  &authorization_code=AUTHORIZATION_CODE

หากลิงก์บัญชีไม่สำเร็จ ให้เปลี่ยนเส้นทางเบราว์เซอร์ไปยัง redirect_uri ที่ส่งถึงคุณเป็นพารามิเตอร์ แต่ไม่ต้องนำ authorization_code มาต่อท้าย

พารามิเตอร์

เหตุการณ์ Webhook

ขั้นตอนการลิงก์ที่เสร็จสมบูรณ์จะทริกเกอร์เหตุการณ์การลิงก์บัญชีให้ส่ง ID ในเพจ (PSID) ของผู้ใช้

ตำแหน่งข้อมูลการเรียกดู PSID

ในบางกรณี คุณจำเป็นต้องเรียกดู ID ในเพจ (PSID) ของผู้ใช้ในระหว่างขั้นตอนการลิงก์ เพื่ออำนวยความสะดวกในสถานการณ์นี้ เราจึงได้เตรียมตำแหน่งข้อมูลการเรียกดู PSID ไว้เพื่อช่วยให้คุณสามารถดึง PSID ของผู้ใช้ที่ได้รับ account_linking_token ใช้งานได้และยังไม่หมดอายุ

คำขอ

curl -X GET "https://graph.facebook.com/v2.6/me?access_token=PAGE_ACCESS_TOKEN \
      &fields=recipient \
      &account_linking_token=ACCOUNT_LINKING_TOKEN"

การตอบกลับ

{
  "id": "PAGE_ID",
  "recipient": "PSID"
}    

ตำแหน่งข้อมูลการยกเลิกการลิงก์บัญชี

ในบางกรณี คุณจำเป็นต้องยกเลิกการลิงก์ ID ในเพจ (PSID) ของผู้ใช้อย่างเป็นระบบจากฝั่งแบ็คเอนด์ของคุณ เพื่ออำนวยความสะดวกในสถานการณ์นี้ เราจึงได้เตรียมตำแหน่งข้อมูลการยกเลิกการลิงก์ PSID ที่จะช่วยให้คุณสามารถยกเลิกการลิงก์บัญชีของผู้ใช้ที่ได้รับ PSID ที่ใช้งานได้

คำขอ

curl -X POST -H "Content-Type: application/json" -d '{
   "psid":"PSID"
}' "https://graph.facebook.com/v2.6/me/unlink_accounts?access_token=PAGE_ACCESS_TOKEN"

การตอบกลับ

{
  "result": "unlink account success"
}

หลักปฏิบัติที่ดีที่สุด

ขั้นตอนการออกแบบที่แนะนำ

1. แจ้งให้เข้าสู่ระบบด้วยข้อความที่มีปุ่มการลิงก์บัญชีของเรา
2. แสดงหน้าเข้าสู่ระบบของคุณ (รวมถึงตัวเลือก "สร้างบัญชี") ในตัวแสดงหน้าเว็บการลิงก์บัญชี ตรวจสอบให้แน่ใจว่าตัวแสดงหน้าเว็บสวยงามและทำงานได้ดีบนหน้าจอมือถือ
3. หลังจากเข้าสู่ระบบสำเร็จแล้ว ให้แสดงข้อความยืนยันในตัวแสดงหน้าเว็บ ผู้ใช้จะต้องปิดข้อความนั้นเองในภายหลัง
4. แสดงคำขอบคุณที่เป็นมิตรตามมาและ/หรือขั้นตอนถัดไปในเธรด รวมถึงตัวเลือก "ออกจากระบบ"