البرامج التلقائية في Workplace

نظرة عامة

باستخدام عمليات الدمج المخصصة لمنصة Workplace، يمكن الآن إنشاء برامج تلقائية قوية يمكنها التفاعل مع الأشخاص في المجموعات والدردشة.

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

البرامج التلقائية كصفحات

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

تكون صفحات البرنامج التلقائي عامة على مستوى الشركة، لذا يمكن لأي عضو في مجتمع Workplace رؤية البرنامج التلقائي والإشارة إليه ومراسلته. ولكن، بناءً على مستوى الإذن، الذي تختاره عند إنشاء البرنامج التلقائي، قد لا يتمكن البرنامج التلقائي من عرض كل المحتوى في Workplace أو التفاعل معه.

على سبيل المثال، إذا كان يتوفر لدى برنامجك التلقائي إذن قراءة محتوى المجموعة، فسيتمكن من عرض المحتوى في المجموعات. وإذا لم يتوفر لدى برنامجك التلقائي إذن النشر في المجموعات، فلن يتمكن من الرد على المحتوى في أي مجموعة.

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

البرامج التلقائية في المجموعات

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

يمكن أيضًا للبرامج التلقائية @ذكر الأشخاص لجذب انتباههم، كما يمكن أن يتم @ذكر البرامج التلقائية لبدء تدفق عمل محدد أو طرح سؤال.

وأخيرًا، يمكن للبرامج التلقائية الاشتراك في مجموعة و@ذكر webhooks التي توفر القدرة على مراقبة المحتوى والتفاعل مع المستخدمين بطرق مرنة.

البرامج التلقائية في الدردشة

في حين أنه في المجموعات، يمكن للبرامج التلقائية استخلاص المعلومات ومشاركتها عبر مجموعة من الأشخاص بشكل غير متزامن، تمثل البرامج التلقائية في الدردشة أفضل خيار للتفاعل مع أي شخص أو مجموعة محددة من الأشخاص.

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

يعتمد نموذج التفاعل هذا على المفاهيم ذاتها المستخدمة بواسطة منصة Messenger. ونتيجةً لذلك، يمكن للبرامج التلقائية في work chat استخدام ميزات، مثل القوائم الثابتة والردود السريعة والقوالب لإثراء تجربة المستخدم.

دردشة البرنامج التلقائي مع المستخدم

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

برنامج تلقائي يظهر في عنوان دردشة جديدة

يتيح الإذن مراسلة أي عضو عرض برنامجك التلقائي ضمن رأس الرسالة في مواضع دردشة Workplace chat.

برنامج تلقائي يظهر في عنوان دردشة جديدة

وبالاشتراك في webhooks لرسالة الصفحة، سيتم إرسال إشعار إلى برنامجك التلقائي أيضًا عند مراسلة المستخدم لبرنامجك التلقائي ويمكنك إنشاء دفق محادثة عن طريق الجمع بين الإرسال والاستلام.

محادثة البرنامج التلقائي مع المستخدم

دردشة البرنامج التلقائي مع المجموعة

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

سلسلة رسائل تحمل اسمًا وتتضمن أشخاصًا محددين تم إنشاؤها بواسطة برنامج تلقائي.

من خلال تمكين دعم الدردشة الجماعية، سيظهر برنامجك التلقائي في رؤس الدردشة إضافة أشخاص في سلسلة الدردشة الجماعية الحالية. ومن ثم سيتلقى أحداث webhooks لكل رسالة تم إرسالها بواسطة الأشخاص في تلك السلسلة ويمكنه الرد على تلك السلسلة باستخدام thread ID.

إضافة برنامج تلقائي إلى أي دردشة جماعية، ثم @ذكر البرنامج التلقائي

إنشاء سلاسل رسائل جديدة تمت تسميتها

لإنشاء سلسلة رسائل جديدة تتضمن مستلمين محددين، قم بإجراء الطلب POST لنقطة النهاية /me/messages مع تحديد مصفوفة من recipient IDs وحمولة بيانات message أولية كما يلي:

POST /me/messages
{
  "recipient": {
    "ids": [<user_ids>]
  },
  "message": <message_payload>
}

ستسترد حمولة استجابة تتضمن thread ID، بحيث يمكنك استخدامها لرسائل المتابعة.

إذا كنت تستخدم نقطة النهاية ذاتها مع قائمة المستلمين نفسها مجددًا، فسيتم إنشاء سلسلة جديدة. لإرسال رسائل المتابعة إلى سلسلة رسائل تم إنشاؤها بالفعل، قم بإجراء طلب POST لنقطة النهاية /me/messages باستخدام thread_id في حمولة البيانات recipient، كما يلي:

POST /me/messages
{
  "recipient": {
    "thread_key": <thread_id>
  },
  "message": <message_payload>
}

