Telegram
Telegram kanalıyla agent'ınız, kendi Telegram botunuza yazan kişilere yanıt verir. Botu Telegram'da @BotFather ile oluşturursunuz, token'ını Peki paneline yapıştırırsınız ve yayındaki agent yanıt vermeye başlar. Konuşmalar diğerleri gibi Inbox'ta görünür.
Aynı bot, automation mesajlarını ve onay bildirimlerini de ekibinize taşır. Bkz. Automations ve Onaylar.
Bir bot bağlayın
1. Botu Telegram'da oluşturun
- Telegram'da @BotFather'ı (mavi onay işaretli resmi bot) açın ve
/newbotgönderin. - Bir görünen ad seçin; örneğin "Moda Diş Asistanı". Müşteriler bunu sohbet listelerinde görür.
botile biten bir kullanıcı adı seçin; örneğinmodadis_bot. Telegram'da benzersiz olmalıdır. Botunuzun bağlantısı olur:t.me/modadis_bot.- BotFather
123456789:AAH…gibi görünen bir token ile yanıt verir. Onu kopyalayın.
Token botunuzun anahtarıdır. Ona sahip olan herkes botunuzun mesajlarını okuyup gönderebilir. Yalnızca Peki paneline yapıştırın, asla bir sohbete değil (bir Copilot mesajına yapıştırırsanız Peki onu çıkarır ve Telegram kartını kullanmanızı ister).
İsterseniz BotFather'dayken bota bir resim (/setuserpic), bir açıklama (/setdescription) ve bir hakkında metni (/setabouttext) ekleyin. Müşteriler bunları sohbete başlamadan önce görür.
2. Peki panelinde bağlayın
- Agent'ı açın ve Channels → Telegram'a gidin.
- Token'ı Bot token alanına yapıştırın ve Bağla'ya basın. Peki token'ı Telegram ile doğrularken düğmede Kontrol ediliyor… yazar.
- Kabul edildiğinde kartta botunuz
@botunuzun_adiolarak görünür ve Bu bota gelen mesajları yanıtla açılır.
Copilot'tan da bağlayabilirsiniz: ondan Telegram'ı bağlamasını isteyin, aynı adımlarla bir Telegram'ı bağla kartı gösterir. Copilot token'ı hiç görmez.
Token şifreli saklanır ve bir daha, size bile, gösterilmez. Yaklaşık 10 saniye içinde bot yanıt vermeye başlar.
3. Yayınlayın ve deneyin
Müşteriler her zaman yayınlanmış sürümle konuşur. Agent henüz yayınlanmadıysa kart bunu söyler ve bot herkese "Bu asistan henüz kullanılamıyor." yanıtını verir. Bkz. Yayınlama ve sürümler.
t.me/botunuzun_adi bağlantısını açın (bağlantı kartta), Başlat'a basın ve bir mesaj yazın.
Biri botunuzu ilk kez açtığında Telegram'ın gönderdiği /start, agent'a diğer mesajlar gibi iletilir. "Müşteri /start gönderdiğinde onu selamla ve nelerde yardımcı olabileceğini söyle." gibi kısa bir talimat, yeni müşterilere iyi bir ilk yanıt sağlar. Bkz. Instructions.
Ayarlar
| Ayar | Ne yapar | Varsayılan |
|---|---|---|
| Bot token | @BotFather'dan aldığınız token. Kaydedilmeden önce Telegram ile doğrulanır. Yeni bir token yapıştırmak eski botun yerini alır. | Yok |
| Bu bota gelen mesajları yanıtla | Kapalıyken bot yanıt vermeyi bırakır; token saklanır. Açıkken yayındaki agent yeniden yanıt verir. | Bağlandıktan sonra açık |
Kartın başlığının yanındaki durum bağlı değil, Açık ya da Kapalı olur.
Neler desteklenir
| Özellik | Nasıl çalışır |
|---|---|
| Özel sohbetler | Bot yalnızca birebir sohbetlere yanıt verir. Gruplardaki ve kanallardaki mesajlar yok sayılır. Diğer botlardan gelen mesajlar yok sayılır. |
| Metin | Telegram'ın kendi sınırlarına kadar. Agent'ın yanıtları biçimini korur (kalın, italik, kod, bağlantılar); listeler ve tablolar Telegram'ın gösterebileceği satırlara dönüştürülür. Tek bir Telegram mesajından uzun yanıtlar paragraflar arasından bölünür. |
| Fotoğraflar ve belgeler | Fotoğraflar (Telegram'daki en büyük boyut), PDF'ler ve metin dosyaları (TXT, MD, CSV), en fazla 10 MB. Açıklama (caption) mesaj olur. Bkz. Dosyalar ve ekler. |
| Desteklenmeyen medya | Sesli mesajlar, ses dosyaları, videolar, görüntülü mesajlar, çıkartmalar ve GIF animasyonları "Bu tür dosyaları henüz açamıyorum. Lütfen bir fotoğraf, PDF ya da metin dosyası gönderin veya mesajınızı yazın." yanıtını alır. Hiçbir şey saklanmaz. |
| Yazıyor göstergesi | Agent çalışırken bot "yazıyor…" gösterir. |
/new | Yeni bir konuşma başlatır. Bot "Yeni bir konuşma başladı. Nasıl yardımcı olabilirim?" yanıtını verir. |
/feedback | Agent yanıt verdiyse 👍 ve 👎 düğmeleriyle "Bu konuşma size yardımcı oldu mu?" diye sorar. Aksi halde: "Henüz değerlendirilecek bir şey yok." Bir değerlendirmeyi değiştirmek için yeniden gönderin; sonuncusu geçerli olur. |
| Çözülünce geri bildirim | Ekibiniz, son mesajı agent'ın yazdığı bir konuşmayı çözüldü olarak kapattığında bot 👍/👎 ister. Değerlendirmeler Analytics'te görünür. |
| Ekip yanıtları | Bir ekip arkadaşınız devraldığında mesajları ve dosyaları bottan gider. |
| Müşteri profili | Kişinin Telegram'daki adı, @kullaniciadi ve uygulama dili müşteri profiline yazılır. |
Botun komut menüsünde /new ve /feedback bulunur; Telegram'ı Türkçe olanlar için Türkçe, diğerleri için İngilizce. Peki bunu bot her başladığında ayarlar.
Botun kendi kısa mesajları (yoğunluk, kullanılamıyor, dosya reddedildi vb.) Telegram uygulaması Türkçe olanlar için Türkçe, diğer herkes için İngilizcedir. Agent'ın yanıtları ise müşterinin yazdığı dili izler.
Telegram'da oturumlar
Telegram'da "yeni sohbet" düğmesi yoktur; bu yüzden bir sohbet süreye göre konuşmalara bölünür: bir mesaj, konuşma çözülmediyse, kişi /new göndermediyse ya da konuşma agent'ın Yeni oturum başlat: ayarından (varsayılan 24 saat) uzun süre sessiz kalmadıysa mevcut konuşmaya devam eder. Bkz. Müşteriler.
Ekibinize giden mesajlar
Ekibiniz de aynı bottan mesaj alabilir:
- Automation mesajları. Bir automation Telegram'dan kişilere mesaj atabilir. Bir ekip arkadaşınız
t.me/botunuzun_adi?start=alertsbağlantısını açıp Başlat'a basarak agent'ın sohbetlerine katılır; bot "Bu agent'ın uyarılarını burada alacaksınız." yanıtını verir. Bkz. Automations. - Onay bildirimleri. Onay bekleyen işlemler, Inbox → Onaylar → Telegram'da bildir altında seçtiğiniz Telegram sohbetlerine duyurulabilir. Bkz. Onaylar.
Bir bot, bir agent
Bir bot aynı anda tek bir agent için yanıt verir.
- Bu çalışma alanında başka bir agent'a bağlıysa: Peki "Bu bot agent ajanına bağlı. Buraya taşınsın mı?" diye sorar. Taşımak için Buraya taşı'ya basın. Diğer agent Telegram'da yanıt vermeyi bırakır; konuşmaları onun Inbox'ında kalır.
- Başka bir çalışma alanında bağlıysa: token "This bot is in use elsewhere. If it's yours, renew its token with BotFather (/revoke) and connect the new token." uyarısıyla reddedilir.
İki agent'ı Telegram'da çalıştırmak için her biri için bir bot oluşturun.
Peki botunuzun mesajlarını Telegram'a sorarak alır (polling); bu yüzden bir sunucuya ya da herkese açık bir adrese ihtiyacınız yoktur. Bir bot bağlamak, varsa onun webhook'unu kaldırır; böylece bot aynı anda başka bir sistemi besleyemez.
Bağlantıyı kesmek
- Channels → Telegram'a gidin.
- Botun bağlantısını kes'e basın ve onaylayın: "Agent bu bota yanıt vermeyi bırakır. Token silinir."
Bot yaklaşık 10 saniye içinde yanıt vermeyi bırakır. Konuşmaları Inbox'ta kalır. Botun kendisi Telegram'da var olmaya devam eder: artık ihtiyacınız yoksa @BotFather'da /deletebot ile silin.
Token'ı kaybetmeden botu duraklatmak için bunun yerine Bu bota gelen mesajları yanıtla'yı kapatın.
Agent'ı silmek de botunun bağlantısını keser.
Sorun giderme
| Sorun | Nedeni ve ne yapmalı |
|---|---|
| "That does not look like a bot token. Copy it again from @BotFather." | Metin token biçiminde değil (rakamlar, iki nokta, sonra uzun bir kod). Token'ın tamamını, boşluk olmadan yeniden kopyalayın. |
| "Telegram didn't accept this token (Unauthorized). Copy it again from @BotFather." | Token yanlış ya da iptal edilmiş. Güncel token'ı @BotFather'dan /token ile, yenisini /revoke ile alın. |
| Bot yanıt vermiyor | Kartta Açık yazdığını, agent'ın yayınlandığını ve bir grupta değil botla özel sohbette yazdığınızı kontrol edin. Değişiklikler yaklaşık 10 saniye sürer. |
| Bot "Bu asistan henüz kullanılamıyor." yanıtını veriyor | Agent yayınlanmamış. Yayınlayın. |
| Kartta "Bu bot başka bir yerde de kullanılıyor (başka bir sunucu ya da uygulama)." uyarısı var | Başka bir program aynı botun mesajlarını okuyor; bazı mesajlar Peki yerine oraya gidebilir. Bu siz değilseniz @BotFather'da /revoke çalıştırın ve yeni token'ı bağlayın. |
| BotFather'da bir şey değiştirdikten sonra bot yanıt vermeyi bıraktı | Token'ı iptal ettiyseniz eskisi artık çalışmaz. Yeni token'ı bağlayın. |
| "This bot is in use elsewhere…" | Bot başka bir Peki çalışma alanında bağlı. Bot sizinse token'ını @BotFather'da iptal edin ve yenisini burada bağlayın. |
| Müşteriler "Şu anda çok yoğunuz. Lütfen biraz sonra tekrar yazın." alıyor | Bir sohbet bir dakikada 20'den fazla mesaj gönderdi ya da çalışma alanınız günlük yanıt sınırına ulaştı. |
| Bir dosya reddedildi | Dosyalar ve ekler'deki kurallara bakın. Dosyalar en fazla 10 MB'lık fotoğraf, PDF ya da metin dosyası olmalı. |
| "Bu dosyayı indiremedim. Lütfen tekrar gönderin." | Telegram birkaç denemeye rağmen dosyayı vermedi. Müşteriden dosyayı yeniden göndermesini isteyin. |