Jalankan Chatwoot Captain di endpoint OpenAI-compatible custom.

Jawaban singkat: tiga config Captain di Super Admin.

Pada Chatwoot self-hosted saat ini, pengaturan LLM Captain adalah installation config, bukan variabel .env; .env.example yang dirilis menyatakannya secara eksplisit dan mengarahkan Anda ke Super Admin, App Configs, Captain. Tiga nilai yang penting: CAPTAIN_OPEN_AI_API_KEY menerima key gateway, CAPTAIN_OPEN_AI_MODEL menerima id model, dan CAPTAIN_OPEN_AI_ENDPOINT menerima host endpoint. Nilai endpoint punya satu sisi tajam: berikan tanpa suffix /v1. Initializer Chatwoot membangun API base-nya sendiri dengan memotong trailing slash dan menambahkan /v1, dan deskripsi config-nya sendiri menunjukkan default sebagai https://api.openai.com/ dalam bentuk persis itu. Untuk APIsRouter, masukkan https://api.apisrouter.com dan biarkan Chatwoot menurunkan https://api.apisrouter.com/v1. Config ini dibaca saat app boot, jadi restart Chatwoot setelah mengubahnya.

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

Apa yang dilakukan Captain dengan model yang dikonfigurasi.

Chatwoot (sekitar 34K bintang di GitHub) adalah platform customer support open-source terdepan, dan Captain adalah lapisan AI-nya: AI agent yang menjawab percakapan pelanggan dari artikel help-center dan FAQ Anda, copilot yang menyusun draf balasan dan meringkas thread untuk human agent, dan fitur knowledge yang berbasis dokumen di balik keduanya. Pada instalasi self-hosted di mana Captain tersedia, semuanya berjalan lewat model yang dikonfigurasi di atas. Di baliknya, Chatwoot mengonfigurasi agents SDK-nya sekali saat boot: key, API base yang diturunkan, dan model default. Setiap fitur Captain kemudian berbicara chat completions standar ke base URL itu, dan id model berjalan sebagai string biasa. Chatwoot memang menyimpan peta prefiks nama-model (claude-, gemini-, deepseek-) tapi memakainya untuk pelabelan telemetri, bukan routing, jadi id Claude atau DeepSeek yang diset sebagai CAPTAIN_OPEN_AI_MODEL tetap pergi ke endpoint yang Anda konfigurasi seperti string lainnya. Traffic support punya profil biaya yang khas: banyak percakapan, giliran pendek, dan jawaban grounded yang dirakit dari artikel yang diambil. Itu membuat biaya per-percakapan jadi angka yang penting, dan didominasi oleh token input dari context yang diambil. Id cepat menangani tier asisten dengan baik, dengan eskalasi ke id yang lebih kuat hanya perubahan satu config saat Anda ingin copilot menulis draf yang lebih baik.

Setup lengkap dan detail waktu-boot.

Buka konsol Super Admin di instalasi Anda, masuk ke App Configs dan pilih Captain, lalu isi tiga nilainya. Jika Chatwoot Anda lebih tua dari config endpoint ini (ia hadir di era v4.4 pertengahan 2025), upgrade dulu; pada versi lebih lama hanya key dan model yang ada dan endpoint-nya hardcoded. Karena initializer membaca config ini selama boot aplikasi, perubahan berlaku setelah restart proses web dan worker. Itu juga berarti nilai yang salah tidak gagal saat disimpan; ia gagal pada request Captain pertama setelah restart, yang layak diketahui sebelum Anda debug di tempat yang salah. Captain juga punya sisi embedding: CAPTAIN_EMBEDDING_MODEL (default text-embedding-3-small) menggerakkan pencarian dokumen atas konten help-center Anda, dan ia teresolusi terhadap endpoint yang dikonfigurasi yang sama. Jika Anda mengarahkan ulang endpoint ke gateway, konfirmasi id embedding yang Anda konfigurasi di sana benar-benar dilayani endpoint; jika tidak, biarkan fitur dokumen pada setup yang sudah ada dan validasi secara terpisah setelah beralih.

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

Memilih model untuk otomasi support.

Loop evaluasi yang berhasil: jalankan seminggu di id cepat, ekspor angka penggunaan, lalu jalankan tim yang berat-copilot di id yang lebih kuat dan bandingkan tingkat penerimaan draf alih-alih perasaan. Kedua kandidat menagih lewat key yang sama, jadi perbandingannya tiba dengan harga.

