Jalankan Chatwoot Captain pada endpoint serasi OpenAI custom.

Jawapan pantas: tiga config Captain dalam Super Admin.

Pada Chatwoot self-hosted semasa, tetapan LLM Captain adalah config pemasangan, bukan pembolehubah .env; .env.example yang dihantar menyatakannya secara eksplisit dan mengarahkan anda ke Super Admin, App Configs, Captain. Tiga nilai penting: CAPTAIN_OPEN_AI_API_KEY mengambil kunci gateway, CAPTAIN_OPEN_AI_MODEL mengambil id model, dan CAPTAIN_OPEN_AI_ENDPOINT mengambil hos endpoint. Nilai endpoint mempunyai satu titik tajam: berikan tanpa akhiran /v1. Initializer Chatwoot membina asas API sendiri dengan memotong slash hujung dan melampirkan /v1, dan penerangan config sendiri menunjukkan lalai sebagai https://api.openai.com/ dalam bentuk yang tepat itu. Untuk APIsRouter, masukkan https://api.apisrouter.com dan biarkan Chatwoot menerbitkan https://api.apisrouter.com/v1. Config ini dibaca semasa aplikasi boot, jadi mulakan semula Chatwoot selepas menukarnya.

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
                          (tiada /v1 -- Chatwoot melampirkannya)

kemudian mulakan semula proses Chatwoot

Apa yang Captain lakukan dengan model yang dikonfigurasikan.

Chatwoot (lebih kurang 34K bintang di GitHub) adalah platform sokongan pelanggan sumber terbuka terkemuka, dan Captain adalah lapisan AI-nya: agent AI yang menjawab perbualan pelanggan daripada artikel pusat bantuan dan FAQ anda, copilot yang merangka balasan dan meringkaskan thread untuk agent manusia, dan ciri pengetahuan berasaskan dokumen di sebalik kedua-duanya. Pada pemasangan self-hosted di mana Captain tersedia, semua ini berjalan melalui model yang dikonfigurasikan di atas. Di sebalik tabir, Chatwoot mengkonfigurasikan SDK agent-nya sekali semasa boot: kunci, asas API terbitan, dan model lalai. Setiap ciri Captain kemudian bertutur chat completions standard kepada base URL itu, dan id model bergerak sebagai rentetan biasa. Chatwoot memang menyimpan peta awalan nama-model (claude-, gemini-, deepseek-) tetapi menggunakannya untuk pelabelan telemetri, bukan penghalaan, jadi id Claude atau DeepSeek ditetapkan sebagai CAPTAIN_OPEN_AI_MODEL masih pergi ke endpoint yang anda konfigurasikan seperti rentetan lain. Trafik sokongan mempunyai profil kos yang tersendiri: banyak perbualan, giliran pendek, dan jawapan berasas yang dihimpun daripada artikel yang diambil. Itu menjadikan kos per-perbualan angka yang penting, dan ia didominasi oleh token input daripada konteks yang diambil. Id pantas mengendalikan tier assistant dengan baik, dengan peningkatan kepada id lebih kuat menjadi satu perubahan config apabila anda mahukan copilot menulis draf yang lebih baik.

Persediaan penuh dan butiran masa-boot.

Buka konsol Super Admin pada pemasangan anda, pergi ke App Configs dan pilih Captain, kemudian isi tiga nilai. Jika Chatwoot anda lebih lama daripada config endpoint (ia tiba dalam era v4.4 pertengahan 2025), naik taraf dahulu; pada versi lebih lama hanya kunci dan model wujud dan endpoint dikodkan keras. Kerana initializer membaca config ini semasa boot aplikasi, perubahan berkuat kuasa selepas mulakan semula proses web dan worker. Itu juga bermaksud nilai yang salah tidak gagal semasa menyimpan; ia gagal pada permintaan Captain pertama selepas mulakan semula, yang berbaloi diketahui sebelum anda nyahpepijat di tempat yang salah. Captain juga mempunyai sisi embedding: CAPTAIN_EMBEDDING_MODEL (lalai text-embedding-3-small) menggerakkan carian dokumen atas kandungan pusat bantuan anda, dan ia diselesaikan terhadap endpoint yang dikonfigurasikan sama. Jika anda mengarahkan semula endpoint ke gateway, sahkan id embedding yang anda konfigurasikan di situ benar-benar dilayani endpoint; jika tidak, biarkan ciri dokumen pada persediaan sedia ada dan sahkan secara berasingan selepas pertukaran.

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

Memilih model untuk automasi sokongan.

Gelung penilaian yang berfungsi: jalankan seminggu pada id pantas, eksport nombor penggunaan, kemudian jalankan pasukan berat-copilot pada id lebih kuat dan bandingkan penerimaan draf berbanding perasaan. Kedua-dua calon berbil melalui kunci yang sama, jadi perbandingan itu tiba dengan harga.

