التواصل مع الأشخاص عبر التطبيقات والبرامج التلقائية في Messenger

من الشائع بالنسبة إلى الأنشطة التجارية استخدام عدة قنوات للتواصل مع عملائها، على سبيل المثال، موقع الويب وتطبيق الهواتف المحمولة وMessenger. عندما يستخدم شخص ما تسجيل دخول فيسبوك على أحد مواقع الويب أو تطبيقات الهواتف المحمولة، يتم إنشاء معرّف لتطبيق فيسبوك المحدد، والذي يطلق عليه اسم "معرّف على مستوى التطبيق". وعندما يقوم شخص ما بالتواصل مع النشاط التجاري عبر Messenger، يتم إنشاء معرّف للصفحة المحددة المرتبطة بالبرنامج التلقائي في Messenger، والذي يطلق عليها اسم "معرّف على مستوى الصفحة". وذلك يعني أنه، لنفس الشخص، تختلف المعرّفات عبر قنوات الاتصال المختلفة. يرجى العلم أنه يتم إنشاء المعرفات على نطاق التطبيق عندما يقوم المستخدم بتسجيل الدخول باستخدام تطبيقك، وبالتالي فلن يظهر لك المعرّفات على نطاق التطبيق بالنسبة إلى المستخدمين الذين لم يقوموا بتثبيت تطبيقك وتسجيل الدخول باستخدامه.

قد يرغب النشاط التجاري في تقديم تجربة متصلة للأشخاص عبر القنوات المختلفة. على سبيل المثال، عندما يتواصل شخص ما مع أحد الأنشطة التجارية عبر برنامج تلقائي في Messenger، يمكن إضفاء مزيد من الطابع الشخصي على التجربة إذا تعرف النشاط التجاري على أن الشخص هو أحد العملاء الحاليين في تطبيقه على فيسبوك (على سبيل المثال، موقع ويب أو تطبيق هواتف محمولة يعمل بتسجيل دخول فيسبوك). نوفر واجهة API لاسترداد المعرّفات من نفس الشخص عبر التطبيقات والبرامج التلقائية المختلفة في Messenger التي يمتلكه النشاط التجاري ذاته.

في البداية، يجب أن تسمح لفيسبوك بمعرفة أن تطبيقاتك وصفحاتك المرتبطة ببرنامجك التلقائي في Messenger تعود ملكيتها إلى نفس كيان النشاط التجاري. للقيام بذلك، يجب استخدام مدير الأعمال من فيسبوك للقيام بما يلي:

ثم يمكنك الاستعلام عن عنصر الربط ids_for_apps أو عنصر الربط ids_for_pages لعقدة المستخدم لكي تتمكن من استرداد المعرّفات.

قد يؤدي الاستدعاء الأول الذي تقوم به إلى واجهة API إلى تشغيل مراجعة تطبيق قد تستغرق 48 ساعة تقريبًا لتكتمل.

تتناول هذه الوثيقة:

حالات الاستخدام
أمثلة للاستعلامات
السياسة

حالات الاستخدام

هناك عدد قليل من حالات الاستخدام الأساسية لواجهة API هذه:

في حالة معرّف مستخدم لبرنامج تلقائي في Messenger، استرداد معرّفات المستخدم للتطبيقات المملوكة لنفس النشاط التجاري

عقدة المستخدم: معرّف على مستوى الصفحة المرتبطة بالبرنامج التلقائي في Messenger.
عنصر الربط:ids_for_apps
المتطلبات: يتطلب ذلك رمز وصول للصفحة وappsecret_proof، ويجب إنشاء كلاهما باستخدام التطبيق الذي يدير الصفحة. بالإضافة إلى ذلك، يجب أن يكون التطبيق الذي يدير الصفحة والتطبيق (التطبيقات) الأخرى للتواصل مملوكة لنفس النشاط التجاري.

أمثلة:

يعرض ذلك معرّفات كل التطبيقات المملوكة لنفس النشاط التجاري
```
GET /{user-id}/ids_for_apps
    ?access_token=[page_access_token]
    &appsecret_proof=[appsecret_proof]
```

يعرض ذلك معرّف التطبيق المحدد الذي يحمل معرّف التطبيق 10152368852405295

GET /{user-id}/ids_for_apps
    ?app=10152368852405295
    &access_token=[page_access_token]
    &appsecret_proof=[appsecret_proof]

في حالة معرّف مستخدم لأحد التطبيقات، استرداد معرّفات البرامج التلقائية في Messenger المملوكة لنفس النشاط التجاري

عقدة المستخدم: معرف على مستوى التطبيق.
عنصر الربط:ids_for_pages
المتطلبات: يتطلب ذلك رمز وصول للصفحة وappsecret_proof، ويجب إنشاء كلاهما باستخدام التطبيق الذي يدير الصفحة (الصفحات)، والذي تم إنشاء المعرّف على نطاقه. بالإضافة إلى ذلك، يجب أن يكون التطبيق والصفحة (الصفحات) مملوكة لنفس النشاط التجاري.

أمثلة:

يعرض ذلك معرّفات لكل البرامج التلقائية في Messenger التي تعود ملكية صفحتها المرتبطة إلى نفس النشاط التجاري
```
GET /{user-id}/ids_for_pages
    ?access_token=[app_access_token]
    &appsecret_proof=[appsecret_proof]
```
يعرض ذلك معرف البرنامج التلقائي المحدد في Messenger الذي تحمل صفحته المرتبطة معرّف الصفحة 380374449010653
```
GET /{user-id}/ids_for_pages
    ?page=380374449010653
    &access_token=[app_access_token]
    &appsecret_proof=[appsecret_proof]
```

