Chatwoot Captain'ı özel bir OpenAI-compatible endpoint üzerinde çalıştırın.

Hızlı yanıt: Super Admin'de üç Captain config'i.

Mevcut self-hosted Chatwoot'ta, Captain'ın LLM ayarları .env değişkenleri değil, kurulum config'leridir; birlikte gelen .env.example bunu açıkça belirtir ve sizi Super Admin, App Configs, Captain'a yönlendirir. Üç değer önemlidir: CAPTAIN_OPEN_AI_API_KEY gateway anahtarını alır, CAPTAIN_OPEN_AI_MODEL model id'sini alır ve CAPTAIN_OPEN_AI_ENDPOINT endpoint host'unu alır. Endpoint değerinin bir keskin kenarı vardır: onu /v1 son eki olmadan verin. Chatwoot'un initializer'ı, sondaki eğik çizgiyi kırpıp /v1 ekleyerek API base'i kendisi oluşturur ve config'in kendi açıklaması, varsayılanı tam olarak bu şekilde https://api.openai.com/ olarak gösterir. APIsRouter için https://api.apisrouter.com girin ve Chatwoot'un https://api.apisrouter.com/v1'i türetmesine izin verin. Bu config'ler uygulama başlarken okunur, bu yüzden değiştirdikten sonra Chatwoot'u yeniden başlatın.

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, yapılandırılmış modelle ne yapar.

