الويبهوك الوارد

تعد Webhooks ميزة قوية في NewAge Ai تتيح لك دمج منصتك الخاصة مع أتمتة الدردشة في NewAge Ai. وهذا مفيد إذا كان لديك منصة دردشة مباشرة خاصة بك وترغب في الاستفادة من ميزات الأتمتة في NewAge Aiدون توجيه المستخدمين إلى واجهة NewAge Ai .

من يجب أن يستخدم Webhooks؟

تم تصميم Webhooks للمطورين الذين لديهم منصتهم الخاصة وبعض الخبرة في العمل مع واجهات برمجة التطبيقات (APIs).

كيفية إعداد Webhooks في NewAge Ai

إليك دليل خطوة بخطوة حول كيفية إعداد webhooks في NewAge Ai:

1. قم بإعداد رابط Webhook الخاص بك:

• اذهب إلى قسم التكاملات ثم إلى Webhooks.
• يمكنك اختيار رؤوس رؤوسك الخاصة للحصول على أمان إضافي.
• وفر رابط Webhook حيث تريد استلام البيانات.

1. فعل Webhooks في إعدادات قناتك:

• اذهب إلى إعدادات القناة للدردشة التي تريد دمجها مع منصتك (مثل واتساب، الرسائل النصية النصية).
• في إعدادات الدردشة الحية، اختر Webhook.

1. استخدم إجراء إيقاف البوت:

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

الحمولة العينة

البيانات التي ترسلها NewAge Ai إلى رابط Webhook الخاص بك هي حمولة JSON تتضمن تفاصيل مختلفة عن الرسالة والمحادثة. إليك تفصيل الحمولة النموذجية في الصورة:

• ميتا

• user_ns: هذا معرف فريد للمستخدم.
• agent_id: هذا هو معرف الوكيل المعين حاليا للمحادثة (0 يشير إلى عدم وجود وكيل معين).
• flow_ns: هذا معرف فريد لتدفق الدردشة.
• team_id: هذا هو هوية الفريق الذي تنتمي إليه الدردشة.

• الرسالة

• _id: هذا معرف فريد للرسالة.
• mid: هذا معرف فريد للرسالة داخل القناة.
• النوع: يشير هذا إلى نوع الرسالة (مثلا، "in" للرسالة الواردة).
• msg_type: هذا يحدد نوع محتوى الرسالة (مثل "نص").
• sender_id: هذا هو معرف مرسل الرسالة.
• agent_id: هذا هو معرف الوكيل الذي استلم الرسالة (0 يشير إلى عدم وجود وكيل معين).
• assigned_agent_id: هذا هو معرف الوكيل المعين للمحادثة بعد استلام الرسالة.
• الحمولة
  • النص: يحتوي هذا على محتوى نص الرسالة.

• المحتوى: يحتوي هذا أيضا على محتوى نصي للرسالة.
• اسم المستخدم: هذا هو اسم المستخدم الخاص بمرسل الرسالة.
• التاريخ: يظهر هذا تاريخ إرسال الرسالة.
• الطابع الزمني: هذا هو الطابع الزمني للرسالة بمللي ثانية.
• TS: هذا تمثيل آخر للرسالة بطابع زمن.
• is_delivered: هذا يشير إلى ما إذا كانت الرسالة قد تم تسليمها (1 تعني التسليم).
• مشاهد: هذا الحقل فارغ في حمولة العينة لكنه يمكنه الإشارة إذا تم رصد الرسالة.

استخدام واجهة برمجة التطبيقات NewAge Ai

بمجرد التقاط رسالة المستخدم في منصتك، يمكنك استخدام واجهة برمجة التطبيقات NewAge Ai لإرسال رد للمستخدم داخل محادثة الدردشة. تستخدم واجهة برمجة التطبيقات NewAge Ai user_ns و flow_ns من الحمولة لتحديد المحادثة وإرسال الرسالة.

اعتبارات إضافية

• الويبهوك أداة قوية لكنها تتطلب خبرة تطوير.
• يدعم NewAge Ai أنواعا مختلفة من الرسائل، وسيعكس الحمولة نوع المحتوى (نص، صورة، إلخ).
• استفد من واجهة برمجة التطبيقات NewAge Ai للتواصل بين منصتك والمستخدمين NewAge Ai .

من خلال اتباع هذه الخطوات وفهم بيانات الحمولة، يمكنك إعداد webhooks بنجاح لدمج منصتك الخاصة مع ميزات الأتمتة في NewAge Ai.

فيديو تعليمي هنا: