Chatwoot Captain একটা কাস্টম OpenAI-compatible endpoint-এ চালান।

দ্রুত উত্তর: Super Admin-এ তিনটা Captain config।

Current self-hosted Chatwoot-এ, Captain-এর LLM setting installation config, .env variable না; শিপ করা .env.example স্পষ্টভাবে এটা বলে এবং আপনাকে Super Admin, App Configs, Captain-এ point করে। তিনটা value গুরুত্বপূর্ণ: CAPTAIN_OPEN_AI_API_KEY gateway key নেয়, CAPTAIN_OPEN_AI_MODEL model id নেয়, এবং CAPTAIN_OPEN_AI_ENDPOINT endpoint host নেয়। Endpoint value-র একটা sharp edge আছে: /v1 suffix ছাড়া দিন। Chatwoot-এর initializer একটা trailing slash trim করে এবং /v1 append করে নিজেই API base বানায়, এবং config-এর নিজস্ব description default দেখায় https://api.openai.com/ ঠিক সেই shape-এ। APIsRouter-এর জন্য, https://api.apisrouter.com দিন এবং Chatwoot-কে https://api.apisrouter.com/v1 derive করতে দিন। এই config 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

Configure করা model দিয়ে Captain কী করে।

Chatwoot (GitHub-এ প্রায় 34K star) হলো leading open-source customer support platform, এবং Captain হলো এর AI layer: একটা AI agent যা আপনার help-center article এবং FAQ থেকে customer conversation-এর উত্তর দেয়, একটা copilot যা human agent-দের জন্য reply draft করে এবং thread summarize করে, এবং দুটোর পিছনেই document-grounded knowledge feature। Self-hosted installation-এ যেখানে Captain উপলব্ধ, সেখানে এর সবকিছুই উপরে configure করা model দিয়ে চলে। এর নিচে, Chatwoot boot-এ একবার তার agents SDK configure করে: key, derived API base, এবং default model। তারপর প্রতিটা Captain feature সেই base URL-এ standard chat completions বলে, এবং model id একটা plain string হিসেবে ভ্রমণ করে। Chatwoot model-name prefix-এর একটা map রাখে (claude-, gemini-, deepseek-) কিন্তু এটা telemetry labeling-এর জন্য ব্যবহার করে, routing-এর জন্য না, তাই CAPTAIN_OPEN_AI_MODEL হিসেবে সেট করা একটা Claude বা DeepSeek id এখনও অন্য যেকোনো string-এর মতোই আপনার configure করা endpoint-এ যায়। Support traffic-এর একটা স্বতন্ত্র cost profile আছে: অনেক conversation, ছোট turn, এবং retrieved article থেকে assembled grounded answer। এটা per-conversation cost-কে গুরুত্বপূর্ণ সংখ্যা বানায়, এবং retrieved context থেকে input token এর উপর প্রাধান্য পায়। একটা fast id assistant tier ভালোভাবে handle করে, এবং copilot draft ভালো লেখাতে চাইলে stronger id-তে escalation একটা এক-config change।

সম্পূর্ণ সেটআপ এবং boot-time detail।

আপনার installation-এ Super Admin console খুলুন, App Configs-এ যান এবং Captain বেছে নিন, তারপর তিনটা value পূরণ করুন। আপনার Chatwoot যদি endpoint config-এর আগেকার হয় (এটা 2025-এর মাঝামাঝি v4.4 era-তে এসেছিল), প্রথমে upgrade করুন; পুরনো version-এ শুধু key এবং model ছিল আর endpoint hardcoded ছিল। Initializer application boot-এর সময় এই config পড়ে বলে, changes web এবং worker process restart করার পর কার্যকর হয়। এর মানে একটা ভুল value save time-এ fail করে না; এটা restart-এর পর প্রথম Captain request-এ fail করে, যা ভুল জায়গায় debug করার আগে জানা মূল্যবান। Captain-এর একটা embedding side-ও আছে: CAPTAIN_EMBEDDING_MODEL (default text-embedding-3-small) আপনার help-center content-এর উপর document search চালায়, এবং এটা একই configure করা endpoint-এর বিরুদ্ধে resolve হয়। endpoint-কে একটা gateway-তে re-point করলে, নিশ্চিত করুন সেখানে configure করা embedding id endpoint আসলে serve করে কিনা; নাহলে document feature তাদের বিদ্যমান 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 number export করুন, তারপর copilot-heavy team-কে একটা stronger id-তে চালান এবং vibe না বরং draft acceptance তুলনা করুন। দুই candidate-ই একই key দিয়ে bill হয়, তাই তুলনা priced হয়ে আসে।

