การยืนยันตัวตนสำหรับแอพธุรกิจ

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

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

หากคุณต้องการให้แอพของคุณแสดงบนแพลตฟอร์มแอพธุรกิจของเรา คุณต้องสร้าง URL การยืนยันตัวตนและตำแหน่งข้อมูลของ Webhook และนำไปตั้งค่าพร้อมตรวจสอบความถูกต้องผ่านแผงควบคุมสำหรับผู้พัฒนา

แอพทั้งหมดต้องเข้ารับการตรวจสอบการผสานการทำงาน เมื่อการผสานการทำงานของ FBE ได้รับการอนุมัติแล้ว แอพของคุณก็จะพร้อมใช้งานสำหรับผู้ใช้สาธารณะ

การใช้ URL การยืนยันตัวตน

แอพธุรกิจจะเปิดใช้กระบวนการที่คล้ายคลึงกับการเข้าสู่ระบบธุรกิจจากแพลตฟอร์มของเพจ Facebook, Instagram และ Facebook Business Suite หากต้องการเปิดใช้งานกระบวนการนี้และต้องการให้มีแอพของคุณแสดงอยู่ในแอพธุรกิจดังกล่าว คุณต้องใส่ UI การยืนยันตัวตนที่กำหนดเองซึ่งจะช่วยให้ผู้ใช้เลือกธุรกิจของตนเองบนเว็บไซต์ของคุณได้ จากนั้นจึงเปลี่ยนเส้นทางของผู้ใช้กลับไปยังกระบวนการบน Facebook, Instagram หรือ Facebook Business Suite

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

1. ระบุตำแหน่งข้อมูล URL ที่กำหนดเอง (URL การยืนยันตัวตน) ที่โหลดกระบวนการยืนยันตัวตนบนแพลตฟอร์มของคุณ
• URL การยืนยันตัวตนของคุณควรนำผู้ใช้ (เจ้าของธุรกิจ) ไปยังกระบวนการเข้าสู่ระบบบนแพลตฟอร์มของคุณ
• ให้ตัวเลือกในการลงทะเบียนบัญชีใหม่บนแพลตฟอร์มของคุณ (เช่น "สมัคร") หลังจากลงทะเบียนแล้ว ระบบจะส่งผู้ใช้กลับไปที่ Facebook เพื่อเชื่อมต่อบัญชีของตนให้เสร็จ
• หากคุณรองรับหลายธุรกิจต่อ 1 บัญชีบนแพลตฟอร์ม หลังจากเข้าสู่ระบบสำเร็จแล้ว URL การยืนยันตัวตนควรแสดง UI เพื่อให้ผู้ใช้เลือกธุรกิจบนแพลตฟอร์มของคุณที่ต้องการเชื่อมโยงกับองค์ประกอบ Facebook ของผู้ใช้
ตัวอย่าง — URL การยืนยันตัวตน

https://yourwebsite.com/fbe-auth

2. Facebook จะโหลด URL การยืนยันตัวตนที่คุณระบุในระหว่างกระบวนการเริ่มต้นใช้งานและต่อท้ายด้วยพารามิเตอร์การสืบค้น redirect_uri (ซึ่งก็คือ URI การเปลี่ยนเส้นทางซึ่งอาจมีพารามิเตอร์การสืบค้นเพิ่มเติม):

   https://yourwebsite.com/fbe-auth?redirect_uri=<an_encoded_redirect_uri_with_query_params>

   ตัวอย่าง - URI การเปลี่ยนเส้นทางที่เข้ารหัสที่อาจต่อท้ายในพารามิเตอร์การสืบค้น redirect_uri:

   https://www.facebook.com/local/dev/transaction_tool_selector/redirect?app_id=<int_value>&app_name=<string_value>&page_id=<int_value>

   ในส่วนสุดท้ายของขั้นตอนนี้ Facebook จะโหลด URL การยืนยันตัวตนที่มีพารามิเตอร์การสืบค้น redirect_uri ที่ต่อท้ายและเข้ารหัสไว้ โดยอาจมีลักษณะดังนี้:

   https://yourwebsite.com/fbe-auth?redirect_uri=https%3A%2F%2Fwww.facebook.com%2Flocal%2Fdev%2Ftransaction_tool_selector%2Fredirect%3Fapp_id%3D123%26app_name%3DSample%26page_id%3D456

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

   https?:\/\/(www\.|m\.|l\.|web\.|business\.)?(\d{4,5}\.od\.)?(business\.)?(facebook|instagram|whatsapp)\.com(\/.*)?