Chatwoot (GitHub'da yaklaşık 34K yıldız), önde gelen açık kaynaklı müşteri destek platformudur ve Captain onun AI katmanıdır: yardım merkezi makalelerinizden ve SSS'lerinizden müşteri konuşmalarını yanıtlayan bir AI agent, insan agent'lar için yanıtlar taslayan ve konuşma zincirlerini özetleyen bir copilot ve her ikisinin arkasındaki belge-temelli bilgi özellikleri. Captain'ın kullanılabildiği self-hosted kurulumlarda, bunların hepsi yukarıda yapılandırılan model üzerinden çalışır. Kaputun altında, Chatwoot agent'lar SDK'sını başlangıçta bir kez yapılandırır: anahtar, türetilmiş API base ve varsayılan model. Her Captain özelliği daha sonra o base URL'e standart chat completions konuşur ve model id'si düz bir dize olarak taşınır. Chatwoot model-adı öneklerinin bir haritasını tutar (claude-, gemini-, deepseek-) ama bunu yönlendirme için değil telemetri etiketleme için kullanır, bu yüzden CAPTAIN_OPEN_AI_MODEL olarak ayarlanan bir Claude veya DeepSeek id'si yine de diğer her dize gibi yapılandırdığınız endpoint'e gider. Destek trafiğinin kendine özgü bir maliyet profili vardır: çok sayıda konuşma, kısa turlar ve alınan makalelerden bir araya getirilen temellendirilmiş yanıtlar. Bu, konuşma başına maliyeti önemli sayı yapar ve alınan bağlamdan gelen girdi token'ları buna hakimdir. Hızlı bir id, agent katmanını iyi ele alır ve copilot'un daha iyi taslaklar yazmasını istediğinizde daha güçlü bir id'ye yükseltme tek bir config değişikliğidir.

Tam kurulum ve başlangıç anı detayı.

Kurulumunuzdaki Super Admin konsolunu açın, App Configs'e gidin ve Captain'ı seçin, ardından üç değeri doldurun. Chatwoot'unuz endpoint config'inden önceyse (2025 ortasında v4.4 döneminde geldi), önce yükseltin; daha eski sürümlerde yalnızca anahtar ve model vardı ve endpoint kodda sabitti. Initializer bu config'leri uygulama başlangıcında okuduğundan, değişiklikler web ve worker süreçlerinin yeniden başlatılmasından sonra etkinleşir. Bu ayrıca yanlış bir değerin kaydetme anında başarısız olmadığı, yeniden başlatmadan sonraki ilk Captain isteğinde başarısız olduğu anlamına gelir, ki bu yanlış yerde hata ayıklamadan önce bilinmeye değer. Captain'ın ayrıca bir embedding tarafı vardır: CAPTAIN_EMBEDDING_MODEL (varsayılan text-embedding-3-small), yardım merkezi içeriğiniz üzerinde belge aramasını güçlendirir ve aynı yapılandırılmış endpoint'e karşı çözülür. Endpoint'i bir gateway'e yeniden yönlendirirseniz, orada yapılandırdığınız embedding id'sinin endpoint'in gerçekten sunduğu bir id olduğunu doğrulayın; aksi takdirde belge özelliklerini mevcut kurulumlarında bırakın ve geçişten sonra ayrı doğrulayın.

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

Destek otomasyonu için model seçmek.

İşe yarayan değerlendirme döngüsü: bir hafta hızlı bir id'de çalıştırın, kullanım rakamlarını dışa aktarın, ardından copilot ağırlıklı ekipleri daha güçlü bir id'de çalıştırın ve hisse değil taslak kabulünü karşılaştırın. Her iki aday da aynı anahtar üzerinden faturalandırılır, bu yüzden karşılaştırma fiyatlandırılmış olarak gelir.

• AI agent katmanı hacim işidir: alınan makaleler üzerinde temellendirilmiş yanıtlar, ayda binlerce konuşma. claude-haiku-4-5-20251001, gpt-5.4-mini ve gemini-3.5-flash, temellendirme disiplinini kaybetmeden konuşma başına maliyeti sabit tutar.
• Copilot katmanı tüm zincirleri okur ve insanlar için yanıtlar taslar, tonun ve muhakemenin göründüğü yer burasıdır. claude-sonnet-4-6, taslak kalitesinin agent üretkenliğini yönlendirdiği zamanki doğal yükseltmedir.
• Çok dilli destek masaları deepseek-v4-pro ve gemini-3.5-flash'ı kendi gerçek dil karışımlarında test etmelidir; temellendirilmiş yanıtlama kalitesi, İngilizce benchmark'ların ima ettiğinden daha fazla dil arasında değişir.
• Konuşma başına maliyet ölçülebilir, teorik değil: konuşma başına token çarpı ay başına konuşma, doğrudan kullanım logundan.
• Bir model, kurulum başına tüm Captain özelliklerine hizmet eder, bu yüzden baskın iş yükünüz için seçin ve bir hafta gerçek kullanımı okuduktan sonra yeniden gözden geçirin.

Kullandıkça öde · resmi fiyatların altında

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

Chatwoot Captain'a özgü hata modları.

Çift /v1 son eki klasik olandır. Chatwoot ne girerseniz onun sonuna /v1 eklediğinden, https://api.apisrouter.com/v1 yapıştırmak /v1/v1/chat/completions'a karşı istekler üretir, ki bu gateway'de 404 verir. Host'u /v1 olmadan girin. Yok sayılıyormuş gibi görünen config değişiklikleri, yeniden başlatma kuralıdır. Agent'lar SDK'sı başlangıçta kurulum config'lerinden bir kez yapılandırılır; Super Admin'de bunları yeniden başlatmadan düzenlemek, eski değerleri çalışan her süreçte canlı bırakır. Eski kılavuzlar yanlış yüzeye işaret eder. Daha önceki Chatwoot sürümlerinden gelen eğitimler, OPENAI_API_KEY'i ortam değişkenleri veya eski OpenAI entegrasyonu üzerinden yapılandırır; mevcut sürümlerde Super Admin'deki Captain config'leri yüzeydir ve .env.example bunu aynı sözlerle söyler. Bir değiştirmeden sonra Captain'ın ilk yanıtındaki model-not-found, CAPTAIN_OPEN_AI_MODEL'de bir id yazım hatasıdır; gateway'in /v1/models listelemesi yetkili yazımdır. Kimlik doğrulama hataları, anahtarın ve endpoint config'lerinin birbirine ait olmadığı anlamına gelir. Ve makale araması veya belge temellendirmesi bozulurken sohbet yanıtları iyi çalışıyorsa, aynı endpoint'e karşı çözülen ayrı bir model olan embedding config'ine bakın.

Chatwoot Captain'ı bir gateway üzerinden kim yönlendirir.

• Ayrı bir satıcı hesabı ve faturalandırma ilişkisi olmadan copilot'ta Claude kalitesinde taslak isteyen self-hosted destek ekipleri.
• AI agent'ın çoğu konuşmayı yanıtladığı ve konuşma başına maliyetin otomasyonun karşılığını verip vermediğine karar verdiği yüksek hacimli masalar; hızlı katalog id'leri bu rakamı dürüst tutar.
• Marka veya bölge başına bir Chatwoot çalıştıran, her kurulumu kendi anahtarıyla ölçen ve destek AI maliyetinin marka başına kendini raporlamasını sağlayan ekipler.
• Destek modellerini gerçek trafik üzerinde karşılaştıran operatörler: her aday bir config değeri ve bir yeniden başlatmadır, bir geçiş değil.
• Belirli bir satıcının faturalandırmasına erişimi olmayan geliştiriciler. Kart gerektirmeyen yükleme tabanlı erişim, sağlayıcı başına kayıt bağımlılığını ortadan kaldırır.

Endpoint'i doğrulayın ve ilk konuşmayı hata ayıklayın.

Önce Chatwoot dışında doğrulayın: anahtarınızla modelleri listeleyin ve CAPTAIN_OPEN_AI_MODEL'de ayarladığınız tam id'ye karşı bir chat completion çalıştırın. Bunlar geçerse, gateway yarısı kanıtlanmıştır ve geri kalan her şey Chatwoot tarafındadır. Ardından yeniden başlatın ve ilk Captain etkileşimini izleyin. Kimlik doğrulama hataları anahtar config'ine işaret eder; model-not-found model config'ine işaret eder; 404 şeklinde hatalar endpoint config'ine yapıştırılan bir /v1'e işaret eder. Captain özellikleri basitçe görünmüyorsa, bu kurulum katmanınızdaki kullanılabilirlik ve lisanslamadır, endpoint yapılandırması değil. Konuşmalar akmaya başladığında, APIsRouter konsolu istek başına modeli, token sayılarını ve harcamayı gösterir. Destek AI'ı aylık biriken bir bütçe kalemidir ve kurulum başına tek bir anahtar, kullanım logunu finans ekibinizin sürekli sorduğu masa başına maliyet raporuna dönüştürür.

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

Sık sorulan sorular