لإعادة تسمية سلسلة رسائل تم إنشاؤها بواسطة برنامجك التلقائي، قم بإجراء الطلب POST إلى عنصر الربط /{thread}/threadname، كما يلي:

POST /t_<thread_id>/threadname
{
  "name": "new name"
}

لاحظ ضرورة أن يكون thread_id مسبوقًا بـ "t_" في مسار عنصر الربط.

يمكنك أيضًا إضافة المشاركين وإزالتهم من سلاسل الرسائل عن طريق إجراء طلبات POST أو DELETE في عنصر الربط /{thread}/participants، كما يلي:

POST t_<thread_id>/participants
{
  "to": [<user_ids>]
}

DELETE t_<thread_id>/participants
{
  "to": [<user_ids>]
}

الذكر في سلسلة الرسائل

عندما يتم ذكر البرنامج التلقائي في رسالة، ترسل أحداث webhooks قائمة بالأعضاء الذين تمت الإشارة إليهم في هذه الرسالة، كما هو الحال في حمولة البيانات التالية:

{
    "object":"page",
    "entry":[{
        "id":"746230239054322",
        "time":1539281406974,
        "messaging":[{
            ...
            "message":{
                "mid":"<message id>",
                "seq":2192,
                "text":"@Edu Gomes @Example Bot What's 2+2?"
            },
            "mentions":[{
                "offset":0,
                "length":10,
                "id":"100017376437045"
            },
            {
                "offset":11,
                "length":12,
                "id":"746230239054322"
            }]
        }]
    }]
} 

شركاء منصة البرنامج التلقائي

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

أفضل الممارسات

استخدام القناة الصحيحة

عندما تقرر ما إذا كنت تريد إنشاء تفاعلات جماعية أو تفاعلات دردشة لبرنامجك التلقائي، يجدر التفكير في المكان الذي سيكون فيه البرنامج التلقائي مفيدًا بشكل أكبر.

• إذا كنت تحاول إنشاء برنامج تلقائي قد يتفاعل معه الكثير من الأشخاص في مرة واحدة أو برنامج تلقائي ينشر محتوى يمكن للكثير من الأشخاص رؤيته، فمن المنطقي إنشاء برنامج تلقائي يمكنه النشر في مجموعات والرد على التعليقات والذكر ضمن المنشورات في مجموعات.
• إذا كنت تحاول إنشاء برنامج تلقائي يحتاج إلى تنبيه الشخص بشيء ما على الفور أو شيء ما قد يتطلب متابعة سريعة أو شيء ما يجب أن يتفاعل معه الأشخاص في محادثات خاصة، فيجب أن تدعم المحادثات في Work Chat لبرنامجك التلقائي.

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

إضافة رابط لموضع البرامج التلقائية

استخدم تنسيق الرابط https://w.m.me/{page-id} لإنشاء رابط مباشر لبرنامج دردشة تلقائي في Workplace. يتوفر الدعم حاليًا في Workplace Chat عند استخدام الويب أو نظامي Android وiOS. ويتم فتح الرابط مباشرةً في التطبيق، بالنسبة لمنصات الهواتف المحمولة حيث يتم تثبيت تطبيق Workplace Chat.

معلمات الإحالة

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

لاستخدام الميزة، استخدم تنسيق الرابط https://w.m.me/{page-id}?ref={referral_parameter}. ويتم تنفيذ هذه الميزة بالطريقة ذاتها مثل منصة Messenger. يُرجى مراجعة وثائق Messenger لمزيد من التفاصيل.

حقل webhook ذو الصلة هو messaging_referrals ويتطلب اشتراكًا جديدًا. علمًا بأن حقل webhook هذا لم يكن متوفرًا لتطبيقات Workplace في السابق، ولكن ستتمكن الآن من الاشتراك بالطريقة المعتادة.

تكون حمولة بيانات webhook بالتنسيق ذاته مثل Messenger، مع وجود اختلافات مألوفة: حيث تستخدم منصة Workplace معرفات على مستوى التطبيق، وليس معرفات على مستوى الصفحة. وعلاوة على ذلك، توفر Workplace أيضًا حقل مجتمع في webhook، يتضمن معرف المجتمع.

تفاعلات المجموعة

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

بعد ذلك، إذا كنت توفر معلومات بعد أن تم ذكرك في تعليق، فأضف ردًا في سلسلة الرسائل للحفاظ على تدفق بقية المحادثة الجماعية.

إذا احتاج البرنامج التلقائي توفير معلومات للناشر الأصلي، فأضف تعليقًا على المنشور نفسه، حتى يتم إخطار الناشر أيضًا.

تفاعلات الدردشة

تدعم تفاعلات البرنامج التلقائي في Work Chat وظائف مماثلة لمنصة Messenger. وهذا يتضمن القوالب وأزرار الرد السريع التي تساعدك في تنفيذ أشجار القرارات في محادثات البرنامج التلقائي.

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