Chatwoot Captain کو ایک custom OpenAI-compatible endpoint پر چلائیں۔

فوری جواب: Super Admin میں تین Captain configs۔

موجودہ self-hosted Chatwoot پر، Captain کی LLM settings installation configs ہیں، .env variables نہیں؛ shipped .env.example صراحتاً یہی کہتی ہے اور آپ کو Super Admin، App Configs، Captain کی طرف اشارہ کرتی ہے۔ تین values اہم ہیں: CAPTAIN_OPEN_AI_API_KEY gateway key لیتا ہے، CAPTAIN_OPEN_AI_MODEL model id لیتا ہے، اور CAPTAIN_OPEN_AI_ENDPOINT endpoint host لیتا ہے۔ endpoint value کا ایک نازک پہلو ہے: اسے /v1 suffix کے بغیر دیں۔ Chatwoot کا initializer API base خود بناتا ہے ایک trailing slash trim کر کے اور /v1 append کر کے، اور config کی اپنی description default کو بالکل اسی شکل میں https://api.openai.com/ دکھاتی ہے۔ APIsRouter کے لیے، https://api.apisrouter.com درج کریں اور Chatwoot کو https://api.apisrouter.com/v1 derive کرنے دیں۔ یہ configs app boot ہونے پر پڑھے جاتے ہیں، تو انہیں تبدیل کرنے کے بعد Chatwoot کو restart کریں۔

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 configured model کے ساتھ کیا کرتا ہے۔

Chatwoot (GitHub پر تقریباً 34K stars) leading open-source customer support platform ہے، اور Captain اس کی AI layer ہے: ایک AI agent جو آپ کے help-center articles اور FAQs سے customer conversations کا جواب دیتا ہے، ایک copilot جو human agents کے لیے replies drafts کرتا ہے اور threads summarize کرتا ہے، اور دونوں کے پیچھے document-grounded knowledge features۔ self-hosted installations پر جہاں Captain دستیاب ہے، یہ سب اوپر configured model کے ذریعے چلتا ہے۔ اندر ہی اندر، Chatwoot اپنا agents SDK صرف boot پر ایک بار configure کرتا ہے: key، derived API base، اور default model۔ ہر Captain feature پھر اس base URL سے standard chat completions بولتا ہے، اور model id ایک plain string کے طور پر سفر کرتی ہے۔ Chatwoot model-name prefixes (claude-، gemini-، deepseek-) کا ایک map رکھتا ضرور ہے مگر اسے telemetry labeling کے لیے استعمال کرتا ہے، routing کے لیے نہیں، تو CAPTAIN_OPEN_AI_MODEL کے طور پر سیٹ کی گئی Claude یا DeepSeek id پھر بھی آپ کے configured endpoint پر جاتی ہے جیسے کوئی اور string۔ Support traffic کا ایک الگ cost profile ہے: بہت سی conversations، مختصر turns، اور retrieved articles سے جمع کیے گئے grounded answers۔ یہ per-conversation cost کو اہم number بنا دیتا ہے، اور یہ retrieved context کے input tokens کا غالب ہوتا ہے۔ ایک fast id assistant tier کو اچھی طرح handle کرتی ہے، اور جب آپ چاہیں کہ copilot بہتر drafts لکھے تو ایک زیادہ طاقتور id تک escalation صرف ایک config change ہے۔

مکمل سیٹ اپ اور boot-time کی تفصیل۔

اپنی installation پر Super Admin console کھولیں، App Configs پر جائیں اور Captain منتخب کریں، پھر تینوں values بھریں۔ اگر آپ کا Chatwoot endpoint config سے پرانا ہے (یہ mid-2025 میں v4.4 دور میں آیا)، تو پہلے upgrade کریں؛ پرانے versions پر صرف key اور model موجود تھے اور endpoint hardcoded تھا۔ چونکہ initializer یہ configs application boot کے دوران پڑھتا ہے، تبدیلیاں web اور worker processes کے restart کے بعد اثر انداز ہوتی ہیں۔ اس کا مطلب یہ بھی ہے کہ ایک غلط value save کے وقت فیل نہیں ہوتی؛ یہ restart کے بعد پہلی Captain request پر فیل ہوتی ہے، جو غلط جگہ debug کرنے سے پہلے جاننے کے قابل ہے۔ Captain کا ایک embedding پہلو بھی ہے: CAPTAIN_EMBEDDING_MODEL (default text-embedding-3-small) آپ کے help-center content پر document search کو طاقت دیتا ہے، اور یہ اسی configured endpoint کے خلاف resolve ہوتا ہے۔ اگر آپ endpoint کو کسی gateway کی طرف دوبارہ point کریں، تو تصدیق کریں کہ وہاں configure کی گئی embedding id وہی ہے جو endpoint واقعی serve کرتا ہے؛ ورنہ document features کو ان کے موجودہ setup پر چھوڑیں اور switch کے بعد الگ سے validate کریں۔

# 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"}]}'

Support automation کے لیے model چننا۔

جو evaluation loop کام کرتا ہے: ایک fast id پر ایک ہفتہ چلائیں، usage numbers export کریں، پھر copilot-heavy teams کو ایک زیادہ طاقتور id پر چلائیں اور vibes کی بجائے draft acceptance compare کریں۔ دونوں candidates ایک ہی key کے ذریعے bill ہوتے ہیں، تو موازنہ قیمت کے ساتھ آتا ہے۔

