ربط الحساب

عندما يبدأ أحد المستخدمين محادثة مع نشاطك التجاري، قد ترغب في تحديده كعميل يمتلك بالفعل حسابًا لدى نشاطك التجاري. ولمساعدتك في ذلك، قمنا بإنشاء بروتوكول آمن لربط هوية مستخدم Messenger بهوية المستخدم في نشاطك التجاري أو إلغاء ربطها.

تتيح لك عملية ربط الحسابات دعوة المستخدمين لتسجيل الدخول باستخدام دفق المصادقة الذي توفره والحصول على معرف على نطاق الصفحة (PSID) في Messenger بمجرد اكتمال العملية. ويمكنك بعد ذلك توفير تجربة أكثر أمانًا وملاءمة وذات طابع شخصي للمستخدمين.

المحتويات

• عملية الربط
• الاستدعاء
• حدث Webhook
• نقطة نهاية إلغاء ربط الحساب
• أفضل الممارسات

عملية الربط

يتبع دفق ربط الحسابات عددًا من الخطوات البسيطة.

1. قم بتسجيل عنوان URL للاستدعاء باستخدام زر تسجيل الدخول.
2. تقوم منصة Messenger باستدعاء عنوان URL المسجل عندما يبدأ أحد المستخدمين دفق ربط الحساب. يتم إلحاق كل من المعلمة redirect_uri وaccount_linking_token بالاستدعاء المسجل.
3. بمجرد اكتمال عملية الربط، أعد توجيه المستخدمين إلى الموقع الذي توفره redirect_uri وقم بإلحاق المعلمة authorization_code (التي تم تحديدها من جانبك) لتأكيد عملية الربط.
4. يمكنك بشكل اختياري استرداد معرف المستخدم على مستوى الصفحة (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

يؤدي دفق الربط الناجح إلى تشغيل حدث ربط الحساب لتسليم معرف المستخدم على مستوى الصفحة (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"
}    

نقطة نهاية إلغاء ربط الحساب

في بعض الحالات قد تحتاج إلى إلغاء ربط المعرف على مستوى الصفحة (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. احرص على المتابعة من خلال إرسال رسالة شكر ودية و/أو الخطوات التالية في السلسلة، مع تضمين خيار لتسجيل الخروج.