• AI agent tier volume কাজ: retrieved article-এর উপর grounded answer, মাসে হাজার হাজার conversation। claude-haiku-4-5-20251001, gpt-5.4-mini, এবং gemini-3.5-flash grounding discipline না হারিয়ে per-conversation cost flat রাখে।
• Copilot tier পুরো thread পড়ে এবং human-দের জন্য reply draft করে, যেখানে tone এবং judgment দেখা যায়। draft quality agent productivity চালালে claude-sonnet-4-6-ই natural next step।
• Multilingual support desk-দের তাদের real language mix-এ deepseek-v4-pro এবং gemini-3.5-flash test করা উচিত; grounded answering quality English benchmark যা ইঙ্গিত করে তার চেয়ে language জুড়ে বেশি varies করে।
• Per-conversation cost measurable, theoretical না: প্রতি conversation token গুণ প্রতি মাসে conversation, সরাসরি usage log থেকে।
• প্রতি installation-এ Captain-এর সব feature এক model serve করে, তাই আপনার প্রধান workload অনুযায়ী বেছে নিন এবং real usage-এর এক সপ্তাহ পড়ার পর revisit করুন।

ব্যবহার অনুযায়ী পেমেন্ট · অফিশিয়াল মূল্যের নিচে

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

Chatwoot Captain-specific failure mode।

/v1 double-suffix হলো ক্লাসিক। Chatwoot আপনি যা এন্টার করেন তার সাথে /v1 append করে বলে, https://api.apisrouter.com/v1 paste করলে /v1/v1/chat/completions-এর বিরুদ্ধে request তৈরি হয়, যা gateway-এ 404 করে। /v1 ছাড়া host এন্টার করুন। Ignore হয়ে গেছে মনে হওয়া config change আসলে restart rule। agents SDK installation config থেকে boot-এ একবারই configure হয়; restart ছাড়া Super Admin-এ এগুলো edit করলে প্রতিটা চলমান process-এ পুরনো value live থেকে যায়। পুরনো guide ভুল surface point করে। আগের Chatwoot version-এর tutorial environment variable বা legacy OpenAI integration দিয়ে OPENAI_API_KEY configure করে; current version-এ Super Admin-এর Captain config-ই surface, এবং .env.example ঠিক সেটাই বলে। Switch-এর পর Captain-এর প্রথম reply-তে model-not-found মানে CAPTAIN_OPEN_AI_MODEL-এ একটা id typo; gateway-র /v1/models listing-ই authoritative spelling। Authentication error মানে key এবং endpoint config একসাথে belong করে না। এবং chat answer ঠিক থাকা সত্ত্বেও article search বা document grounding খারাপ হলে, embedding config দেখুন, যা একই endpoint-এর বিরুদ্ধে resolve হওয়া একটা আলাদা model।

কারা একটা gateway দিয়ে Chatwoot Captain route করে।

• Self-hosted support team যারা একটা আলাদা vendor account এবং billing relationship ছাড়া copilot-এ Claude-quality drafting চায়।
• High-volume desk যেখানে AI agent বেশিরভাগ conversation-এর উত্তর দেয়, এবং per-conversation cost ঠিক করে automation পোষায় কিনা; fast catalog id সেই সংখ্যা honest রাখে।
• Brand বা region প্রতি এক Chatwoot চালানো Team, প্রতিটা installation-কে নিজস্ব key দিয়ে metering করে যাতে support AI cost প্রতি brand-এ নিজেই report করে।
• Real traffic-এ support model তুলনা করা Operator: প্রতিটা candidate একটা config value এবং একটা restart, migration না।
• Developer যাদের কোনো নির্দিষ্ট vendor-এর billing-এ access নেই। কোনো card requirement ছাড়া Top-up based access per-provider sign-up dependency সরিয়ে দেয়।

Endpoint verify করুন এবং প্রথম conversation debug করুন।

প্রথমে Chatwoot-এর বাইরে verify করুন: আপনার key দিয়ে model list করুন এবং CAPTAIN_OPEN_AI_MODEL-এ যে exact id সেট করেছেন তার বিরুদ্ধে একটা chat completion চালান। এগুলো pass করলে, gateway অর্ধেক প্রমাণিত এবং বাকি সবকিছু Chatwoot-side। তারপর restart করুন এবং প্রথম Captain interaction দেখুন। Authentication failure key config-এর দিকে ইঙ্গিত করে; model-not-found model config-এর দিকে; 404-shaped error endpoint config-এ paste করা একটা /v1-এর দিকে। Captain feature একেবারেই না দেখা গেলে, সেটা আপনার installation tier-এর availability এবং licensing, endpoint configuration না। Conversation flow শুরু হলে, APIsRouter console per-request model, token count, এবং 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

সাধারণ প্রশ্ন