شغّل Chatwoot Captain على نقطة نهاية مخصصة متوافقة مع OpenAI.

إجابة سريعة: ثلاثة إعدادات Captain في Super Admin.

في Chatwoot ذاتي الاستضافة الحالي، إعدادات LLM الخاصة بـ Captain هي إعدادات تنصيب، لا متغيّرات .env؛ ملف .env.example المُشحَّن ينص على ذلك صراحة ويُوجِّهك إلى Super Admin، App Configs، Captain. ثلاث قيم تهم: CAPTAIN_OPEN_AI_API_KEY يأخذ مفتاح البوابة، CAPTAIN_OPEN_AI_MODEL يأخذ معرّف النموذج، وCAPTAIN_OPEN_AI_ENDPOINT يأخذ مضيف نقطة النهاية. لقيمة نقطة النهاية حافة حادة واحدة: أعطها بدون لاحقة /v1. مُهيِّئ Chatwoot يبني قاعدة API بنفسه بقص شرطة مائلة زائدة وإلحاق /v1، ووصف الإعداد نفسه يُظهِر الافتراضي كـ https://api.openai.com/ بنفس هذا الشكل. لـ APIsRouter، أدخل https://api.apisrouter.com ودع Chatwoot يشتق https://api.apisrouter.com/v1. تُقرَأ هذه الإعدادات عند إقلاع التطبيق، لذا أعد تشغيل Chatwoot بعد تغييرها.

CAPTAIN_OPEN_AI_API_KEY:  sk-YOUR-APISROUTER-KEY
CAPTAIN_OPEN_AI_MODEL:    claude-haiku-4-5-20251001
CAPTAIN_OPEN_AI_ENDPOINT: https://api.apisrouter.com
                          (no /v1 -- Chatwoot appends it)

then restart the Chatwoot processes

ما الذي يفعله Captain بالنموذج المُعَدّ.

Chatwoot (بنحو 34 ألف نجمة على GitHub) هو منصة دعم العملاء الرائدة مفتوحة المصدر، وCaptain هو طبقة الذكاء الاصطناعي الخاصة به: وكيل ذكاء اصطناعي يُجيب على محادثات العملاء من مقالات مركز المساعدة والأسئلة الشائعة لديك، ومساعد يصيغ الردود ويُلخِّص المحادثات لوكلاء بشريين، وميزات معرفة مُؤسَّسة على المستندات خلف كليهما. على النُّسَخ ذاتية الاستضافة حيث يتوفر Captain، يعمل كل ذلك عبر النموذج المُعَدّ أعلاه. تحت الغطاء، يُهيِّئ Chatwoot SDK الوكلاء الخاص به مرة واحدة عند الإقلاع: المفتاح، قاعدة API المُشتقَّة، والنموذج الافتراضي. كل ميزة من ميزات Captain تتحدث حينها chat completions قياسية إلى ذلك base URL، ويسافر معرّف النموذج كسلسلة عادية. يحتفظ Chatwoot بخريطة لبادئات أسماء النماذج (claude-، gemini-، deepseek-) لكنه يستخدمها لوسم القياس عن بُعد، لا للتوجيه، لذا معرّف Claude أو DeepSeek مضبوط كـ CAPTAIN_OPEN_AI_MODEL لا يزال يذهب إلى نقطة نهايتك المُعَدَّة مثل أي سلسلة أخرى. حركة الدعم لها ملف تكلفة مميز: محادثات كثيرة، جولات قصيرة، وإجابات مُسنَدة مُجمَّعة من المقالات المُسترجَعة. هذا يجعل التكلفة لكل محادثة الرقم المهم، ويُهيمن عليها tokens المدخل من السياق المُسترجَع. معرّف سريع يُدير طبقة الوكيل جيداً، مع تصعيد إلى معرّف أقوى بتغيير إعداد واحد عندما تريد أن يكتب المساعد مسودات أفضل.