في حالة معرّف مستخدم لأحد التطبيقات، استرداد معرّفات التطبيقات الأخرى المملوكة لنفس النشاط التجاري

عقدة المستخدم: عدة المستخدم عبارة عن معرّف على مستوى التطبيق.
عنصر الربط:ids_for_apps
المتطلبات: يتطلب ذلك رمز وصول إلى التطبيق، والذي يتم إنشاؤه باستخدام التطبيق الذي تم إنشاء المعرّف على مستواه. بالإضافة إلى ذلك، يجب أن يكون التطبيق مملوكًا لنفس النشاط التجاري.

أمثلة:

يعرض ذلك معرّفات كل التطبيقات المملوكة لنفس النشاط التجاري
```
GET /{user-id}/ids_for_apps
    ?access_token=[app_access_token]
```
يعرض ذلك معرّف التطبيق المحدد الذي يحمل معرّف التطبيق 10152368852405295
```
GET /{user-id}/ids_for_apps
    ?app=10152368852405295
    &access_token=[app_access_token]
```

في حالة معرّف مستخدم لأحد الصفحات (المرتبطة ببرنامج تلقائي)، استرداد معرّفات الصفحات الأخرى المملوكة لنفس النشاط التجاري

عقدة المستخدم: معرّف على مستوى الصفحة المرتبطة بالبرنامج التلقائي في Messenger.
عنصر الربط:ids_for_pages
المتطلبات: يتطلب ذلك رمز وصول للصفحة وappsecret_proof، ويجب إنشاء كلاهما باستخدام التطبيق الذي يدير الصفحة. بالإضافة إلى ذلك، يجب أن تكون الصفحة مملوكة لنفس النشاط التجاري.

أمثلة:

يعرض ذلك معرّفات كل الصفحات المملوكة لنفس النشاط التجاري

GET /{user-id}/ids_for_pages
    ?access_token=[page_access_token]
    &appsecret_proof=[appsecret_proof]

يعرض ذلك معرّف الصفحة المحددة التي تحمل معرّف التطبيق 380374449010653

GET /{user-id}/ids_for_pages
    ?app=380374449010653
    &access_token=[page_access_token]
    &appsecret_proof=[appsecret_proof]

أمثلة للاستعلامات

استرداد المعرّفات المرتبطة من معرّف لتطبيق

GET /{user-id}
    ?fields=name,age_range,ids_for_apps,ids_for_pages
    &access_token=[app_access_token]

نموذج للاستجابة:

{
  "name": "John Smith",
  "age_range": {
    "min": 21
  },
  "ids_for_apps": {
    "data": [
      {
        "id": "10152368852405295",
        "app": {
          "category": "Business",
          "link": "https://www.facebook.com/games/?app_id=1419232575008550",
          "name": "John's Game App",
          "id": "1419232575008550"
        }
      },
      {
        "id": "645195294",
        "app": {
          "link": "https://apps.facebook.com/johnsmovieappns/",
          "name": "JohnsMovieApp",
          "namespace": "johnsmovieappns",
          "id": "259773517400382"
        }
      }
    ],
    "paging": ...
  },
  "ids_for_pages": {
    "data": [
      {
        "id": "12345123", // The psid for the user for that page
        "page": {
          "category": "Musician",
          "link": "https://www.facebook.com/Johns-Next-Great-Thing-380374449010653/",
          "name": "John's Next Great Thing",
          "id": "380374449010653"
        }
      }
    ],
    "paging": ...
  },
  "id": "645195294"
}

استرداد المعرّفات المرتبطة من معرّف لبرنامج تلقائي في Messenger

GET /{user-id}
    ?fields=name,is_payment_enabled,ids_for_apps,ids_for_pages
    &access_token=[page_access_token]
    &appsecret_proof=[appsecrete_proof]

نموذج للاستجابة:

{
  "name": "John Smith",
  "is_payment_enabled": true,
  "ids_for_apps": {
    "data": [
      {
        "id": "10152368852405295",
        "app": {
          "category": "Business",
          "link": "https://www.facebook.com/games/?app_id=1419232575008550",
          "name": "John's Game App",
          "id": "1419232575008550"
        }
      },
      {
        "id": "645195294",
        "app": {
          "link": "https://apps.facebook.com/johnsmovieappns/",
          "name": "JohnsMovieApp",
          "namespace": "johnsmovieappns",
          "id": "259773517400382"
        }
      }
    ],
    "paging": ...
  },
  "ids_for_pages": {
    "data": [
      {
        "id": "12345123", // The psid for the user for that page
        "page": {
          "category": "Musician",
          "link": "https://www.facebook.com/Johns-Next-Great-Thing-380374449010653/",
          "name": "John's Next Great Thing",
          "id": "380374449010653"
        }
      }
    ],
    "paging": ...
  },
  "id": "645195294"
}

السياسة

يمكن استخدام واجهة API فقط بواسطة الأنشطة التجارية من أجل ربط معرفات تطبيق أو صفحة ذلك النشاط التجاري بتطبيق أو صفحة أخرى مملوكة لنفس النشاط التجاري ويتم الاحتفاظ بها بالنيابة عنه. على سبيل المثال، لا يجوز لموفري الخدمات استخدام واجهة API دعم عملاء متعددين.

وتحسبًا لأي انتهاكات محتملة لهذه السياسة، سوف تخضع طلبات واجهة API للمراجعة وتعرض رسالة خطأ "(#200) يخضع نشاطك التجاري في الوقت الحالي لعملية المراجعة ليتمكن من الوصول إلى واجه API هذه".