• AI agent tier volume کام ہے: retrieved articles پر grounded answers، مہینے میں ہزاروں conversations۔ claude-haiku-4-5-20251001، gpt-5.4-mini، اور gemini-3.5-flash grounding discipline کھوئے بغیر per-conversation cost کو flat رکھتے ہیں۔
• copilot tier پورے threads پڑھتا ہے اور انسانوں کے لیے replies drafts کرتا ہے، جہاں tone اور judgment نظر آتے ہیں۔ claude-sonnet-4-6 قدرتی اگلا قدم ہے جب draft quality agent productivity کو چلاتی ہے۔
• Multilingual support desks کو اپنے حقیقی language mix پر deepseek-v4-pro اور gemini-3.5-flash ٹیسٹ کرنے چاہئیں؛ grounded answering quality زبانوں کے پار اس سے کہیں زیادہ مختلف ہوتی ہے جتنا English benchmarks بتاتے ہیں۔
• Per-conversation cost قابلِ پیمائش ہے، نظریاتی نہیں: فی conversation tokens ضرب فی مہینہ conversations، براہ راست usage log سے۔
• ایک model فی installation تمام Captain features کو serve کرتا ہے، تو اپنے غالب workload کے لیے چنیں اور ایک ہفتے کے حقیقی usage کو پڑھنے کے بعد دوبارہ جائزہ لیں۔

استعمال کے مطابق ادائیگی · سرکاری قیمت سے کم

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

Chatwoot Captain سے مخصوص failure modes۔

/v1 double-suffix سب سے کلاسک مسئلہ ہے۔ چونکہ Chatwoot آپ کے درج کردہ کسی بھی چیز میں /v1 append کرتا ہے، https://api.apisrouter.com/v1 paste کرنا /v1/v1/chat/completions کے خلاف requests پیدا کرتا ہے، جو gateway پر 404 دیتی ہیں۔ host کو /v1 کے بغیر درج کریں۔ Config تبدیلیاں جو نظر انداز ہوتی لگتی ہیں وہ restart rule ہے۔ agents SDK صرف boot پر ایک بار installation configs سے configure ہوتا ہے؛ Super Admin میں انہیں بغیر restart کیے edit کرنا ہر چلتے ہوئے process میں پرانی values کو live چھوڑ دیتا ہے۔ پرانی guides غلط surface کی طرف اشارہ کرتی ہیں۔ پرانے Chatwoot versions کے tutorials environment variables یا legacy OpenAI integration کے ذریعے OPENAI_API_KEY configure کرتے ہیں؛ موجودہ versions پر Super Admin میں Captain configs ہی surface ہیں، اور .env.example صاف الفاظ میں یہی کہتی ہے۔ switch کے بعد Captain کے پہلے جواب پر model-not-found کا مطلب ہے CAPTAIN_OPEN_AI_MODEL میں ایک id typo ہے؛ gateway کی /v1/models listing مستند spelling ہے۔ Authentication errors کا مطلب ہے key اور endpoint configs ایک ساتھ تعلق نہیں رکھتے۔ اور اگر article search یا document grounding خراب ہو جبکہ chat answers ٹھیک کام کریں، تو embedding config دیکھیں، جو ایک الگ model ہے جو اسی endpoint کے خلاف resolve ہوتا ہے۔

کون Chatwoot Captain کو gateway کے ذریعے route کرتا ہے۔

• Self-hosted support teams جو الگ vendor account اور billing relationship کے بغیر copilot میں Claude-quality drafting چاہتی ہیں۔
• High-volume desks جہاں AI agent زیادہ تر conversations کا جواب دیتا ہے، اور per-conversation cost فیصلہ کرتی ہے کہ automation فائدہ مند ہے یا نہیں؛ fast کیٹلاگ ids اس number کو ایماندار رکھتی ہیں۔
• وہ teams جو فی brand یا region ایک Chatwoot چلاتی ہیں، ہر installation کو اپنی key کے ساتھ میٹر کرتی ہیں تاکہ support AI cost فی brand خود report ہو۔
• وہ operators جو support models کو حقیقی traffic پر compare کرتے ہیں: ہر candidate ایک config value اور ایک restart ہے، migration نہیں۔
• وہ developers جن کے پاس کسی مخصوص vendor کی billing تک رسائی نہیں۔ Top-up پر مبنی رسائی بغیر کارڈ کی شرط کے فی-provider sign-up کا انحصار ختم کر دیتی ہے۔

Endpoint verify کریں اور پہلی conversation debug کریں۔

پہلے Chatwoot کے باہر verify کریں: اپنی key کے ساتھ models کی list کریں اور CAPTAIN_OPEN_AI_MODEL میں سیٹ کی گئی exact id کے خلاف ایک chat completion چلائیں۔ اگر یہ pass ہو جائیں، تو gateway کا آدھا حصہ ثابت ہو جاتا ہے اور باقی سب کچھ Chatwoot-side ہے۔ پھر restart کریں اور پہلی Captain interaction دیکھیں۔ Authentication failures key config کی طرف اشارہ کرتی ہیں؛ model-not-found model config کی طرف؛ 404-shaped errors endpoint config میں paste کیے گئے /v1 کی طرف۔ اگر Captain features بالکل نظر نہ آئیں، تو یہ آپ کے installation tier پر availability اور licensing ہے، endpoint configuration نہیں۔ ایک بار conversations چلنے لگیں، APIsRouter console per-request model، token counts، اور spend دکھاتا ہے۔ Support AI ایک budget line ہے جو ماہانہ compound ہوتی ہے، اور فی installation ایک key usage log کو اس per-desk cost report میں بدل دیتی ہے جو آپ کی finance team مانگتی رہتی ہے۔

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

عمومی سوالات