الإعداد الكامل وتفصيلة وقت الإقلاع.

افتح وحدة تحكم Super Admin على نسختك، اذهب إلى App Configs واختر Captain، ثم املأ القيم الثلاث. إذا كانت نسخة Chatwoot لديك تسبق إعداد نقطة النهاية (وصل في حقبة v4.4 في منتصف 2025)، حدّثها أولاً؛ في النسخ الأقدم كان يوجد فقط المفتاح والنموذج مع نقطة نهاية مُثبَّتة في الكود. بما أن المُهيِّئ يقرأ هذه الإعدادات أثناء إقلاع التطبيق، تسري التغييرات بعد إعادة تشغيل عمليات الويب والعامل. هذا يعني أيضاً أن قيمة خاطئة لا تفشل عند وقت الحفظ؛ بل تفشل عند أول طلب لـ Captain بعد إعادة التشغيل، وهذا يستحق معرفته قبل التصحيح في المكان الخاطئ. لدى Captain أيضاً جانب تضمين: CAPTAIN_EMBEDDING_MODEL (الافتراضي text-embedding-3-small) يُشغِّل بحث المستندات فوق محتوى مركز المساعدة لديك، ويُحَل مقابل نفس نقطة النهاية المُعَدَّة. إذا أعدت توجيه نقطة النهاية إلى بوابة، تأكّد من أن معرّف التضمين الذي تُعِدّه هو معرّف تخدمه نقطة النهاية فعلياً؛ وإلا اترك ميزات المستندات على إعدادها الحالي وتحقّق منها بشكل منفصل بعد التبديل.

# Chatwoot will call <endpoint>/v1/chat/completions
curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-4-5-20251001",
       "messages":[{"role":"user","content":"ping"}]}'

اختيار نموذج لأتمتة الدعم.

حلقة التقييم التي تعمل: شغّل أسبوعاً على معرّف سريع، صدّر أرقام الاستخدام، ثم شغّل الفرق كثيفة المساعد على معرّف أقوى وقارن قبول المسودة لا الإحساس العام. كلا المرشّحين يُفوتَران عبر نفس المفتاح، لذا تصل المقارنة مُسعَّرة.

• طبقة وكيل الذكاء الاصطناعي هي عمل حجمي: إجابات مُسنَدة فوق مقالات مُسترجَعة، آلاف المحادثات شهرياً. claude-haiku-4-5-20251001 وgpt-5.4-mini وgemini-3.5-flash تُبقي التكلفة لكل محادثة ثابتة دون فقدان انضباط الإسناد.
• طبقة المساعد تقرأ محادثات كاملة وتصيغ ردوداً للبشر، حيث تظهر النبرة والحكم. claude-sonnet-4-6 هو الخطوة الطبيعية للأعلى عندما تُحرِّك جودة المسودة إنتاجية الوكيل.
• مكاتب الدعم متعددة اللغات يجب أن تختبر deepseek-v4-pro وgemini-3.5-flash على مزيج لغاتها الحقيقي؛ جودة الإجابة المُسنَدة تتفاوت عبر اللغات أكثر مما توحي معايير الإنجليزية.
• التكلفة لكل محادثة قابلة للقياس، لا نظرية: tokens لكل محادثة ضرب المحادثات شهرياً، مباشرة من سجل الاستخدام.
• نموذج واحد يخدم كل ميزات Captain لكل تنصيب، لذا اختر بحسب عبء عملك المهيمن وأعد النظر بعد قراءة أسبوع من الاستخدام الحقيقي.

ادفع حسب الاستخدام · أقل من السعر الرسمي

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

أنماط الفشل الخاصة بـ Chatwoot Captain.

