Temel Komutlar¶
Konu gruplarının yerel özelliklerini keşfettikten ve bağlı botlar veya hesaplar adına iletişim kurmayı denedikten sonra, etkili diyalog yönetimi için Hotline'ın durumlarını ve temel komutlarını öğrenme zamanı geldi.
/ Dahili Yorumlar¶
/ sembolü ve ardından boşluk ile başlayan herhangi bir mesaj dahili yorum olarak kabul edilir ve müşteriye gönderilmez.
Konulardaki dahili yorum örnekleri
/ Müşteriyle telefonda konuştuk, ekibimizin çalışma modelinin farklı bir versiyonuna ihtiyaçları var
/ TODO: pazarlama departmanından yaklaşan promosyon hakkında bilgi al ve müşteriye gönder
/ @alex108 bu vakayı çözmeme yardım et, burada #ileri_seviye
Yorum yetenekleri:
- Ekiple yanıtı doğrudan diyalog bağlamında tartışma
- Kategorize etmek için #hashtag kullanma
- Dikkat çekmek için meslektaşları @mention ile etiketleme
- Önemli ek bilgiler veya görevlerle yorumları sabitleme
İpucu: Yorumları aktif kullanın
/ ile dahili yorumlar, diyalogları belgelemek, görevler belirlemek ve ekibi doğrudan müşteri konuşması bağlamında koordine etmek için harika bir yoldur.
İpucu: Önemli yorumları sabitleyin
Hızlı erişim için mevcut görevler veya önemli müşteri bilgileriyle yorumları konunun en üstüne sabitleyin.
Gönderme mantığının tersine çevrilmesi
REPLY_ONLY parametresini etkinleştirebilirsiniz — o zaman tüm mesajlar yorum olur ve yalnızca müşteri mesajlarına açık yanıtlar (reply) müşteriye gönderilir.
Konu Durumları¶
Her diyalog konusunun, konu adında renkli bir kare ile gösterilen üç durumdan biri vardır.
-
🟪 Dikkat/yanıt gerektirir¶
Durum:
user_answeredNe zaman ayarlanır:
- Kullanıcıdan yeni bir mesaj alındığında
- Yeni bir konu oluşturulduğunda
- Kullanıcı kapandıktan sonra tekrar iletişime geçtiğinde
Komut:
/holdDaha fazla dikkat gerekliyse (örneğin, ek bilgi veya görev tamamlanması bekleniyorsa) konuyu açıkça aktif durumda tutmak için
/holdkullanın. -
🟨 Yanıt bekleniyor¶
Durum:
support_answeredNe zaman ayarlanır:
- Mor bir konuda operatörün ilk yanıtında otomatik olarak (🟪 → 🟨)
- Kullanıcıdan yeni bir mesaj alındığında otomatik olarak sarıdan mora döner (aktif diyaloğa müdahale etmemek için 2 dakika gecikmeli)
Komut:
/waitKullanıcıya yanıt verildiyse ve başka bir eylem gerekli değilse konuyu açıkça bekleme moduna almak için
/waitkullanın. -
⬛️ Diyalog kapatıldı¶
Durum:
closedNe zaman ayarlanır:
/closekomutu yürütüldüğündeAUTOCLOSEparametresinden zaman aşımıyla otomatik olarak (son operatör yanıtından 48 saat sonra varsayılan, devre dışı bırakılabilir)
Komut:
/closeMüşterinin sorunu tamamen çözüldüğünde konuyu kapatın. Kapanırken:
- Kullanıcı bir sonraki iletişimde
WELCOMEparametresinden yeni bir hoş geldiniz alacak - Konu yönetim hakları olmayan grup üyeleri artık kapalı konuda yazamaz
- Kullanıcıdan yeni mesajda konu otomatik olarak etkinleştirilir (⬛️ → 🟪)
Durumları izleyin
Durumların doğru kullanımı, ekibin hangi diyalogların dikkat gerektirdiğini ve hangilerinin müşteri yanıtını beklediğini anlamasına yardımcı olur.
Konu adı önbelleğe alma
Telegram uygulamaları bazen bir önbelleğe alma özelliğine sahiptir — durum simgesi bir komut gönderdikten hemen sonra güncellenmeyebilir. O anda senkronizasyon gerekiyorsa, /hold veya /wait komutunu tekrar gönderin veya durumun güncellenmesini bekleyin.
Hızlı Referans /help¶
Çalışma grubunun herhangi bir konusunda /help komutunu göndererek mevcut komutlar ve durumların hızlı bir referansını istediğiniz zaman alın.
Konu Bilgileri /info¶
/info komutuyla mevcut konu hakkında temel bilgileri alın.
- Kullanıcı adı ve profil bağlantısı (varsa)
- Kullanıcı ID'si
- Kullanıcı adı ve sohbet bağlantısı (varsa)
- Telefon numarası (varsa)
- Dil (ayarlanmışsa)
- Ön uç bağlantısı
- Sohbet adı ve genel bağlantı (varsa)
- Sohbet ID'si
- Ön uç bağlantısı
Otomatik bilgi
AUTO_INFO parametresini etkinleştirebilirsiniz — o zaman her yeni konu oluşturulduğunda bilgiler otomatik olarak gösterilir.
Bilgileri gizleme
HIDE_INFO parametresi aracılığıyla müşteri bilgilerini normal operatörlerden gizleyebilir ve gruptaki /info komutunu devre dışı bırakabilirsiniz.
Engelleme /ban ve /unban¶
Terbiyesiz kullanıcıları /ban komutuyla engelleyin ve gerekirse /unban komutuyla engeli kaldırın.
Komutların prensibi bağlantı türüne göre farklılık gösterir.
Engelleme, ilgili özel diyaloğun user_id'sini IGNORE_CHATS parametresine ekler
Telegram'ın yerel engelleme işlevini kullanır
Görmezden Gelme /ignore ve /unignore¶
Gelen mesajlarda karışıklık yapmaması için /ignore komutuyla tek tek diyalogları görmezden gelin ve /unignore ile geri getirin.
/ignore komutu /ban'den farklıdır:
/ban, botlar için yalnızcauser_id'yiIGNORE_CHATS'a eklemez, aynı zamanda kullanıcıyı Telegram tarafında da engeller — artık bota yazamaz./ignore, göndereni engellemeden diyalogdan gelen mesajlara tepki vermeyi bırakır. Kullanıcı hâlâ yazabilir, ancak mesajları çalışma grubunda konu oluşturmaz veya etkinleştirmez.
- Mevcut diyaloğu runtime
ignore_chat_idslistesine ekler. - Listeyi
@IGNORE_CHATS@parametresine kaydeder. - TDLib
closeChataracılığıyla sohbeti kapatır. - Herhangi bir diyalog türü için çalışır: özel sohbetler, gruplar, süper gruplar, kanallar ve konular.
- Konu diyalogları için listeye bireysel konu değil, süper grubun
chat_id'si eklenir.
- Mevcut diyaloğu
ignore_chat_idslistesinden kaldırır. @IGNORE_CHATS@parametresini günceller.- Yürütüldükten sonra, diyalogdan gelen yeni mesajlar tekrar çalışma grubunda görünecektir.
/ignore Ne Zaman Kullanılır
/ignore'i operatör yanıtı gerektirmeyen sohbetler için kullanın: kanal yayınları, spam grupları, hizmet sohbetleri veya geçici olarak ilgili olmayan diyaloglar.
Hızlı Komut Referansı
/ignore ve /unignore komutları /help çıktısında listelenmiştir.
Diyaloğu Gizleme /hide¶
/hide komutuyla backend grubundan bir backend diyalog konusunu, frontend'deki mesajları koruyarak kaldırın.
Backend grubundaki bir konuyu normal silmek, ilgili diyalogdaki frontend'deki tüm mesajları siler. /hide komutu, bağlı bot veya hesaptaki mesajlara dokunmadan konuyu backend'de silmenizi sağlar.
Komut, ilgili kullanıcıdan veya grup sohbetinden gelen mesajları engellemek gerekmediğinde backend grubunu gereksiz veya eski konulardan temizlemek için kullanışlıdır. Konuyu silmenin yanı sıra ilgili diyalogdan gelen mesajları almayı durdurmanız gerekiyorsa, /hide'yi çağırmadan önce konu içinde /ignore komutunu çalıştırabilirsiniz.
Yürütüldüğünde ne olur:
- Diyalog ile birlikte konu yalnızca backend grubundan kaldırılır.
- İlgili frontend sohbetteki tüm mesajlar korunur.
- Diyaloga tekrar bir mesaj gelirse (ve diyalog
/ignoreveya/banile engellenmemişse), konu yeniden oluşturulur ve etkinleştirilir ve kullanıcıya veya sohbete bir karşılama mesajı gönderilir (bağlantıda etkinleştirilmişse). - Konunun gizlenmesiyle ilgili bir rapor
Generalkonusuna gönderilir.
İşlem geri alınamaz
/hide komutuyla dikkatli olun: silinmiş bir konudan mesajları geri yüklemek imkansızdır çünkü Hotline mesaj metinlerini kendi sunucularında saklamaz.
Erişim hakları
Komut yalnızca EXTENSIONS_ALLOWED parametresinde listelenen operatörler için kullanılabilir.
Konu Oluşturma /new¶
/new komutuyla kullanıcılarla yeni diyaloglar oluşturun veya sohbetlere katılın.
Komut yetenekleri bağlantı türüne göre farklılık gösterir.
- Telegram'daki botlar kullanıcılara önce yazamaz, botla diyalog kullanıcı tarafından başlatılmalıdır. Ön uç olarak kullanılan kullanıcı hesabı yetenekleri hakkında daha fazla bilgi edinin.
- Komut yalnızca kullanıcının
USER_IDveyaUSERNAME'i biliniyorsa silinmiş bir konuyu yeniden oluşturmak için kullanılabilir.
Komut formatı (USERNAME'de @ sembolü gerekmez):
/new USERNAME | *USER_ID | #PHONE
- Diğer kullanıcılara önce yazabilir
- Botları başlatabilir, onlara komutlar gönderebilir ve konuda yanıt alabilir
- Genel bağlantı veya davet bağlantısı ile sohbetlere katılabilir
Kullanıcı veya botla bir diyalog oluşturma (USERNAME'de @ sembolü gerekmez):
/new USERNAME | *USER_ID | #PHONE
/new BOT_USERNAME | *BOT_USER_ID
Bir botla konu oluşturduktan sonra, ona konu aracılığıyla çift eğik çizgi // ile başlatarak komutlar gönderebilirsiniz, örneğin:
//start
//help
Bir grup veya kanala katılma:
/new PUBLIC_CHAT_LINK
/new PUBLIC_CHANNEL_LINK
/new https://t.me/PUBLIC_CHAT_LINK
/new https://t.me/PUBLIC_CHANNEL_LINK
/new https://t.me/+PRIVATE_INVITE_HASH
Sohbet oluşturma (deneysel özellik)
Var olmayan bir USERNAME, sohbet veya bot için genel bağlantı belirtirseniz, belirtilen adla hesaptan bir sohbet oluşturulur.
Birden fazla bağlantı
Bir arka uç grubunda birden fazla bağlantı varsa, konunun oluşturulması gereken belirli örneği belirtebilirsiniz (varsayılan olarak komut gruptaki her bağlantı için yürütülür).
Bağlantı belirterek USERNAME ile diyalog oluşturma komutunun örneği (süslü parantez kullanmak gerekmez):
/new USERNAME i{INSTANCE_ID}
Diyaloglar için Toplu Topic Oluşturma¶
Mevcut bir müşteri tabanını, grup sohbetlerini veya etkinliklerden gelen kişi listelerini taşımak için bir liste veya dosyadan tek komutla backend grubunda en fazla 1000 topic oluşturun.
Erişim hakları
Toplu diyalog oluşturma yalnızca EXTENSIONS_ALLOWED listesindeki operatörler için kullanılabilir. Tekli /new <query> komutu tüm operatörler için kullanılabilir olmaya devam eder.
General konusundaki komutlar:
/newveya/new help— mevcut modlar hakkında yardım göster./new file— ekli dosyadan diyaloglar oluştur (satır başına bir değer, fazladan boş satır olmadan)./new list DEGER1,DEGER2,...— mesajdaki virgülle ayrılmış listeden diyaloglar oluştur.
Dosya veya listede desteklenen değerler:
*USER_ID— Telegram kullanıcı ID'si*-CHAT_ID— grup veya kanal ID'si (eksi işaretiyle)#PHONE— telefon numarasıUSERNAME— kullanıcı adı (@olmadan)t.me/...veya davet bağlantısı
Nasıl çalışır:
- Diyalog oluşturma işlemleri arasında 5 saniye gecikme vardır.
- Oluşturulan tüm diyaloglar
closeddurumu alır. - Komut tamamlandığında, her alıcı için sonuç içeren bir CSV raporu
Generalkonusuna gönderilir. - Bir backend grubunda aynı anda yalnızca bir bulk
/newyürütülebilir. - Komut başına en fazla 1000 diyalog.
Hızlı taban taşıma
Excel veya CSV'de zaten bir müşteri listeniz varsa, tanımlayıcıların bulunduğu sütunu bir dosyaya kopyalayın, sayısal değerler için öneki ekleyin (user_id veya chat_id için *; telefon numaraları için #) — ve diyaloglar için hazır topic'ler elde edin.
Topic'ler her giden mesajla etkinleştirilir; gelen mesajlar için ayarlara bağlı olarak karşılama mesajı da gönderilebilir.
Ek Modüller¶
Temel komutların yanı sıra, Hotline arka uç grubu tarafında destek hizmetinin operatörleri için çok faydalı olabilecek bir dizi modüle sahiptir.
/say komutu ile hızlı yanıtlar
Konularda hazırlanmış mesajların hızlı oluşturulması ve gönderilmesi. Metin, medya, albümler ve mesaj iletmeyi destekler.
/send komutu ile kullanıcı yayınları
Zamanlama özelliği ile tüm veya seçili müşterilere toplu yayınlar.
/mark komutu ile etiketler ve satış hunileri
Segmentasyon, satış hunilerini organize etme ve otomasyonlar için konulara görünür etiketler atayın.
/export komutu ile müşteri tabanı dışa aktarma
Yedekleme veya analiz için müşteri verilerini CSV dosyasına aktarın.
Ekip analitiği
Detaylı operatör performans istatistikleri, müşteri talep analizi ve çeşitli zaman dilimleri için raporlar.
Özel Komutlar¶
Hotline'da işlevselliği genişletmek için özel komutlar eklemek mümkündür:
- Harici sistemlerle entegrasyon (CRM, ERP, görev takipçileri)
- Belirli iş süreçlerinin otomasyonu
- Kendi görevleriniz için özel komutlar oluşturma
- Web kancaları aracılığıyla harici hizmetlere bağlanma