 | بروتوكول التسليم |
يتيح بروتوكول التسليم لمنصة Messenger لتطبيقين أو أكثر المشاركة في محادثة من خلال تمرير التحكم في المحادثة بين هذه التطبيقات. يتم تمكين بروتوكول التسليم تلقائيًا للتطبيقات التي تم الاشتراك فيها بواسطة صفحة فيسبوك.
ملاحظة: يتوفر الآن توجيه المحادثات وسيستبدل بروتوكول التسليم قريبًا. يجب تحديث التطبيق لاستخدام توجيه المحادثات في أقرب وقت ممكن.
طريقة العمل
يمكن لصفحة فيسبوك أو حساب Instagram الاحترافي استخدام تطبيقات مراسلة متعددة للتواصل مع العملاء أو الأشخاص المهتمين بمحتواهم. على سبيل المثال، بالنسبة لدعم العملاء، فإنه يمكن إرسال العملاء إلى تجربة مؤتمتة، ولكن في حالة فشل التجربة المؤتمتة في حل مشكلة العميل، يمكن إرسال العميل إلى تطبيق آخر به وكلاء للدعم المباشر. لنقل المحادثة والبيانات الوصفية المتعلقة بالمحادثة، من تطبيق إلى آخر، أو بين تطبيق والبريد الوارد لصفحة فيسبوك أو البريد الوارد لحساب Instagram، يجب أن ينتقل التحكم في المحادثة من تطبيق إلى آخر. يتيح بروتوكول التسليم هذا التنقل.
افتراضيًا، عندما يرسل العميل رسالة لبدء محادثة، تكون المحادثة في وضع الخمول. ستتلقى التطبيقات إشعارًا، عبر أحداث Webhooks، بأنه قد تم استلام رسالة وفي انتظار رد. لتلقي هذا الإشعار، يجب أن يكون التطبيق مشتركًا في أحداث Webhooks المتعلقة بالتسليم.
يمكن لأي تطبيق التحكم في المحادثة عندما تكون المحادثة في وضع الخمول. التطبيق المتحكم في المحادثة يكون له القدرة الحصرية على الرد على الرسالة. يمكن لتطبيق واحد فقط التحكم في كل مرة، ولن تتمكن التطبيقات الأخرى من إرسال رسالة حتى يتخلى التطبيق المتحكم عن هذا التحكم. بمجرد أن يتخلى التطبيق عن التحكم، تعود المحادثة إلى وضع الخمول، وحينها يمكن للتطبيق التالي التحكم في المحادثة.
بالنسبة للتطبيق الذي يتحكم في المحادثة، سيتلقى التطبيق إشعارات من أحداث webhooks للمراسلة. وستتلقى جميع التطبيقات الأخرى إشعارات من أحداث Webhooks المتعلقة بالتسليم.
ستعود المحادثة تلقائيًا إلى وضع الخمول عندما لا تتلقى أي نشاط لمدة 24 ساعة. وقد يمد التطبيق المتحكم مدة التحكم لأكثر من 24 ساعة إذا لزم الأمر.
إذا حاول تطبيق لا يتحكم في المحادثة إرسال رسالة إلى شخص ما، فسيتم إرجاع الخطأ 400 بالرمز فرعي للخطأ 2018300.
المستلم الأساسي
إذا كنت تريد معالجة الرسائل من تطبيق محدد عند الاستلام، فيمكنك تعيين ذلك التطبيق باعتباره المستلم الأساسي. يتلقى المستلم الأساسي جميع الرسائل الجديدة للمحادثة، ويمكنه نقل التحكم إلى تطبيق آخر أو البريد الوارد لصفحة فيسبوك أو البريد الوارد لحساب Instagram، كما يمكنه التحكم في محادثة من تطبيق آخر، إذا لزم الأمر. عندما ينتهي تطبيق مستلم غير أساسي من المحادثة، ويتخلى عن التحكم، يتم تعيين المحادثة إلى وضع السكون.
إذا كانت المحادثة في وضع السكون وأرسل الشخص رسالة جديدة إلى صفحتك أو حسابك، فإن المستلم الأساسي يتحكم في المحادثة ويتلقى إشعار webhook حول الرسالة الجديدة.
ملاحظة: لا يلزم إعداد مستلم أساسي.
البريد الوارد
لا يمكن تعيين البريد الوارد لصفحة فيسبوك أو البريد الوارد لحساب Instagram باعتباره مستلم أساسي. ومع ذلك، إذا نقلت الرسالة إلى المجلد الرئيسي أو قمت بالرد على رسالة في محادثة لا يتحكم فيها البريد الوارد، فإن البريد الوارد سيتحكم في المحادثة. وإذا قمت بالرد على رسالة مميزة بحالة تم في البريد الوارد، فسيظل التحكم مع التطبيق المتحكم السابق، أي المتلقي الأساسي، إذا تم تعيينه، أو تحريره إلى وضع الخمول.
نقاط الدخول للمحادثة
يمكن تعيين محادثة إلى تطبيق محدد عند استخدام نقطة دخول للمحادثة تتعلق بالنقر لفتح محادثة في Messenger. ويمكن لنشاط تجاري استخدام النقر لفتح محادثة في Messenger لبدء محادثات مع العملاء من أجل تجميع بيانات العملاء المحتملين وزيادة الوعي بالعلامة التجارية، وغير ذلك.
القائمة الثابتة
يمكن لأي تطبيق تعيين القائمة على مستوى الصفحة ما لم يتم تعيين متلقِ أساسي. وإذا تم تعيين تطبيق أساسي، فسيكون التطبيق الأساسي هو التطبيق الوحيد القادر على تعيين قائمة على مستوى الصفحة أو حذفها.
يمكن للتطبيق الذي يتحكم في المحادثة تعيين قائمة على مستوى المستخدم أو حذفها حتى إذا لم يكن التطبيق هو المتلقي الأساسي، ويمكن لأي تطبيق تعيين قائمة على مستوى المستخدم عندما تكون المحادثة في وضع الخمول.
عندما يختار عميل عنصرًا من قائمة، فإن التطبيق الذي أنشأ تلك القائمة سيتحكم في المحادثة. يتم ذلك لأنه قد تم تكوين التطبيق الذي أنشأ القائمة للتعامل مع تلك البيانات.
زر الدعوة لاتخاذ إجراء للرد
عندما ينقر أحد العملاء على زر رد، فإن التطبيق الذي أنشأ ذلك الزر سيتحكم في المحادثة حتى إذا كان التحكم لتطبيق آخر. ويتم ذلك لأنه قد تم تكوين التطبيق الذي أنشأ زر الرد للتعامل مع تلك البيانات.
استبيانات العملاء
إذا تم إرسال استبيان بينما يتحكم تطبيق آخر في المحادثة، فلن يتم تسليم الاستبيان حتى يتخلى التطبيق عن هذا التحكم وتصبح المحادثة في وضع الخمول.
المكونات
فيما يلي المكونات المطلوبة للتنفيذ الناجح لبروتوكول التسليم الخاص بتطبيقات المراسلة التي اشتركت فيها صفحة فيسبوك الخاصة بك.
رموز الوصول
يلزم وجود رمز وصول الصفحة الذي يطلبه شخص يمكنه تنفيذ مهمة MODERATE على الصفحة من أجل استدعاء نقاط نهاية بروتوكول التسليم.
مراجعة التطبيقات
تلزم مراجعة التطبيقات للتطبيقات التي:
- يستخدمها أشخاص ليس لديهم دور في التطبيق
- تسمح لوكيل بشري بالرد على العملاء
ميزة الوكيل البشري
إذا تمت الموافقة على تطبيق من خلال مراجعة التطبيقات لاستخدام ميزة الوكيل البشري وتمت الإشارة إلى الرسالة بعلامة الوكيل البشري، فسيتمكن التطبيق من إرسال رسالة لشخص حتى إذا لم يكن التطبيق متحكمًا في المحادثة. هذا هو السيناريو الوحيد الذي يمكن فيه إرسال رسالة بواسطة تطبيق لا يتحكم في المحادثة.
الأذونات
يلزم وجود إذن pages_messaging للتطبيقات لطلب إذن العملاء للوصول إلى بيانات المراسلة.
Webhooks
في بروتوكول التسليم، توجد مجموعتان من أحداث Webhooks يجب أن يشترك فيهما التطبيق، وهما أحداث Webhooks للمراسلة وأحداث Webhooks في وضع الاستعداد. تعتمد الإشعارات التي يتلقاها التطبيق على التحكم في المحادثة. إذا كان أحد التطبيقات يتحكم في المحادثة، فسيتلقى ذلك التطبيق إشعارات أحداث Webhooks للمراسلة. وإذا كان التطبيق لا يتحكم في المحادثة، فسيتلقى ذلك التطبيق إشعارات Webhooks في وضع الاستعداد.
الاستخدامات الشائعة
دعم العملاء
يستخدم نشاط تجاري تطبيقًا واحدًا للتجارب المؤتمتة للأسئلة الشائعة ولكنه ينقل العميل إلى تطبيق آخر للدعم المباشر إذا لم تحل التجربة المؤتمتة مشكلة العميل. تم تعيين التطبيق المؤتمت على أنه المستلم الأساسي، لذلك ستكون جميع المحادثات مملوكة بواسطة التطبيق المؤتمت. عندما يحتاج وكيل دعم مباشر إلى الانضمام إلى المحادثة، يمكن لتطبيق الدعم المباشر طلب التحكم في المحادثة. بمجرد أن ينتهي تطبيق الوكيل المباشر من المحادثة، يتم التخلي عن التحكم في المحادثة مرة أخرى ليعود إلى تطبيق الأتمتة. إذا كان تطبيق الوكيل المباشر يحتاج إلى مزيد من الوقت للتعامل مع مشكلة العميل، يمكن للتطبيق طلب تمديد. يجب أن يشترك كلا التطبيقين في أحداث Webhooks لضمان تدفق المحادثة بشكل صحيح.
حملة تسويقية - العملاء المحتملين لمنتج ما
يدير نشاط تجاري حملة تسويقية ويستخدم تجربة مؤتمتة لتأهيل العملاء المحتملين أو تقديم توصيات المنتج بناءً على اختبار حول المنتج. بعد تأهيل العميل المحتمل، يستخدم النشاط التجاري البريد الوارد لصفحة فيسبوك أو البريد الوارد لحساب Instagram للمتابعة مع العملاء المحتملين. تم تعيين التطبيق المؤتمت على أنه المستلم الأساسي؛ لذلك ستكون جميع المحادثات مملوكة بواسطة التطبيق المؤتمت. وبمجرد أن ينتهي التطبيق المؤتمت من مرحلة تأهيل العميل المحتمل، يتم نقل التحكم في المحادثة إلى البريد الوارد لصفحة فيسبوك أو البريد الوارد لحساب Instagram. وبمجرد اكتمال المحادثة في البريد الوارد لصفحة فيسبوك أو البريد الوارد لحساب Instagram، ميّز المحادثة بحالة تم. سيؤدي هذا إلى إعادة التحكم في المحادثة إلى التطبيق الأساسي. يجب أن يشترك كلا التطبيقين في أحداث Webhooks لضمان تدفق المحادثة بشكل صحيح.
الحملة الإعلانية التسويقية - إعلانات النقر لفتح محادثة في Messenger 
يدير نشاط تجاري حملة تسويقية ويرسل العملاء المحتملين إلى تطبيق مؤتمت لعرض تجربة Messenger محددة. تم تعيين التطبيق المؤتمت على أنه المتلقي الأساسي، لذا فإن جميع المحادثات تحت تحكم ذلك التطبيق المؤتمت. عندما يحتاج وكيل دعم مباشر إلى الانضمام إلى المحادثة، يمكن لتطبيق الدعم المباشر طلب التحكم في المحادثة. بمجرد أن ينتهي تطبيق الوكيل المباشر من المحادثة، يتم التخلي عن التحكم في المحادثة مرة أخرى ليعود إلى تطبيق الأتمتة. إذا كان تطبيق الوكيل المباشر يحتاج إلى مزيد من الوقت للتعامل مع مشكلة العميل، يمكن للتطبيق طلب تمديد. يجب أن يشترك كلا التطبيقين في أحداث Webhooks لضمان تدفق المحادثة بشكل صحيح.
أفضل الممارسات
- نوصي بتعيين التجارب التلقائية كتطبيق مستلم أساسي وتعيين أي تطبيق وكيل مباشر ليكون التطبيق غير الأساسي. يوصى بأن يسجل تطبيق الوكيل المباشر أحداث الاستعداد وعدم اتخاذ أي إجراء إلا إذا لزم الأمر.
- استخدم API الحصول على التحكم في سلسلة الرسائل دائمًا للتحقق مما إذا كنت تتحكم في سلسلة الرسائل أم لا، ثم أرسل استدعاءات إلى واجهات API الأخرى استنادًا إلى السيناريو. لا تحاول إيقاف العملية أو مقاطعتها إذا لم تكن المتحكم.
- يُرجى التأكد من عدم محاولة إرسال رسائل إلى السلسلة الرسائل القائمة عندما يكون هناك تطبيق آخر يتحكم في المحادثة. إذا كنت تمثل تطبيقًا أساسيًا، فيُرجى استخدام API الحصول على التحكم في سلسلة الرسائل فقط إذا قررت أنك في حاجة إلى ذلك. في الحالات غير العاجلة أو إذا لم تكن تمثل تطبيقًا أساسيًا، فيُرجى طلب التحكم في سلسلة الرسائل.
- احرص على الالتزام بحدث طلب التحكم في سلسلة الرسائل من أي تطبيق آخر في كل الحالات الممكنة وتمرير التحكم في سلسلة الرسائل إلى التطبيق الذي قدم الطلب. إذا لم تستطع نقل التحكم في سلسلة الرسائل على الفور لأي سبب من الأسباب، فاستخدم API إرسال بيانات التعريف لإرسال سياق إضافي إلى التطبيق الذي قدم الطلب وأنشئ قائمة انتظار لنقل التحكم في السلسلة عند الانتهاء.
- إذا انتهيت من المحادثة، فيُرجى تمرير التحكم في سلسلة الرسائل إلى التطبيق الذي قدم طلب مسبقًا ولا يزال في قائمة الانتظار أو قم بتعيين التحكم في السلسلة إلى وضع السكون، حتى يتسنى لأي تطبيق آخر التحكم في السلسلة. سيؤدي عدم القيام بذلك إلى خروج التحكم في سلسلة الرسائل تلقائيًا من تطبيقك والانتقال إلى وضع السكون بعد 24 ساعة. يتغير رمز هذا السيناريو والحالة المرتبطة به وفقًا لذلك.
- إذا لاحظت أن السلسلة في وضع السكون عن طريق استدعاء API الحصول على التحكم في سلسلة الرسائل، فاستخدم طلب التحكم في السلسلة للتحكم في سلسلة الرسائل بحيث يمكنك إرسال رسائل للمستخدم بشكل حصري دون انقطاع وترك التحكم بمجرد الانتهاء.
معرفة المزيد
تعرف على المزيد حول مكونات بروتوكول التسليم.
الخطوات التالية
الآن بعد أن عرفت كيفية عمل بروتوكول التسليم، ستحتاج إلى ما يلي لتنفيذ البروتوكول: