قم بإعداد أدوات مخصصة للكابتن

اكتشف

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

الخطة والوصول: للأعمال أو المؤسسات (الأسعار والخطط). في خطة الشركات الناشئة، يظهر عادة زر ترقية لاستخدام الأدوات مع Captain في الأدوات. كل مساعد لديه قائمة أدوات خاصة به. يقوم المسؤولون بإنشاء الأدوات، ولا يمكن إلا للمسؤولين رؤية بيانات الاعتماد المحفوظة. في الاستضافة الذاتية: يقوم الـ Super Admin بتفعيل الأدوات المخصصة للحساب.

الإعداد والتجربة

قبل البدء

• نقطة نهاية HTTPS على اسم مضيف عام. يقوم Chatwoot بحظر HTTP العادي، عناوين IP، localhost، الشبكات الخاصة وعناوين .local.

• يجب أن تقبل نقطة النهاية الاتصال خلال ثانيتين وأن ترد خلال 20 ثانية، برد لا يتجاوز 1 ميجابايت.

• بيانات الاعتماد الخاصة بها، إذا كانت بحاجة إليها.

إنشاء أداة

1. اذهب إلى Captain > الأدوات واضغط على إنشاء أداة جديدة. استخدم أولاً مفتاح المساعد في الأعلى لاختيار المساعد الذي ستستخدم الأداة معه. يفتح النموذج في لوحة جانبية.

   

2. املأ:

   • اسم الأداة: قصير، مثلاً "الاستعلام عن الطلب" (55 حرفًا أو أقل).

   • الوصف: متى يجب أن يستخدمها المساعد، مكتوب كتعليمات لموظف جديد. هذا يحدد ما إذا كان المساعد سيختار الأداة.

   • الطريقة: GET لقراءة البيانات؛ POST أو PUT أو PATCH لإرسال أو تعديل البيانات؛ DELETE لحذف شيء ما.

   • عنوان نقطة النهاية (Endpoint URL): استخدم {{ parameter_name }} للقيم التي يملؤها المساعد، مثل https://api.example.com/orders/``{{ order_id }}.

   • نوع المصادقة: بدون، Bearer Token، Basic Auth، أو API Key (مع اسم الترويسة وقيمة الترويسة). استخدم هذا لبيانات الاعتماد.

   • الترويسات (Headers): اضغط على إضافة ترويسة لإضافة رؤوس ثابتة يحتاجها الـ API الخاص بك في كل اتصال، مثل إصدار الـ API أو معرف المستأجر (حتى 16 ترويسة). تُرسل القيم كما كُتبت بالضبط. يقوم Chatwoot بتعيين Authorization وHost وContent-Length وContent-Type وأي ترويسة تبدأ بـ X-Chatwoot بنفسه، لذلك لا يمكنك إضافتها.

   • المعلمات (Parameters): اضغط على إضافة معلمة لكل قيمة يجب على المساعد الحصول عليها من العميل. قدم اسمًا ونوعًا ووصفًا، وضع علامة مطلوب إذا كان ذلك ضروريًا.

   • نموذج جسم الطلب (اختياري): لعمليات POST، PUT أو PATCH. هذا ونموذج الاستجابة موجودان ضمن النماذج. نموذج الطلب هو جسم JSON. يدعم Liquid، مثل {{ order_id }} للمعامل.

   • نموذج الاستجابة (اختياري): اختر الحقول التي يحتاجها المساعد، مثلاً حالة الطلب {{ response.order_id }}: {{ response.status }}. أقرأ رد الـ API عبر response، مثل {{ response.status }}. اترك النموذج فارغًا لإرسال JSON الخام إلى Captain.

     

   

3. اضغط على اختبار الاتصال، ثم إنشاء.

   

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

جربها

اطرح سؤالًا في الملعب يحتاج الأداة، مثل "أين الطلب 1234؟". تحقق أن الرد يستخدم بيانات حقيقية.

تحقيق القيمة

• تعمل الأدوات المخصصة بشكل أفضل مع عمليات الاستعلام ذات المدخلات الواضحة، مثل حالة طلب، حجز أو سجل عبر المعرف.

• يمكن لكل مساعد أن يملك ما يصل إلى 50 أداة. مع ذلك، ابقِ القائمة قصيرة: مع كثرة الأدوات من المرجح أن يختار المساعد أداة غير صحيحة.

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

• تدير عدة مساعدين؟ أعطِ كل واحد فقط الأدوات التي يحتاجها.

• أوقف الأداة عن طريق مفتاح التبديل بدل حذفها. إذا كان هناك سيناريو يستخدمها، سيحذرك Chatwoot أولاً. راجع تعيين خطوط الحماية والإرشادات والسيناريوهات لـ Captain.

• يرسل Chatwoot ترويسات في كل اتصال حتى يعرف نظامك الحساب، المحادثة، البريد الإلكتروني ورقم هاتف جهة الاتصال، اسم المساعد، وما إذا كان الاتصال معتمدًا. بالنسبة للبيانات الخاصة، تحقق من ترويسة X-Chatwoot-Contact-Inbox-Verified قبل الرد. بدون التحقق من الهوية، يمكن لأي زائر إدخال أي بريد إلكتروني في الأداة. الأدوات التي ترجع بيانات عامة فقط لا تحتاج لهذا التحقق. راجع كيف تفعل التحقق من الهوية في Chatwoot؟.

• إذا كانت واجهة برمجة التطبيقات لديك ترجع نصوصًا كتبها العملاء، أرجع فقط الحقول المهيكلة التي تحتاجها. يقرأ Captain الرد كما هو، لذلك قد يحتوي النص الحر على تعليمات قد يتبعها.

استكشاف الأخطاء

مزيد من الأسباب: استكشاف أخطاء Captain.