تكامل Activepieces

استخدم مساعد Asyntai داخل مسارات Activepieces

يتطلب خطة مدفوعة: يعمل تكامل Activepieces على خطط Starter وStandard وPro. عرض الأسعار

نظرة عامة

‏Activepieces أداة أتمتة مفتوحة المصدر. ترسل قطعة Asyntai رسالة العميل إلى مساعدك وتعيد الإجابة. بعد ذلك توجّه الإجابة إلى أي مكان في المسار: رد بالبريد الإلكتروني، رسالة على Slack، تذكرة دعم، أو صف في قاعدة بيانات.

الإجراءات المتاحة

توفر قطعة Asyntai إجراءين:

اسأل المساعد - يرسل رسالة العميل إلى مساعد واحد ويعيد الإجابة
استدعاء API مخصص - يستدعي أي نقطة نهاية في واجهة Asyntai بالاتصال نفسه

ملاحظة: تُثبَّت القطعة من npm. تحتاج إلى تثبيت Activepieces على خادمك، أو صلاحيات مدير المنصة في Activepieces Cloud.

كيفية التثبيت

اتبع هذه الخطوات لربط Asyntai بـ Activepieces:

الحصول على مفتاح API الخاص بك

افتح صفحة إعدادات API وأنشئ مفتاحًا:

https://asyntai.com/settings/api/

انسخ المفتاح واحفظه في مكان آمن. أي شخص يملك المفتاح يصل إلى حسابك في Asyntai عبر الواجهة البرمجية.

ثبّت قطعة Asyntai

في Activepieces اذهب إلى Settings ثم My Pieces ثم Install Piece. اكتب اسم الحزمة هذا:

@asyntai/piece-asyntai

اربط حسابك

أضف خطوة Asyntai إلى المسار. أنشئ اتصالًا جديدًا والصق مفتاح API. يتحقق Activepieces من المفتاح فورًا ويعرض خطأ إن كان غير صحيح.

ابنِ المسار

يتكوّن المسار من جزأين:

المُشغِّل: أي مُشغِّل في Activepieces، مثل بريد جديد أو إدخال نموذج أو webhook
الإجراء: Asyntai - اسأل المساعد

مرّر من المُشغِّل إلى إجراء Asyntai رسالة العميل ومعرّف محادثة ثابتًا.

أعد إرسال الإجابة

أضف خطوة أخرى لتسليم الإجابة: Gmail أو Slack أو نظام دعم أو خدمة رسائل نصية. استخدم الحقل answer من خطوة Asyntai كنص الرد.

اختبر وانشر

نفّذ اختبارًا بسؤال حقيقي من عميل. راجع الإجابة ثم انشر المسار.

مدخلات إجراء اسأل المساعد

Assistant Website (مطلوب) - المساعد الذي يجيب. تُحمَّل القائمة من حسابك.
Customer Message (مطلوب) - النص الذي يجب أن يجيب عنه المساعد.
Conversation ID (مطلوب) - قيمة ثابتة لهذا العميل أو الموضوع، مثل عنوان بريد أو رقم تذكرة.
Source Channel (مطلوب) - من أين وصلت الرسالة. قنوات البريد تضيف تعليمات البريد إلى المساعد.

مخرجات إجراء اسأل المساعد

answer - إجابة المساعد.
conversation_id - الموضوع الذي تنتمي إليه الإجابة.
ai_disclosure - نص الإفصاح عن الذكاء الاصطناعي. اعرضه على العميل.
success - هل نجح الاستدعاء.

نصيحة: حسّن الإجابات بإضافة تعليمات وأسئلة شائعة ومحتوى قاعدة معرفة في لوحة تحكم Asyntai.

سجل المحادثات

يحفظ Asyntai السجل تحت معرّف المحادثة الذي ترسله. استخدم القيمة نفسها للعميل نفسه فيتذكر المساعد الرسائل السابقة. القيمة الجديدة تبدأ موضوعًا جديدًا.

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

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

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

الشفرة المصدرية

القطعة مفتوحة المصدر برخصة MIT. اسم الحزمة على npm هو: