Kanallar
Kanallar, insanların zaten kullandığı mesajlaşma uygulamalarından çalışma alanınıza ulaşmasını sağlar. Her kanal, bir kez bağladığınız ve ardından Ayarlar → Kanallar altından (yalnızca yönetici) yönettiğiniz ayrı bir örnektir (instance).
Altyapı jeneriktir ve çok-örneklidir: aynı türden birden çok kanal bağlayabilirsiniz — örneğin bir "Satış" Telegram botu ve bir "Destek" Telegram botu ya da iki WhatsApp numarası — ve her birini farklı bir departmana bağlayabilirsiniz. Telegram, WhatsApp, Messenger ve Instagram bugün kullanılabilir.
Bir Telegram botu bağlama
- Telegram'da @BotFather ile bir sohbet açıp bir bot oluşturun
(
/newbot). BotFather size123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11biçiminde bir bot token verir. - Yönetici panelinde Ayarlar → Kanallar'a gidin ve Kanal ekle'ye tıklayın.
- Telegram'ı seçin, kanala bir ad verin (örn. "Satış Botu"), bot token'ı yapıştırın ve isteğe bağlı olarak bir departman seçin.
- Kaydet'e tıklayın. Token'ı Telegram ile doğrular, botun
@usernamebilgisini saklar ve gelen webhook'u otomatik kaydederiz.
Bot token şifreli saklanır ve bir daha gösterilmez — listede yalnızca son 4 karakter görünür. Token'ı değiştirmek için kanalı silip yeniden oluşturun.
Birden çok bot, birden çok departman
Çalışma alanı başına tek bot sınırı yoktur. İhtiyacınız kadar bağlayın ve her birine kendi adını verin. Bir kanala bağladığınız departman, o kanaldan gelen her yeni konuşma tarafından devralınır; böylece örneğin "Satış" botunuzu Satış departmanına, "Destek" botunuzu Destek'e yönlendirebilirsiniz.
Webhook ve genel-URL gereksinimi
Telegram, gelen mesajları sunucunuzdaki bir webhook URL'sini çağırarak iletir. Kanal satırı bu URL'yi bir kopyala düğmesiyle birlikte gösterir.
Telegram yalnızca genel (public) bir HTTPS URL'sini kabul eder. Üretimde bu,
kanalı bağladığınızda otomatik olarak kaydedilir. Yerel / geliştirme
ortamında URL localhost'u gösterir; Telegram buna ulaşamaz — bu nedenle
uygulama genel bir adrese yayınlanana kadar webhook başarısız görünür. Bu
beklenen bir durumdur: kanal yine de oluşturulur ve bot token geçerlidir.
Uygulama genel bir URL'de erişilebilir olduğunda, kanaldaki Webhook'u yeniden
dene'ye tıklayın.
Webhook kanala özel bir gizli anahtarla korunur: yalnızca eşleşen gizli anahtarı taşıyan gelen çağrıları kabul ederiz; böylece başka kimse o URL üzerinden çalışma alanınıza mesaj gönderemez.
Gelen bir mesajda ne olur
Biri botunuza mesaj attığında:
- kişi bir contact ile eşleştirilir (yeni biri lead olur), Telegram kimliğiyle anahtarlanır;
- botun kanalında, kanalın departmanını devralan bir konuşma açılır;
- mesaj, web-sohbet mesajı gibi gelen kutunuza düşer — AI asistanınız yanıtlayabilir, ajanlar bilgilendirilir ve ekibinizin (veya botun) gönderdiği yanıtlar doğrudan kişiye Telegram üzerinden iletilir.
Engellenen kişiler her yerdeki gibi ele alınır: mesajları sessizce saklanır ve asla otomatik yanıt almaz.
Bot ayarları: menü, açıklamalar ve düğme
Ayarlar → Kanallar → Telegram botunuz → Bot ayarları ekranı, Telegram'ın insanlara gösterdiği şeyi düzenler. Buradaki her şey Telegram'a gönderilir ve müşterileriniz tarafından okunur — iç yapılandırma değildir.
Komut menüsü. Her satır bir /komut ve yanındaki etiket. O etiket,
müşteri / yazdığında Telegram'ın açtığı listede okuduğu açıklamadır — size not
değil, ona açıklama. Adlarda yalnız küçük harf, rakam ve alt çizgi kullanılabilir.
Her komutun bir de yanıtı var. Müşteri komutu çalıştırdığında bot o yanıtı gönderir — birden fazla dil doldurduysanız müşterinin kendi dilinde. Yanıtı tanımlanmamış bir komut sıradan metin gibi davranır ve asistana gider.
Üç komut her botta tanımlanmaya değer, çünkü Telegram onları bekliyor ve uygulamaları bunlara kısayol veriyor:
| Komut | İnsanların beklediği |
|---|---|
/start | Biri sohbeti ilk açtığında, daha hiçbir şey yazmadan otomatik gönderilir |
/help | Botun ne yapabildiği. Yanıt tanımlanmamışsa kendi komut menünüzü geri okuruz |
/settings | Müşterinin değiştirebileceği şeyler |
Açıklama, boş sohbet ekranındaki metindir; ilk mesajdan önce okunur. Hakkında, bot profilindeki daha kısa satırdır ve biri botu paylaştığında onunla birlikte gider. Menü düğmesi ise metin kutusunun yanında duran şeydir: komut listesi ya da bir web uygulaması.
Telefon numarası ya da konum isteme
Telegram, müşterinin tek dokunuşla paylaştığı bir telefon numarasını size verebilir — üstelik Telegram'ın doğruladığı bir numara, müşterinin yazdığı değil. O numara, çoğu zaman bir Telegram müşterisini CRM'inizdeki aynı kişiye bağlayan tek şeydir; çünkü Telegram'ın verdiği kimlik başka hiçbir şeyle eşleşmez.
Temsilciler bunu yazma alanının paylaşım menüsünden gönderir, asistan da isteyebilir. Müşteri klavyesi yerine tek bir düğme görür ve gelen numara kişi kartına düşer. Mevcut bir numaranın üzerine asla yazılmaz.
Aynısı konum için de geçerli. E-posta bu listede yok: Telegram'ın tek-dokunuş e-posta düğmesi yok, o yüzden sözle sorarsınız ve müşteri yazar.
Gruplar
Bir Telegram botu gruplara eklenebilir ve Telegram varsayılan olarak ona yalnız açıkça kendisine yönelik mesajları gösterir — kendisine hitap eden bir komut ya da söylediği bir şeye verilen yanıt. Yönetici olarak eklenirse her şeyi görür.
Bir botu gruba koymadan önce bilinmesi gereken iki şey:
- Grup konuşması gelen kutunuza oda başına tek bir konuşma olarak düşer, katılımcı başına değil; kimin konuştuğu her mesajın üstünde gösterilir.
- Asistan gruplarda sessiz kalır, o kanal için ayrıca açmadıkça. Bu bilinçli: odadaki her satıra cevap veren bir bot gürültüdür ve her seferinde bir model çağrısına mal olur.
Botunuzun gruplarda işi yoksa bunu kaynağında kapatın: @BotFather'a
/setjoingroups gönderip devre dışı bırakın. Tek bir anahtar, ve sonuçlarını
sonradan yönetmekten temizdir.
Yalnız @BotFather'da yaşayan ayarlar
Panel komut menüsünü, iki açıklamayı ve menü düğmesini yönetir. Telegram geri kalanını kendine saklıyor — API'si yok, dolayısıyla hiçbir panel sunamaz. Bunlardan birini arıyorsanız @BotFather'dadır, arıza değildir:
- Gizlilik ve gruplar —
/setprivacy,/setjoingroups. Gizlilik değişikliği ancak bot gruptan çıkarılıp yeniden eklendiğinde geçerli olur. - Kimlik —
/setuserpic(ve profil videosu), açıklama resmi/videosu, giriş widget'ı için/setdomain. - Inline mod —
/setinline,/setinlinegeo,/setinlinefeedback. - Modlar — Secretary, Bot Management, Bot-to-Bot Communication, Guest.
- Mini uygulamalar — Main Mini App, açılış ekranı, önizleme görselleri.
- Geri alınamazlar —
/token,/deletebot, sahiplik devri.
Kanalınızı bozacak şeyler
- Token'ı yenilemek (
/token) bizdeki token'ı geçersiz kılar. Kanalı yeni token'la yeniden bağlayana kadar gönderim durur. /deletebotgeri alınamaz ve kullanıcı adı serbest bırakılır.- Sahiplik devri kalıcıdır ve konuşmaları da devreder. Yeni sahip, müşterilerinizin bota yazdıklarını okuyabilir. Bunu birine gelen kutunuzu vermek gibi düşünün, çünkü olan tam olarak budur.
- Telegram Ads gelir paylaşımı, reklamları botunuzla olan sohbetin içine koyar. Bot sizin, karar sizin — ama reklamlar bir destek konuşmasının içinde görünür ve müşteri onları sizden geliyor sanır.
Her Telegram kanalını saatlik kontrol ediyor ve webhook'un sağlıklı olup olmadığını doğrudan Telegram'a soruyoruz. Değilse kanal satırı bunu Telegram'ın kendi gerekçesiyle söyler, teslimat düzelince de kendiliğinden temizlenir.
WhatsApp, Messenger ve Instagram bağlama (Meta)
WhatsApp (Cloud API), Facebook Messenger ve Instagram, Meta'nın altyapısında çalışır. Bunları tek tıkla bağlarsınız — kopyalanacak token yoktur. Kanal ekle altında bir Meta kanalı seçtiğinizde iki düğme görürsünüz:
- Facebook ve Instagram'ı bağla — Meta'nın güvenli girişini açar. Erişim verdikten sonra Facebook Sayfalarınızı (ve bir Sayfaya bağlı Instagram profesyonel hesaplarını) listeleriz. Hangilerini ekleyeceğinizi seçin.
- WhatsApp'ı bağla — Meta'nın WhatsApp gömülü kaydını açar. Tamamladıktan sonra WhatsApp İşletme Hesabınızdaki telefon numaralarını listeleriz. Hangilerini ekleyeceğinizi seçin.
Seçtiğiniz her öğe için bir ad ve departman belirleyip Seçilenleri bağla'ya tıklayabilirsiniz. Her öğe için bir kanal oluştururuz; erişim token'ını sunucu tarafında alırız (tarayıcınıza asla ulaşmaz, şifreli saklanır) ve olayların akması için en iyi çabayla abone ederiz. Zaten bağladığınız öğeler Zaten bağlı olarak gösterilir ve atlanır.
Tek tıkla akış, operatörün bir kez yapılandırdığı tek bir platform Meta Uygulaması kullanır (geliştirici kılavuzuna bakın). Yapılandırılmamışsa Meta bağlama düğmeleri bir uyarıyla devre dışı kalır — operatörünüzden kurmasını isteyin.
Paylaşılan webhook
Üç Meta ürünü de tek bir uygulama düzeyinde webhook (