• Tier agent AI adalah kerja volum: jawapan berasas atas artikel yang diambil, ribuan perbualan sebulan. claude-haiku-4-5-20251001, gpt-5.4-mini, dan gemini-3.5-flash mengekalkan kos per-perbualan rata tanpa kehilangan disiplin pengasasan.
• Tier copilot membaca keseluruhan thread dan merangka balasan untuk manusia, di mana nada dan pertimbangan kelihatan. claude-sonnet-4-6 adalah langkah semula jadi ke atas apabila kualiti draf menggerakkan produktiviti agent.
• Meja sokongan berbilang bahasa patut menguji deepseek-v4-pro dan gemini-3.5-flash pada campuran bahasa sebenar mereka; kualiti jawapan berasas berbeza lebih banyak merentasi bahasa berbanding yang disarankan penanda aras Inggeris.
• Kos per-perbualan boleh diukur, bukan teori: token per perbualan didarab perbualan sebulan, terus daripada log penggunaan.
• Satu model melayani semua ciri Captain per pemasangan, jadi pilih untuk beban kerja dominan anda dan semak semula selepas membaca seminggu penggunaan sebenar.

Bayar mengikut penggunaan · bawah harga rasmi

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

Mod kegagalan khusus Chatwoot Captain.

Akhiran-berganda /v1 adalah yang klasik. Kerana Chatwoot melampirkan /v1 kepada apa sahaja yang anda masukkan, menampal https://api.apisrouter.com/v1 menghasilkan permintaan terhadap /v1/v1/chat/completions, yang 404 pada gateway. Masukkan hos tanpa /v1. Perubahan config yang kelihatan diabaikan adalah peraturan mulakan-semula. SDK agent dikonfigurasikan sekali semasa boot daripada config pemasangan; menyunting dalam Super Admin tanpa mulakan semula meninggalkan nilai lama hidup dalam setiap proses yang berjalan. Panduan lama menunjuk kepada permukaan yang salah. Tutorial daripada versi Chatwoot yang lebih awal mengkonfigurasikan OPENAI_API_KEY melalui pembolehubah environment atau integrasi OpenAI warisan; pada versi semasa, config Captain dalam Super Admin adalah permukaan, dan .env.example menyatakannya dengan jelas. Model-not-found pada balasan pertama Captain selepas pertukaran adalah kesilapan taip id dalam CAPTAIN_OPEN_AI_MODEL; senarai /v1/models gateway adalah ejaan berautoriti. Ralat pengesahan bermaksud kunci dan config endpoint tidak sepadan. Dan jika carian artikel atau pengasasan dokumen merosot sementara jawapan chat berfungsi baik, semak config embedding, yang merupakan model berasingan diselesaikan terhadap endpoint yang sama.

Siapa yang menghalakan Chatwoot Captain melalui gateway.

• Pasukan sokongan self-hosted yang mahukan rangkaan berkualiti Claude dalam copilot tanpa akaun vendor dan hubungan pengebilan berasingan.
• Meja volum tinggi di mana agent AI menjawab kebanyakan perbualan, dan kos per-perbualan menentukan sama ada automasi berbaloi; id katalog pantas mengekalkan nombor itu jujur.
• Pasukan yang menjalankan satu Chatwoot per jenama atau wilayah, mengukur setiap pemasangan dengan kunci sendiri supaya kos AI sokongan melaporkan diri sendiri per jenama.
• Operator yang membandingkan model sokongan pada trafik sebenar: setiap calon adalah satu nilai config dan mulakan semula, bukan migrasi.
• Pembangun tanpa akses kepada pengebilan vendor tertentu. Akses berasaskan top-up tanpa keperluan kad menghapuskan kebergantungan pendaftaran setiap penyedia.

Sahkan endpoint dan nyahpepijat perbualan pertama.

Sahkan di luar Chatwoot dahulu: senaraikan model dengan kunci anda dan jalankan satu chat completion terhadap id tepat yang anda tetapkan dalam CAPTAIN_OPEN_AI_MODEL. Jika itu lulus, separuh gateway terbukti dan segala-galanya yang lain adalah sisi-Chatwoot. Kemudian mulakan semula dan perhatikan interaksi Captain pertama. Kegagalan pengesahan menunjuk kepada config kunci; model-not-found menunjuk kepada config model; ralat berbentuk-404 menunjuk kepada /v1 yang ditampal ke dalam config endpoint. Jika ciri Captain langsung tidak muncul, itu adalah ketersediaan dan pelesenan pada tier pemasangan anda, bukan konfigurasi endpoint. Sebaik sahaja perbualan mengalir, konsol APIsRouter menunjukkan model per permintaan, kiraan token, dan perbelanjaan. AI sokongan adalah item belanjawan yang berganda bulanan, dan satu kunci per pemasangan menukar log penggunaan kepada laporan kos per-meja yang sentiasa diminta pasukan kewangan anda.

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

Soalan lazim