• Tier AI agent adalah kerja volume: jawaban grounded atas artikel yang diambil, ribuan percakapan per bulan. claude-haiku-4-5-20251001, gpt-5.4-mini, dan gemini-3.5-flash menjaga biaya per-percakapan tetap datar tanpa kehilangan disiplin grounding.
• Tier copilot membaca thread utuh dan menyusun draf balasan untuk manusia, di mana tone dan penilaian terlihat. claude-sonnet-4-6 adalah peningkatan alami saat kualitas draf menggerakkan produktivitas agent.
• Meja support multibahasa sebaiknya menguji deepseek-v4-pro dan gemini-3.5-flash pada campuran bahasa nyata mereka; kualitas jawaban grounded bervariasi lebih besar lintas bahasa daripada yang disarankan benchmark berbahasa Inggris.
• Biaya per-percakapan bisa diukur, bukan teoretis: token per percakapan dikali percakapan per bulan, langsung dari log penggunaan.
• Satu model melayani semua fitur Captain per instalasi, jadi pilih untuk beban kerja dominan Anda dan tinjau ulang setelah membaca seminggu penggunaan nyata.

Bayar sesuai pemakaian · di bawah harga resmi

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

Mode kegagalan spesifik Chatwoot Captain.

Suffix ganda /v1 adalah yang klasik. Karena Chatwoot menambahkan /v1 ke apa pun yang Anda masukkan, menempelkan https://api.apisrouter.com/v1 menghasilkan request terhadap /v1/v1/chat/completions, yang 404 di gateway. Masukkan host tanpa /v1. Perubahan config yang terlihat diabaikan adalah aturan restart. Agents SDK dikonfigurasi sekali saat boot dari installation config; mengedit di Super Admin tanpa restart membiarkan nilai lama tetap hidup di setiap proses yang berjalan. Panduan lama menunjuk ke permukaan yang salah. Tutorial dari versi Chatwoot yang lebih lama mengonfigurasi OPENAI_API_KEY lewat environment variable atau integrasi OpenAI lama; pada versi saat ini, config Captain di Super Admin adalah permukaannya, dan .env.example menyatakannya dengan gamblang. Model-not-found pada balasan pertama Captain setelah beralih adalah salah ketik id di CAPTAIN_OPEN_AI_MODEL; listing /v1/models gateway adalah ejaan yang otoritatif. Error autentikasi berarti config key dan endpoint tidak berpasangan. Dan jika pencarian artikel atau grounding dokumen memburuk sementara jawaban chat baik-baik saja, lihat config embedding, yang merupakan model terpisah yang teresolusi terhadap endpoint yang sama.

Siapa yang merutekan Chatwoot Captain melalui gateway.

• Tim support self-hosted yang menginginkan penyusunan draf berkualitas-Claude di copilot tanpa akun vendor terpisah dan hubungan billing.
• Meja bervolume tinggi di mana AI agent menjawab sebagian besar percakapan, dan biaya per-percakapan menentukan apakah otomasi terbayar; id katalog cepat menjaga angka itu jujur.
• Tim yang menjalankan satu Chatwoot per brand atau region, mengukur setiap instalasi dengan key-nya sendiri sehingga biaya AI support melaporkan dirinya sendiri per brand.
• Operator yang membandingkan model support pada traffic nyata: setiap kandidat hanya satu nilai config dan restart, bukan migrasi.
• Developer tanpa akses ke billing vendor tertentu. Akses berbasis top-up tanpa syarat kartu menghilangkan ketergantungan sign-up per provider.

Verifikasi endpoint dan debug percakapan pertama.

Verifikasi di luar Chatwoot dulu: daftar model dengan key Anda dan jalankan satu chat completion terhadap id persis yang Anda set di CAPTAIN_OPEN_AI_MODEL. Jika keduanya lolos, separuh gateway terbukti dan sisanya adalah sisi Chatwoot. Lalu restart dan amati interaksi Captain pertama. Kegagalan autentikasi menunjuk ke config key; model-not-found menunjuk ke config model; error berbentuk 404 menunjuk ke /v1 yang tertempel di config endpoint. Jika fitur Captain sama sekali tidak muncul, itu adalah ketersediaan dan lisensi pada tier instalasi Anda, bukan konfigurasi endpoint. Setelah percakapan mengalir, konsol APIsRouter menunjukkan model per request, hitungan token, dan pengeluaran. AI support adalah baris budget yang berlipat ganda setiap bulan, dan satu key per instalasi mengubah log penggunaan jadi laporan biaya per-meja yang terus diminta tim finance Anda.

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

Pertanyaan umum