Bu rehberde: Müşteri mesajlarına 7/24 yanıt veren ajanı tanırsınız. Bilgi bankasına nasıl dayandığını, ne zaman insana devrettiğini ve nasıl müşteri adayı topladığını öğrenirsiniz.
⏱ 15 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Tür | CHATBOT |
| Kategori | Mesajlaşma |
| Kutu tipi | agent.chatbot |
| Varsayılan model | claude-sonnet-5 (dengeli) |
| Ekonomik model | claude-haiku-4-5 |
| Rapor | Sohbet başına rapor üretmez; konuşmalar Gelen Kutusu'nda, sayılar Panel ve Analitik'te görünür |
| Önerilen hesaplar | WhatsApp, Telegram |
Ne yapar?
AI Chatbot gelen her mesaj için tek bir yanıt üretir. Yanıtını bilgi bankasına dayandırır: önce belgelerinizde ilgili parçayı bulur, sonra yalnızca o parçaya ve proje bilgisine göre yazar. Aynı kişiyle önceki konuşmayı okur; "az önce sorduğum ürün" gibi göndermeleri anlar.
Her yanıtla birlikte bir niyet (fiyat, sipariş durumu, şikâyet...) ve güven puanı (0-1) üretir. Güven eşiğin altındaysa, kişi açıkça insan isterse ya da konu şikâyet / iade gibi hassassa handoff: true döner. Devir aracı konuşmayı "İnsan" durumuna alır ve ekibe bildirim gönderir.
Bilgi topla açıkken ad, e-posta, telefon gibi bilgileri konuşmanın doğal akışında ister ve Potansiyel Müşteriler sayfasına kaydeder.

Gelen Kutusu'nda ④ Devral dediğinizde bot o konuşmada susar; siz yazarsınız. ⑤ AI yanıt öner size taslak verir. Bota geri ver ile bot devam eder.
Web sohbeti için ayrı hesap gerekmez: sitenize gömdüğünüz widget herkese açık bir adresi çağırır; konuşma "Web sohbeti" kanalıyla Gelen Kutusu'nda görünür.
Girdiler
| Alan | Etiket | Tür | Varsayılan | Açıklama |
|---|---|---|---|---|
persona | Persona | uzun metin | Friendly, concise support & sales assistant | Botun rolü ve tonu. Türkçe yazabilirsiniz: {{ $project.name }} için destek asistanı |
knowledgeBaseId | Knowledge base | bilgi bankası | – | Yanıtların dayanağı. Seçilmezse bot yalnızca proje bilgisiyle yanıt verir |
handoffThreshold | Hand off when confidence below | sayı | 0.4 | Bu güvenin altında insana devir. Satış botlarında 0.3, destek botlarında 0.5 makuldür |
collectLeadInfo | Collect name/email/phone when relevant | açık/kapalı | açık | Uygun anda iletişim bilgisi ister ve aday oluşturur |
workingHours | Human working hours (for handoff message) | metin | – | Örnek: 09:00-18:00 Europe/Istanbul. Mesai dışı devirlerde bot "ekibimiz 09:00'da dönecek" der |
Bu ajanda maks. adım 8-12, bütçe 0.05-0.1 $ yeterlidir. Görev alanı boş kalabilir; kural eklemek için kullanın.
Çıktılar
main çıkışından tek öğe (mesaj başına bir yanıt). Tetikleyiciden gelen conversationId, channel, contactId ve text alanları korunur; şablondaki Mesaj gönder ve İnsana devret kutuları bunları kullanır.
{
"conversationId": "conv_01J...",
"channel": "WHATSAPP",
"contactId": "905321234567",
"text": "iade yapmak istiyorum",
"reply": "Üzgünüm, iade işleminiz için ekibimize aktarıyorum. Mesai saatlerimiz 09:00-18:00; en kısa sürede dönüş yapacağız.",
"intent": "complaint",
"confidence": 0.31,
"leadCaptured": false,
"handoff": true,
"handoffReason": "İade talebi; müşteri fatura bilgisi paylaşmak istiyor"
}
Niyet değerleri: faq, pricing, order_status, appointment, complaint, sales, smalltalk, other. Aday oluşturulduysa leadCaptured: true ve leadId gelir.
Kullandığı araçlar
knowledge_search: bilgi bankasında arama; yanıtın dayanağı.get_conversation_history: aynı kişinin önceki mesajları.create_lead,update_lead: toplanan bilgiyi aday olarak kaydeder.escalate_to_human: konuşmayı insana verir, bildirim gönderir.send_message: ara mesaj ("bir saniye, kontrol ediyorum").web_search: Serper/Tavily bağlıysa. Destek botlarında kapatmanız önerilir; uydurma riskini azaltır.
Gerekli hesaplar
- WhatsApp ve/veya Telegram: mesajı alan ve yanıtı gönderen hesaplar. İkisi de webhook kurulumu gerektirir. Slack, Discord, Messenger ve Twilio SMS de aynı şekilde çalışır.
- Web sohbeti: hesap gerekmez.
- Bilgi bankası: hesap değildir; Bilgi Bankası sayfasından belge, adres veya SSS ekleyin. İndeksleme bitince arama çalışır.
Örnek görev metinleri
- "Müşterinin sorusunu yalnızca bilgi bankasındaki bilgiyle yanıtla. Fiyat, stok veya teslimat tarihi bilmiyorsan uydurma; 'ekibimize soruyorum' de ve devret."
- "Randevu talebi gelirse ad, telefon ve tercih edilen gün-saat al; aday oluştur; ekibin onaylayacağını söyle. Kesin saat sözü verme."
- "{{ $project.name }} adına yaz. Müşteri hangi dilde yazarsa o dilde yanıt ver; mesaj başına en fazla 3 cümle; emoji kullanma."
- "Şikâyet, iade veya fatura konularında tartışmaya girme; özür dile ve devret."
- "Fiyat sorulduğunda bilgi bankasındaki liste fiyatını ver ve kampanya sayfasına yönlendir; indirim pazarlığı yapma."
İpuçları
- Persona alanına rolü, tonu ve sınırları tek paragrafta yazın. Marka sesi zaten projeden gelir; tekrarlamayın.
- Bilgi bankası kalitesi = yanıt kalitesi. SSS'leri soru-cevap belgesi olarak, politikaları (iade, kargo, garanti) ayrı belgeler olarak ekleyin. Tek büyük PDF yerine kısa belgeler daha iyi eşleşir.
- Devir eşiğini ilk hafta 0.5 tutup Gelen Kutusu'ndaki devirleri inceleyin. Gereksiz devir çoksa 0.4'e, yanlış yanıt çoksa 0.6'ya alın.
- Kişisel veri isterken nedenini belirtmesini ve KVKK aydınlatma metnine bağlantı vermesini isteyin.
Rapor
Sohbet Botu her mesajda çalıştığı için rapor üretmez; Raporlar sayfası dolmaz. Konuşmaları Gelen Kutusu'nda, sayıları (açık konuşma, bot çözüm oranı, devredilen konuşmalar) Panel ve Analitik sayfalarında görürsünüz. Haftalık bir özet isterseniz Rapor Yazarı ajanını zamanlanmış bir iş akışıyla çalıştırın.
Maliyet beklentisi
Tek yanıt, 1 bilgi bankası araması + 1 geçmiş okuma (~4K giriş / ~0.4K çıkış token):
| Katman | Model | Yanıt başına | Aylık: 3.000 konuşma × 4 yanıt |
|---|---|---|---|
| Ekonomi | claude-haiku-4-5 | ≈ 0.006 $ | ≈ 72 $ |
| Dengeli (varsayılan) | claude-sonnet-5 | ≈ 0.012 $ | ≈ 144 $ |
| Dengeli (OpenAI) | gpt-5-mini | ≈ 0.002 $ | ≈ 24 $ |
| Amiral gemisi | claude-opus-5 | ≈ 0.03 $ | ≈ 360 $ |
Aylık toplamı plan bütçenizle karşılaştırın (FREE 5 $, STARTER 50 $, PRO 400 $). SSS ağırlıklı botlarda ekonomi model yeterlidir. Şablonun iş akışı bütçesi mesaj başına 0.5 $; kutu bütçesini 0.1 $'a çekebilirsiniz.
İş akışında kullanım
WhatsApp ve Telegram yapay zekâ sohbet botu şablonu:
Mesaj geldi (WhatsApp, Telegram)
→ AI Chatbot (persona, bilgi topla: açık, eşik 0.4)
→ Eğer ({{ $json.handoff === true }})
true → İnsana devret (konuşma, neden, bildir [inapp, email])
false → Mesaj gönder (kanal {{ $json.channel }}, alıcı {{ $json.contactId }}, metin {{ $json.reply }})
Devir dalında müşteriye de mesaj gitmesi için devir kutusundan sonra ikinci bir Mesaj gönder ekleyin; ajan devir durumunda da kibar bir yanıt üretir.
Diğer kalıplar:
- Mesaj geldi (yalnızca yeni konuşmalar) → Chatbot → Eğer (aday oluştu) → CRM'e yaz.
- Mesaj geldi → Sınıfla (satış / destek / spam) → Anahtar → farklı persona ve bilgi bankasıyla iki Chatbot.
- Platform olayı (konuşma devredildi) → Bildir (Slack).

