Telegram Entegrasyonu

Telegram Bot API ile müşterilerinizle Telegram üzerinden iletişim kurun.

Gereksinimler

Telegram entegrasyonu için:

• Telegram hesabı
• BotFather'dan alınmış bot token'ı

Bot Oluşturma

1. BotFather ile Bot Oluşturma

1. Telegram'da @BotFather'ı arayın
2. /newbot komutunu gönderin
3. Bot için bir isim girin
4. Bot için bir kullanıcı adı belirleyin (sonu bot ile bitmeli)
5. Verilen API Token'ı kopyalayın

2. DOLU.ai'ye Bağlama

1. Ayarlar > Kanallar > Telegram'a gidin
2. Telegram Bağla butonuna tıklayın
3. BotFather'dan aldığınız token'ı yapıştırın
4. Bağla butonuna tıklayın

Bot Ayarları

Profil Ayarları

BotFather ile bot profilini düzenleyin:

• /setdescription - Bot açıklaması
• /setabouttext - Hakkında metni
• /setuserpic - Profil fotoğrafı
• /setcommands - Mevcut komutlar

Komutlar

Bot için komutlar tanımlayabilirsiniz:

start - Sohbeti başlat
help - Yardım al
menu - Ana menü
info - Bilgi al

Mesaj Türleri

Desteklenen İçerikler

Tür	Gönder	Al
Metin	Evet	Evet
Resim	Evet	Evet
Video	Evet	Evet
Ses	Evet	Evet
Belge	Evet	Evet
Konum	Evet	Evet
Kişi	Evet	Evet
Sticker	Hayır	Evet

Inline Butonlar

Mesajlara tıklanabilir butonlar ekleyin:

{
  "inline_keyboard": [
    [
      {"text": "Sipariş Ver", "callback_data": "order"},
      {"text": "Destek", "callback_data": "support"}
    ],
    [
      {"text": "Web Sitesi", "url": "https://dolu.ai"}
    ]
  ]
}

Reply Keyboard

Kullanıcıya seçenekler sunun:

{
  "keyboard": [
    ["Sipariş Takibi", "Yeni Sipariş"],
    ["Yardım", "İletişim"]
  ],
  "resize_keyboard": true
}

Grup ve Kanal Desteği

Grup Mesajları

Bot'u gruplara ekleyebilirsiniz:

1. Bot'u gruba ekleyin
2. Yönetici izinleri verin
3. Grup mesajlarını Inbox'ta görüntüleyin

Kanal Yönetimi

Telegram kanallarınızı yönetin:

• Kanala yayın gönderin
• Yorum okuyun
• Anketler oluşturun

Otomatik Yanıtlar

Karşılama Mesajı

/start komutuna otomatik yanıt:

Merhaba! DOLU.ai Telegram Bot'una hoş geldiniz.

Menüyü görmek için /menu yazabilirsiniz.
Yardım almak için /help yazabilirsiniz.

AI Agent

Telegram'da AI Agent aktif olabilir:

• Doğal dil sorularını anlar
• Bilgi bankasından yanıtlar
• Kompleks konularda insana aktarır

Bildirimler

Telegram üzerinden bildirimler gönderin:

• Sipariş güncellemeleri
• Randevu hatırlatıcıları
• Kampanya duyuruları

Webhooks

Telegram bot'unuz şu olayları tetikler:

• message - Yeni mesaj geldi
• callback_query - Buton tıklandı
• chat_member - Üyelik değişti

API Kullanımı

# Mesaj gönderme
POST /api/v1/messages/telegram
{
  "chatId": "123456789",
  "message": "Merhaba!"
}

# Butonlu mesaj
POST /api/v1/messages/telegram
{
  "chatId": "123456789",
  "message": "Bir seçenek seçin:",
  "inlineKeyboard": [
    [{"text": "Seçenek 1", "callbackData": "opt1"}]
  ]
}

Sorun Giderme

Bot Yanıt Vermiyor

• Token'ın doğru olduğunu kontrol edin
• Webhook URL'inin erişilebilir olduğundan emin olun
• Bot'un engellenmediğini kontrol edin

Mesajlar Gecikmeli

• Webhook durumunu kontrol edin
• Sunucu yanıt süresini kontrol edin

Butonlar Çalışmıyor

• Callback data'nın doğru formatta olduğundan emin olun
• Bot'un yeterli yetkiye sahip olduğundan emin olun

En İyi Uygulamalar

1. Komutları kullanın: Kullanıcılara rehberlik edin
2. Butonlar ekleyin: Etkileşimi kolaylaştırın
3. Hızlı yanıt verin: Kullanıcılar anında yanıt bekler
4. Bildirimler: Spam yapmadan bilgilendirin
5. Grupları yönetin: Topluluk oluşturun

SSS

S: Bir Telegram bot'unu birden fazla DOLU.ai hesabıyla kullanabilir miyim? C: Hayır. Her Telegram bot token'ı yalnızca bir DOLU.ai hesabına bağlanabilir. Aynı token'ı ikinci bir hesaba bağlamaya çalışırsanız ilk hesaptaki bağlantı kopar. Birden fazla hesap için ayrı bot'lar oluşturmanız gerekir.

S: Telegram gruplarından gelen mesajları Inbox'ta görebilir miyim? C: Evet, bot'unuzu bir gruba ekleyip yönetici izni verdiğinizde grup mesajları Inbox'ta görünür. Ancak bot yalnızca / komutuyla veya doğrudan etiketlenerek (@botadi) gönderilen mesajları alır; gruptaki tüm mesajları görmez (privacy mode aktifse). Tüm mesajları almak için BotFather'da privacy mode'u kapatmanız gerekir.

S: Telegram bot'uma özel komutlar ekleyebilir miyim? C: Evet. BotFather'da /setcommands komutuyla bot'unuza özel komutlar tanımlayabilirsiniz. DOLU.ai tarafında ise Otomasyonlar modülünden her komut için tetikleyici oluşturarak otomatik yanıtlar veya iş akışları tanımlayabilirsiniz. Örneğin /siparis komutu geldiğinde sipariş takip formunu gönderebilirsiniz.

S: Telegram üzerinden toplu mesaj (broadcast) gönderebilir miyim? C: Evet. Kampanyalar modülünden Telegram kanalı seçerek broadcast listenizdeki kişilere toplu mesaj gönderebilirsiniz. Ancak Telegram'ın spam politikalarına dikkat edin; çok sayıda bilinmeyen kullanıcıya mesaj göndermek bot'unuzun engellenmesine yol açabilir. Yalnızca bot'unuzla daha önce iletişim kurmuş kişilere gönderim yapmanız önerilir.