Entegrasyon

Telegram köprüsü

Telegram köprüsüyle temsilcileriniz konuşma tekliflerini Telegram’da alır, kabul eder ve ziyaretçilere doğrudan Telegram’dan yanıt verir. İsterseniz her konuşma bir ekip grubunda ayrı bir konu (topic) olarak da açılabilir.

#Botu bağlayın

  1. BotFather ile bot oluşturun

    Telegram’da @BotFather ile yeni bir bot oluşturun ve verdiği token’ı kopyalayın.

  2. Token’ı panele girin

    Yönetim panelinde Telegram ve yönlendirme sayfasında, Telegram botu bölümüne token’ı yapıştırıp Botu bağla’ya tıklayın (telegram:manage yetkisi gerekir). Token Telegram’da doğrulanır, köprü servisi için şifrelenir ve bir daha gösterilmez.

Aynı sayfadan token’ı yenileyebilir (aynı bot için yeni token), botu devre dışı bırakabilir ve köprünün sağlık durumunu (Telegram ile son iletişim, bekleyen ve başarısız teslimler, bağlı temsilci sayısı) görebilirsiniz. Bir bot yalnızca bir tenant’a bağlanabilir.

Her temsilci kendi Telegram hesabını kendisi bağlar:

  1. Temsilci paneli → Profil → Telegram’ı bağla

    Panel tek kullanımlık, 15 dakika geçerli bir bağlantı üretir ve Telegram’ı aç düğmesini gösterir.

  2. Botta Başlat’a basın

    Bağlantı bot sohbetini açar; Start (Başlat) ile bağlantı tamamlanır ve profil sayfası bağlı hesabı gösterir.

Bir temsilci bir botta yalnızca bir Telegram hesabı bağlayabilir. Bağlantı profil sayfasından, botta /unlink ile ya da yönetici tarafından Bağlı temsilciler listesinden kaldırılabilir.

#Teklifler ve yanıtlar

Temsilci bekleyen bir konuşma olduğunda ve temsilci teklif almaya uygunsa, Telegram’a bir teklif kartı gelir: site, doğrulanmış oyuncu kimliği, dil, bekleme süresi, yapay zekânın devir özeti ve son 10 mesaj. Kartta Kabul et ve Reddet düğmeleri bulunur; temsilci paneli herkese açık bir adresteyse Panelde aç düğmesi de eklenir. Süresinde kabul edilmeyen teklif sıradaki uygun temsilciye geçer.

Bir temsilci şu koşulların hepsini sağlıyorsa teklif alır:

  • durumu çevrim içi;
  • temsilci paneli açık (son 90 saniyede etkin) veya Telegram’ı bağlı;
  • çalışma saatleri içinde (profilinde bu seçeneği açtıysa);
  • eşzamanlı sohbet sınırının altında;
  • yanıt yetkisi (conversations:reply) var.

Yazdığınız mesaj şu sırayla bir konuşmaya yönlendirilir:

  1. bir mesaja Telegram’da yanıt verirseniz, o mesajın konuşmasına;
  2. aksi hâlde sabitlenmiş ✍️ mesajda görünen etkin konuşmaya;
  3. etkin konuşma yoksa ve tek açık konuşmanız varsa ona; birden fazlaysa bot sorar.

Temsilciler PNG, JPEG, GIF, WebP ve PDF dosyaları (en fazla 10 MB) gönderebilir; ziyaretçilerin gönderdiği dosyalar Telegram’a iletilir.

#Komutlar

KomutAçıklama
/start, /helpBağlantıyı tamamlar / komut listesini gösterir.
/statusDurumunuz ve açık konuşmalarınız; düğmelerle etkin konuşmayı değiştirirsiniz.
/online · /away · /offlineMüsaitlik durumunuzu değiştirir.
/takeKonuşmayı üstlenir (teklifi kabul eder).
/release · /release allKonuşmayı (ya da hepsini) bırakır; konuşma yapay zekâya veya kuyruğa döner.
/closeKonuşmayı kapatır.
/summaryKonuşmanın yapay zekâ özetini yalnızca size gönderir.
/suggestYapay zekâ yanıt önerisini yalnızca size gönderir.
/unlinkTelegram bağlantınızı kaldırır.

#Ekip grupları (konular)

Konuşmaları kişisel sohbet yerine ortak bir Telegram grubunda da yürütebilirsiniz. İnsan bekleyen her konuşma grupta kendi konusunu (topic) alır: bağlam ve 🙋 Üstlen düğmesi, ardından tüm mesajlar.

  1. Grubu hazırlayın

    Ekip için bir Telegram grubu oluşturun ve ayarlarından Konular’ı (Topics) açın.

  2. Botu yönetici yapın

    Botu gruba Konuları yönet (Manage topics) yetkisine sahip yönetici olarak ekleyin.

  3. Grubu bağlayın

    Panelde Ekip grubu bağla ile grubun hangi konuşmalara hizmet edeceğini seçin (bir departman ya da varsayılan grup) ve üretilen bağlantıyı açın veya gösterilen komutu gruba gönderin. Bağlantı tek kullanımlıktır ve 30 dakika geçerlidir.

Konuyu üstlenen kişinin yazdıkları ziyaretçiye gider; Telegram’ını bağlamış diğer temsilcilerin yazdıkları iç not olur; hesabını bağlamamış üyelerin mesajları dikkate alınmaz. Konu içinde /take, /release, /close, /summary ve /suggest kullanılabilir. Kendi grubu olmayan departmanların konuşmaları varsayılan gruba düşer.

#Yönlendirme ve gizlilik ayarları

Aynı sayfadaki Yönlendirme bölümünde bekleyen konuşmaların uygun temsilcilere otomatik teklif edilmesini açıp kapatabilir, teklif süresini (15–600 saniye) ve Telegram’a gönderilen ziyaretçi metinlerinde e-posta, telefon, IBAN ve kart numaralarının maskelenmesini ayarlayabilirsiniz (settings:write). Sayfa ayrıca insan bekleyen kuyruğu ve temsilcilerin neden teklif alıp almadığını gösterir.