3. หลังจากที่ผู้ใช้เข้าสู่ระบบ/สมัครใช้งานได้แล้วและเลือกธุรกิจบนแพลตฟอร์มของคุณ (หากมี) ให้เปลี่ยนเส้นทางผู้ใช้ไปยัง URL จาก redirect_uri หลังจากต่อท้ายด้วยอ็อบเจ็กต์ extras ที่เข้ารหัสเป็นพารามิเตอร์การสืบค้น (เช่นเดียวกับที่คุณอาจใช้สำหรับการเข้าสู่ระบบธุรกิจ) โดยมี business_config และ setup ที่ระบุอยู่ในพารามิเตอร์ (ทั้งนี้ ขึ้นอยู่กับการกำหนดค่าการเริ่มต้นใช้งานที่คุณต้องการใช้):

   https://www.facebook.com/local/dev/transaction_tool_selector/redirect?app_id=<int_value>&app_name=<string_value>&page_id=<int_value>&extras=<an_encoded_json_string>

การยืนยันตัวตน iframe

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

การนำ Webhooks ไปใช้

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

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

การตั้งค่าและการตรวจสอบความถูกต้องของ Webhooks

เมื่อตำแหน่งข้อมูลของ Webhooks พร้อมแล้ว ในการตั้งค่าและการตรวจสอบความถูกต้องของ Webhooks คุณจะต้องดำเนินการดังนี้:

1. ใช้การ์ด Webhooks ในส่วน Facebook Business Extension -> การตั้งค่า ของแดชบอร์ดของแอพเพื่อตรวจสอบตำแหน่งข้อมูล และสมัครรับข้อมูล Webhooks fbe_install ดูรายละเอียดเพิ่มเติมได้ที่คู่มือการนำ Webhooks ไปใช้งาน
2. เมื่อผลิตภัณฑ์ Webhooks ได้รับการกำหนดค่าอย่างถูกต้อง วงกลมที่ด้านบนขวาของการ์ดจะเปลี่ยนเป็นสีเขียวและแสดงไอคอนเครื่องหมายถูก

การตั้งค่าและการตรวจสอบความถูกต้องผ่านแผงควบคุมสำหรับผู้พัฒนา

แผงควบคุมสำหรับผู้พัฒนาในส่วนขยาย Facebook Business คือผลิตภัณฑ์หนึ่งในแดชบอร์ดของแอพสำหรับผู้พัฒนา เมื่อแอพของคุณได้รับอนุญาตให้ใช้ FBE ได้แล้ว คุณควรใช้แผงควบคุมสำหรับผู้พัฒนาเพื่อตั้งค่าและตรวจสอบความถูกต้องของ URL การยืนยันตัวตนและตำแหน่งข้อมูล Webhook รวมทั้งเพื่อเพิ่มรายละเอียดเกี่ยวกับสิ่งที่แอพพลิเคชั่นของคุณจะมีให้สำหรับธุรกิจ

การตั้งค่าและการตรวจสอบความถูกต้องของ URL การยืนยันตัวตน

เมื่อ URL การยืนยันตัวตนพร้อมแล้ว ในการตั้งค่าและการตรวจสอบความถูกต้องของ URL คุณจะต้องดำเนินการดังนี้:

1. ไปที่แผงควบคุมสำหรับผู้พัฒนา FBE ในแดชบอร์ดของแอพ หมายเหตุ: หากคุณยังไม่ได้กำหนดค่า ให้ทำตามคำแนะนำต่อไปนี้เพื่อเพิ่มแผงควบคุมดังกล่าว
2. คลิกแท็บการตั้งค่า และมองหาการ์ดของแพลตฟอร์มแอพธุรกิจ
3. เลือกกล่องกาเครื่องหมายแสดงแอพของฉันบนแพลตฟอร์มแอพธุรกิจ
4. ในอินพุตของ URL การยืนยันตัวตน ให้ป้อน URL การยืนยันตัวตนของคุณ
5. คลิกปุ่มทดสอบการยืนยันตัวตน
• หน้าต่างป๊อปอัพจะเปิดขึ้นและโหลด URL ของคุณเพื่อเลียนแบบวิธีที่ Facebook จะใช้บนแพลตฟอร์มแอพธุรกิจ
• ดำเนินการเข้าสู่ระบบและเลือกธุรกิจ (หากมี)
• หลังจากเปลี่ยนเส้นทางแล้ว หน้าต่างป๊อปอัพจะปิดลง หากมีข้อผิดพลาดในการนำไปใช้งาน (เช่น มีค่าที่ไม่ถูกต้องในส่วนเสริม) ระบบจะแสดงข้อผิดพลาดที่ด้านล่างของการ์ดนี้เพื่อคุณจะได้ทราบสิ่งที่ต้องแก้ไข ฟีเจอร์ทดสอบการยืนยันตัวตนจะตรวจสอบความถูกต้องของอินพุตใน redirect_uri เท่านั้นและไม่ได้ติดตั้ง FBE จริงๆ
6. เมื่อขั้นตอนการนำไปใช้งานและการกำหนดค่าส่วนเสริมได้นำไปใช้ตามที่คาดไว้ คุณจะเห็นว่าขั้นตอนนี้มีเครื่องหมายระบุว่าถูกต้อง (เครื่องหมายถูกสีเขียวที่มุมขวาบนของการ์ด) การดำเนินการนี้จะช่วยให้สามารถทดสอบกระบวนการเริ่มต้นใช้งานนี้ได้ตั้งแต่ต้นทางถึงปลายทาง (ติดตั้ง FBE) ได้โดยตรงจาก Facebook (ดูส่วนด้านล่าง)