Sık karşılaşılan sorunlar
| Sorun | Neden | Çözüm |
|---|---|---|
| Bot yanıt vermiyor | Konuşma "İnsan" durumunda veya webhook gelmiyor | Gelen Kutusu'nda Bota geri ver; entegrasyon kartında webhook adresini ve doğrulama token'ını kontrol edin |
| Yanıtlar bilgi bankasıyla çelişiyor | Bilgi bankası seçilmemiş veya belgeler indekslenmedi | Kutuda seçin; Bilgi Bankası sayfasında durumu bekleyin |
| Çok sık devrediyor | Eşik yüksek veya bilgi bankası eksik | Eşiği düşürün; Gelen Kutusu'nda devredilen sorulara bakıp yanıtlarını bilgi bankasına ekleyin |
| WhatsApp'ta yanıt gitmedi | 24 saat penceresi kapanmış | Pencere dışında şablon gerekir; bkz. WhatsApp şablonları |
| Aday oluşmuyor | Bilgi topla kapalı | Ayarı açın; görevde hangi bilgilerin isteneceğini yazın |
| Aylık bütçe uyarısı | Hacim yüksek | Ekonomi model; maks. adım ve bütçeyi düşürün |
Sık sorulan sorular
Bot müşteriye yanlış bilgi verirse? Bilgi bankası dışına çıkmaması için persona ve göreve "bilmiyorsan devret" yazın. Web aramasını kapatın. Devirleri haftalık inceleyip eksik belgeleri ekleyin.
Müşteri insanla konuşmak istediğini nasıl belirtir? "Bir yetkiliyle görüşmek istiyorum" gibi ifadeleri bot algılar ve devreder. Eşikten bağımsızdır.
Mesai dışında ne olur? Bot yanıt vermeye devam eder. Devir gerekirse Çalışma saatleri alanına göre "ekibimiz sabah dönecek" der.