اللاحقة المزدوجة /v1 هي الكلاسيكية. بما أن Chatwoot يُلحِق /v1 بأياً كان ما تُدخِله، لصق https://api.apisrouter.com/v1 يُنتِج طلبات مقابل /v1/v1/chat/completions، التي تُرجِع 404 عند البوابة. أدخل المضيف بدون /v1. تغييرات الإعداد التي تبدو مُتجاهَلة هي قاعدة إعادة التشغيل. يُهيَّأ SDK الوكلاء مرة واحدة عند الإقلاع من إعدادات التنصيب؛ تعديلها في Super Admin دون إعادة تشغيل يترك القيم القديمة حيّة في كل عملية قيد التشغيل. الأدلة القديمة تُشير إلى السطح الخاطئ. الدروس من نسخ Chatwoot الأقدم تُهيِّئ OPENAI_API_KEY عبر متغيّرات بيئة أو تكامل OpenAI القديم؛ على النسخ الحالية، إعدادات Captain في Super Admin هي السطح، وينص .env.example على ذلك بالحرف. model-not-found في أول رد لـ Captain بعد تبديل هو خطأ إملائي في CAPTAIN_OPEN_AI_MODEL؛ سرد /v1/models الخاص بالبوابة هو الإملاء الموثوق. أخطاء المصادقة تعني أن المفتاح وإعدادات نقطة النهاية لا ينتميان معاً. وإذا تدهور بحث المقالات أو الإسناد بالمستندات بينما تعمل الدردشة بشكل جيد، انظر إلى إعداد التضمين، وهو نموذج منفصل يُحَل مقابل نفس نقطة النهاية.

من يوجّه Chatwoot Captain عبر بوابة.

• فرق الدعم ذاتية الاستضافة التي تريد صياغة بجودة Claude في المساعد دون حساب بائع منفصل وعلاقة فوترة.
• المكاتب عالية الحجم حيث يُجيب وكيل الذكاء الاصطناعي على معظم المحادثات، والتكلفة لكل محادثة تقرر ما إذا كانت الأتمتة تُسدِّد نفسها؛ معرّفات الكتالوج السريعة تُبقي ذلك الرقم صادقاً.
• الفرق التي تُشغِّل Chatwoot واحداً لكل علامة تجارية أو منطقة، تقيس كل تنصيب بمفتاحه الخاص حتى تُبلِّغ تكلفة ذكاء الدعم عن نفسها لكل علامة.
• المُشغِّلون الذين يقارنون نماذج الدعم على حركة حقيقية: كل مرشّح قيمة إعداد واحدة وإعادة تشغيل، لا ترحيل.
• المطورون الذين لا يملكون وصولاً إلى فوترة بائع معيّن. الوصول القائم على تعبئة الرصيد بدون شرط بطاقة يزيل الاعتماد على التسجيل لكل مزوّد.

تحقق من نقطة النهاية وصحّح أخطاء أول محادثة.

تحقّق خارج Chatwoot أولاً: اسرد النماذج بمفتاحك وشغّل إكمال محادثة واحداً مقابل المعرّف الدقيق الذي ضبطته في CAPTAIN_OPEN_AI_MODEL. إذا نجح ذلك، ثبت نصف البوابة وكل شيء آخر من جانب Chatwoot. ثم أعد التشغيل وراقب أول تفاعل لـ Captain. أخطاء المصادقة تشير إلى إعداد المفتاح؛ model-not-found يشير إلى إعداد النموذج؛ الأخطاء بشكل 404 تشير إلى /v1 مُلصَق في إعداد نقطة النهاية. إذا لم تظهر ميزات Captain على الإطلاق، فهذا توفّر وترخيص على مستوى نسختك، لا إعداد نقطة النهاية. بمجرد تدفّق المحادثات، تعرض لوحة APIsRouter النموذج لكل طلب، وعدد tokens، والإنفاق. ذكاء الدعم بند ميزانية يتراكم شهرياً، ومفتاح واحد لكل تنصيب يُحوِّل سجل الاستخدام إلى تقرير التكلفة لكل مكتب الذي يستمر فريق المالية بطلبه.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50

الأسئلة الشائعة