การทดสอบแบบต้นทางถึงปลายทาง

เมื่อ URL การยืนยันตัวตนและตำแหน่งข้อมูล Webhooks ได้รับการตั้งค่าและตรวจสอบความถูกต้องบนแผงควบคุมสำหรับผู้พัฒนาสำเร็จแล้ว คุณสามารถทำการทดสอบกระบวนการเริ่มต้นใช้งานแบบต้นทางถึงปลายทางได้ ซึ่งทำงานด้วยแอพของคุณ ก่อนที่จะเผยแพร่ ซึ่งสามารถดำเนินการได้โดยตรงจากแพลตฟอร์ม Facebook Business Suite หรือเพจ Facebook ดังนี้:

ผ่าน Facebook Business Suite

1. ไปที่ Facebook Business Suite
2. คลิกเครื่องมือเพิ่มเติมที่แถบด้านซ้าย แล้วคลิกแอพธุรกิจ
3. แอพทั้งหมดที่มีอยู่จะแสดงอยู่ที่นั่น แอพของคุณจะแสดงอยู่ในประเภทที่คุณเลือกให้เป็นหมวดหมู่บนแท็บการตั้งค่าในแผงควบคุมสำหรับผู้พัฒนา
4. แอพของคุณจะมีป้ายทดสอบเท่านั้น ไม่เป็นสาธารณะ ซึ่งหมายความว่าจะให้ผู้ใช้ที่มีบทบาทในแอพของคุณเท่านั้นที่ทดสอบได้ โดยผู้ใช้สาธารณะจะยังใช้ไม่ได้
5. คลิกที่เชื่อมต่อและเริ่มทดสอบการใช้งานที่ทำงานด้วย URL การยืนยันตัวตนของคุณ
   • กระบวนการเริ่มต้นใช้งานจะทำการติดตั้ง FBE จริงและจะเริ่มส่งการแจ้งเตือน Webhooks

ผ่านแพลตฟอร์มเพจ Facebook

1. ไปที่เพจ Facebook ที่คุณมีสิทธิ์การเข้าถึงระดับผู้ดูแล
2. คลิกแอพธุรกิจที่แถบด้านซ้ายของเพจ Facebook
3. แอพทั้งหมดที่มีอยู่จะแสดงอยู่ที่นั่น แอพของคุณจะแสดงอยู่ในประเภทที่คุณเลือกให้เป็นหมวดหมู่บนแท็บการตั้งค่าในแผงควบคุมสำหรับผู้พัฒนา
4. แอพของคุณจะมีป้ายทดสอบเท่านั้น ไม่เป็นสาธารณะ ซึ่งหมายความว่าจะให้ผู้ใช้ที่มีบทบาทในแอพของคุณเท่านั้นที่ทดสอบได้ โดยผู้ใช้สาธารณะจะยังใช้ไม่ได้
5. คลิกที่เชื่อมต่อและเริ่มทดสอบการใช้งานที่ทำงานด้วย URL การยืนยันตัวตนของคุณ
   • กระบวนการเริ่มต้นใช้งานจะทำการติดตั้ง FBE จริงและจะเริ่มส่งการแจ้งเตือน Webhooks

เรียนรู้เพิ่มเติม

• วิธีใช้การเข้าสู่ระบบธุรกิจสำหรับ FBE
• extras
• business_config
• setup
• วิธีถอนการติดตั้ง FBE