Bu rehberde: Müşteri mesajlarına 7/24 yanıt veren, müşteri bilgisi toplayan ve gerektiğinde size devreden bir yapay zekâ chatbot'unu baştan sona kurarsınız. Yedi adım.
⏱ 45 dakika
Genel akış
- Müşteri WhatsApp veya Telegram'dan yazar.
- Mesaj OrqLabs'a gelir ve Gelen Kutusu'nda konuşma açılır.
- AI Chatbot bilgi bankanıza bakıp yanıt hazırlar.
- Emin ise yanıtı gönderir. Emin değilse konuşmayı size devreder.
- Siz devraldığınızda bot susar; işiniz bitince botu geri açarsınız.
1. Kanalları bağlayın
- WhatsApp: WhatsApp Business (Cloud API). Phone Number ID, WABA ID, kalıcı anahtar; webhook doğrulaması ve
messagesaboneliği. - Telegram: Telegram Bot. @BotFather anahtarı; webhook otomatik.
- İsteğe bağlı: Slack, Discord, Messenger, Twilio SMS, web sohbeti (aşağıda).
Her kanal iş akışının projesine bağlı olmalıdır. Telefonunuzdan mesaj gönderin; Gelen Kutusu'nda konuşma oluşmalı.
2. Bilgi bankası oluşturun
Bilgi bankası, botun yanıtlarını dayandıracağı belgelerdir. Sol menüden Bilgi Bankası → Yeni bilgi bankası → ad ve proje.
① Belgeleri ekleyin:
| Tür | Ne için | Örnek |
|---|---|---|
| SSS | Soru-cevap çiftleri; en yüksek isabet | "Kargo kaç günde gelir?" → "İstanbul içi 1, diğer iller 2-3 iş günü." |
| Metin | Politikalar, ürün açıklamaları, fiyat listesi | İade koşulları, abonelik planları |
| Adres | Web sayfası (metin çıkarılır) | Ürün sayfaları, SSS sayfası |
| Dosya | PDF, DOCX, TXT, MD | Katalog, kullanım kılavuzu |
② Belgeler işlenir ve İndekslendi durumuna geçer. Bunun için bir OpenAI anahtarı (platform veya sizin) gerekir.
③ Ara sekmesinde deneyin: "iade süresi ne?" sorusuna doğru parça dönüyorsa hazırsınız.
İpucu: Kısa ve tek konulu belgeler tek büyük PDF'ten daha iyi eşleşir. Güncel fiyatlar ve "bilmiyorsak ne yapılacağı" notunu ekleyin.
Plan limiti: FREE 10, STARTER 100, PRO 1.000 belge.
3. Şablonu kurun
- Şablonlar → WhatsApp ve Telegram yapay zekâ sohbet botu → Şablonu kullan → ad ve proje → Oluştur.
Şablonun kutuları:
| Kutu | Ne yapar |
|---|---|
Message received (trigger.messageReceived) | WhatsApp ve Telegram mesajlarını dinler |
AI Chatbot (agent.chatbot) | Yanıt üretir; persona "Friendly support & sales assistant for {{ $project.name }}", bilgi topla açık, devir eşiği 0.4 |
İnsan gerekli mi? (logic.if) | {{ $json.handoff === true }} |
Hand off (messaging.handoff) | Konuşmayı insana verir, bildirim [inapp, email] |
Send reply (messaging.send) | Yanıtı aynı kanala gönderir |
Ayar: çalıştırma başına bütçe 0.5 $.
4. Chatbot'u ayarlayın
AI Chatbot kutusuna tıklayın:
| Alan | Öneri |
|---|---|
| Persona | Türkçe yazın: "Kahve Durağı'nın samimi, kısa cevaplar veren destek ve satış asistanı. Emin olmadığında tahmin etme, insana yönlendir." |
| Knowledge base | 2. adımdaki bilgi bankası |
| Hand off when confidence below | 0.4; çok sık devrediyorsa 0.3, az devrediyorsa 0.5 |
| Collect name/email/phone | Açık: uygun anda iletişim bilgisi ister, aday oluşturur |
| Human working hours | 09:00-18:00 Europe/Istanbul: devir mesajı "mesai saatlerinde döneceğiz" olur |
| Görev | İsteğe bağlı: "Fiyat sorularında fiyat listesini kullan, kampanya uydurma." |
| Model ③ | Yüksek hacimde ekonomi (claude-haiku-4-5, gpt-5-mini) |
| Maks. araç adımı ④ | 8-12 |
| Rapor kaydet ④ | Kapalı; her mesajda rapor oluşmasın |
Devir tetikleyicileri: güven eşiğin altında; müşteri "insan/temsilci/yetkili" istiyor; şikâyet, iade, hukuki konu; bilgi bankasında karşılık yok.
5. Test edin ve yayına alın
- Kaydet → Doğrula.
- Test: tetikleyici örnek bir mesajla ateşlenir ("Merhaba, fiyat listesi alabilir miyim?"). Gönderim kutusu kuru çalışır; yanıtı Çıktı sekmesinde görürsünüz.
- Etkinleştir. Kendi telefonunuzdan gerçek mesaj gönderin; yanıt gelmeli.
- "Bir yetkiliyle konuşmak istiyorum" yazın; konuşma "İnsan" olmalı ve bildirim gelmeli.
- Gelen Kutusu'ndan yanıtlayın, sonra Bota geri ver.
6. Web sohbeti
Sitenize gömülü sohbet için ayrı hesap gerekmez. Web sohbeti uç noktası (POST /orgs/:orgId/webchat/:projectId/messages) hazırdır; gelen mesajlar "Web sohbeti" kanalında konuşma açar ve projenin chatbot'u yanıtlar. Panelden kopyalanabilir hazır widget kodu henüz yok; şimdilik geliştiriciniz bu uç noktayla sitenize bir sohbet kutusu ekleyebilir.
Geliştirici notu: Herkese açık uç nokta:
POST https://api.orqlabs.com/api/v1/orgs/<orgId>/webchat/<projectId>/messages { "sessionId": "<uuid>", "text": "Merhaba" } → { "reply": "…" }.
7. İzleme
- Gelen Kutusu istatistikleri: açık, bot, insan, ilk yanıt süresi, bot çözüm oranı.
- Metrikler (İstatistik gezgini, kanal kırılımı): gelen/giden mesaj, bot yanıtı, açılan konuşma, devir, bot çözümü.
- Rapor: haftalık içgörü için Report Writer kullanın.
- Bildirimler: devir olayı uygulama içi + e-posta; Slack için Hand off kutusunun bildirim listesine
slackekleyin.
Maliyet ve limitler
Yanıt başına ~4K giriş / ~0.4K çıkış token: gpt-5-nano ≈ 0.0004 $, claude-haiku-4-5 ≈ 0.006 $, claude-sonnet-5 ≈ 0.012 $. Aylık 12.000 yanıt → Haiku ≈ 72 $, Sonnet ≈ 144 $.
Aylık konuşma limiti: FREE 200, STARTER 3.000, PRO 30.000. WhatsApp'ta 24 saat penceresi dışında şablon gerekir (WhatsApp şablonları).
Sorun giderme
| Belirti | Neden | Çözüm |
|---|---|---|
| Mesaj geliyor, yanıt gitmiyor | Kanal ifadesi çözülmedi veya 24 saat penceresi | Çıktıyı inceleyin; WhatsApp'ta şablon |
| Bot uyduruyor | Bilgi bankası yok/eksik | Belge ekleyin; persona'ya "bilmiyorsan yönlendir" |
| Her mesajda devir | Eşik yüksek, bilgi bankası boş | 0.3; belgeler |
| İnsan devraldı ama bot yanıtlıyor | Farklı konuşma (başka kanal) | Gelen Kutusu'nda durumu kontrol edin |
| Aday oluşmuyor | Bilgi topla kapalı | Açın |
| İndeksleme takıldı | OpenAI anahtarı yok | Platform veya BYOK OpenAI |
| Yanıt yavaş | Amiral gemisi model, yüksek derinlik | Ekonomi model, düşük derinlik |
Sık sorulan sorular
Bot hangi dilde yanıt verir? Müşteri hangi dilde yazarsa. Personada "Türkçe yanıt ver" diyerek sabitleyebilirsiniz.
Mesai dışında ne olur? Bot yanıt vermeye devam eder. Devir gerekirse "ekibimiz sabah dönecek" der.
Aynı bot WhatsApp ve Telegram'da mı çalışır? Evet. Tek iş akışı iki kanalı da dinler ve yanıtı geldiği kanala gönderir.