Bir Telegram AI chatbot, işletmenizin bilgilerine dayanarak grupta veya özel sohbette soruları yanıtlayabilir. Quickchat AI, Agent’ı ortak bir bot üzerinden Telegram’a bağlar: botu gruba ekleyin, panelde bağlantıyı onaylayın; üyeler botu etiketleyerek soru sorabilsin. Bu yöntem için kod veya BotFather token’ı gerekmez.
Bu rehberde üye grubu ve özel talepleri olan kurgusal Saltmarsh Sailing School kuruluyor. İki Agent aynı okul bilgilerini kullanır: Saltmarsh Group genel soruları yanıtlar; Saltmarsh Sailing School özel deneme dersi taleplerini alır ve iadelerde insan desteği sağlar. Talep, ofise iletilen bir başvurudur; kesinleşmiş rezervasyon değildir.
İki Agent sorumlulukları ayırır. Grup Agent’ında devir veya talep toplama Action’ı yoktur; özel Agent başvuruları ve personel yanıtlarını yönetir.
Aşağıdaki yolu izleyin. Google Sheets uzantısı isteğe bağlıdır; önce yanıt ve insan desteği akışını tamamlayabilirsiniz.
| Kurulum | Kontrol noktası |
|---|---|
| 1. Bilgi ve talimatlar | Agent kurs fiyatını bilir, eksik bilgiyi uydurmaz. |
| 2. Grup bağlantısı | Etiketlemeye yanıt verir; sıradan sohbette sessiz kalır. |
| 3. Özel sohbet | Tam bağlantı doğru Agent’la konuşmayı açar. |
| 4. İsteğe bağlı ders talepleri | Gerekli bilgiler personelin takip edebileceği bir satıra dönüşür. |
| 5. Human Handoff | Konuşmayı bir insan devralır; AI duraklar. |
| 6. Testler | Yanıtları, yönlendirmeyi ve dış sistem etkilerini ayrı doğrularsınız. |
Saltmarsh Telegram kitini indirin: kullanılan bilgiler, Main Prompt, Action tarifi, değerlendirme ölçütleri ve test mesajları dahildir. Bunlar sonraki adımlar için düzenlenebilir dosyalardır; tek tıkla Agent içe aktarma paketi değildir. Örnek dosyalar, test mesajları ve ekran görüntüleri doğrulanan örnekle eşleşmeleri için İngilizce tutulmuştur.
Telegram chatbot oluşturmak için ne gerekir?
Bir Quickchat AI hesabı, iki Agent ve test grubuna bot ekleme yetkisi olan Telegram hesabı gerekir. İsteğe bağlı talep kaydı için Google Sheets erişimine izin verebilen bir Google hesabı da gereklidir.
- Quickchat AI hesabı oluşturun; istenirse e-postanızı doğrulayın. Free, kişisel ve ticari olmayan öğrenim içindir. Planlar Agent başına uygulanır; iki Agent’ı kullanan işletmenin ikisi için de uygun ticari kapsamı olmalıdır. Preview ve Simulation AI kredisi tüketir. Güncel planlara bakın.
Saltmarsh Membersadlı Telegram grubunu oluşturun. Müşterileri davet etmeden önce etiketleme, sessizlik ve devam mesajlarını test grubunda kontrol edin.- Ziyaretçi mesajları dahil tüm adımları kendi Telegram hesabınızla uygulayın. Quickchat AI Inbox’ını da kullanabilirsiniz. Müşterileri davet etmeden önce bir çalışma arkadaşınızdan deneyimi başka bir hesapla kontrol etmesini isteyin.
- Kiti açın. Okulun örnek bilgilerini birlikte tutun; yayına almadan önce kendi doğrulanmış kurallarınızla değiştirin.
Quickchat App ekran görüntüleri, kurgusal Saltmarsh yapılandırmasıyla yerel olarak çalışan bir uygulamayı gösterir; bağlantılar için hazırlanmış test verileri açıklamalarda belirtilmiştir. Telegram ve Google Sheets görüntüleri, bağlı demonun gerçek yanıtlarını ve kaydedilen talebi gösterir. Kişisel hesap bilgileri kırpılmış veya açıkça gizlenmiştir. Kontrolleri kendi bilgi içeriğiniz ve bağlı hesaplarınızla tekrarlamak için son kontrol listesini kullanın.
Adım 1: Telegram chatbot’a işletmenizi nasıl öğretirsiniz?
İşletme bilgilerini Knowledge Base, çalışma talimatlarını Main Prompt içinde tutun. Böylece Agent’ın davranışını değiştirmeden bir yanıtın dayandığı bilgiyi düzeltebilirsiniz.
Fiyatlar ve kurallar kaynak bilgidir. Kısalık, belirsizliği belirtme ve yönlendirme ise talimattır.
Agent’ı oluşturun ve bilgilerini ekleyin
- Yeni hesapta Set up manually seçin. Mevcut hesapta önce Add new AI Agent, sonra manuel kurulumu seçin.
- Identity sayfasında Name your AI Agent alanına
Saltmarsh Groupyazın. Kittekigroup-main-prompt.txtdosyasını Describe what you want your agent to do alanına yapıştırın. - Harici uygulamaları henüz bağlamadan kuruluma devam edin. Plan adımını tamamlayın; öğrenim hesabıyla başlıyorsanız Skip for now kullanabilirsiniz.
- Knowledge Base > Add Article açın. Create custom article alanına
Courses and trial enquiriesgirin, Create article seçin,saltmarsh-courses.txtiçeriğini Content alanına yapıştırıp Save seçin. Weather, parking and personal enquiriesiçinsaltmarsh-policies.txtile tekrarlayın. İki makale de Ready olana kadar bekleyin.- Saltmarsh Group için Actions & MCPs açın. Human Handoff kapalı kalsın; deneme dersi Action’ını eklemeyin.
- Add new AI Agent seçin;
Saltmarsh Sailing Schooliçinmain-prompt.txtve aynı iki bilgi dosyasıyla manuel kurulumu tekrarlayın. İkinci Agent özel konuşmaları yönetir. Ayar değiştirmeden önce hesap seçicisinden doğru Agent’ı seçin.
İki kısa kaynak Agent’ın hangi bilgilere sahip olduğunu açıkça gösterir. Bilgi testinden önce Ready durumunu kontrol edin.
| Bilgi | Örnekte kullanılan kesin bilgiler |
|---|---|
| Kurslar | Start Sailing: iki gün, EUR 240. Day Skipper theory: beş akşam, EUR 310. Özel ders: 90 dakika, EUR 95. |
| Tarihler | Sezon nisandan ekime; tarihler bir ay önce yayımlanır. Canlı müsaitlik veya sonraki tarih verilmez. |
| Ekipman | Su geçirmez ceket, iz bırakmayan ayakkabı ve yedek kıyafet. Yüzdürme yardımcılarını okul sağlar. |
| Hava | 25 knot üzeri rüzgâr veya gök gürültülü fırtınada ücretsiz olarak sonraki uygun tarihe erteleme. Eğitmen o sabah karar verir. |
| Otopark | Kulüp binasında ücretsiz. Kapı kodu bir gün önce gönderilir; kodun kendisi yoktur. |
| Deneme dersi talepleri | Ad, tercih edilen hafta günü ve yelken deneyimi alınır. Müsaitlik ve fiyatı ofis doğrular. |
Neopren kıyafet kiralama bilgisi özellikle yoktur. Doğru yanıt, evet veya hayır uydurmak yerine doğrulayamadığını belirtir. Benzer şekilde hava kuralı bugünün tahminini sağlamaz; özel ders fiyatı deneme dersinin fiyatını belirlemez.
Main Prompt’u ayarlayın ve bir yanıtı kontrol edin
- Her Agent’ta Identity > Main Prompt açın ve ilgili Saltmarsh prompt’unu kontrol edin. Grup prompt’u genel soruları yanıtlar ve sabitlenmiş özel bağlantıya yönlendirir; özel prompt talep toplar ve Human Handoff kullanır.
- AI Preview açıp
How much is Start Sailing?sorun. İki gün ve EUR 240 bilgilerini doğrulayın. Do you rent wetsuits?sorun. Yanıt eksik bilgiyi kabul etmelidir.
Özel Agent’ın prompt’u talep alma ve devri tanımlar. Grup Agent’ı ayrı prompt kullanır; iki Action da kapalıdır.
Grup Agent’ının gerçek ayarlarından iki kesit. Bilgi sorularını yanıtlayabilir; talep veya devir Action’ı çalıştıramaz.
İki Agent yönlendirmeyi açık hale getirir. Grup Agent’ı yanlışlıkla devir başlatamaz; özel Agent grubu durdurmadan iade talebini devredebilir. Preview okul bilgilerini, sonraki adımlar her Telegram bağlantısını doğrular.
Adım 2: AI chatbot Telegram grubuna nasıl eklenir?
External Apps > Telegram açın, ortak botu gruba ekleyin, ardından Quickchat AI’a dönüp Confirm seçin. Onaylanana kadar Agent grupta sessiz kalır.
Telegram üyeliği ve Quickchat AI onayı ayrı adımlardır.
- Agent seçicisinden Saltmarsh Group seçin. External Apps > Telegram açıp Quickchat AI bot bölümünü bulun.
- Add to a Telegram group seçin. Telegram’da
Saltmarsh Membersgrubunu seçip botun eklenmesini onaylayın. - Quickchat AI’a dönün. Waiting for your confirmation altında grup adını ve Added by bilgisini kontrol edin.
- Doğru grup için Confirm seçin. Grup, etkinleştirme anahtarı açık olarak Connected chats içine taşınmalıdır.
- Telegram’da
@yazıp etiketleme listesinden botu seçin.How much is Start Sailing?sorun. Ortak bot genellikle@QuickchatAI_botadını kullanır; grubunuzdaki gerçek kullanıcı adını kullanın. - Bu yanıta doğrudan
What should I bring?yazın. Ardından etiketlemeden ayrı mesaj gönderin:Does anyone know the gate code?. Ortak bot ilkine yanıt vermeli, sıradan mesajda sessiz kalmalıdır.
Telegram’da Saltmarsh Members grubunu seçin, ardından bağlantıyı onaylamak için Quickchat AI’a dönün.
Önceden oluşturulmuş yerel grup test verileriyle gerçek arayüzde Confirm konumu gösterilir. Bu, canlı Telegram grubuna katılındığının kanıtı değildir.
Onaylanan grup beklenen kurs yanıtını aldı. Botu gerçek kullanıcı adıyla etiketleyin.
Botun mesajına yanıt vermek, yeniden etiketlemeden çalışır. Yanıt, sağlanan ekipman bilgilerini listeler.
Davet verileri grupta göründüğü için onay önemlidir. Quickchat AI, grubu Agent hedefi olarak kullanmadan önce hesap içinden karar ister. Tanımadığınız grubu onaylamayın. Telegram bağlantı belgesi aynı sınırı açıklar.
Kurulumdan çıkmadan önce onayı tamamlayın. Bot onaylanmamış gruptan ayrılırsa yeni bir Add to a Telegram group bağlantısı oluşturun, botu yeniden ekleyin ve Quickchat AI’da bekleyen grubu hemen onaylayın. Botu Telegram’ın üye aramasıyla eklemek bu bağlantı akışının yerini almaz.
Admin rozeti botun Telegram’daki durumunu gösterir. Ortak botun olağan yanıtları için gerekmez. Ortak botu yönetici yapmak da etiketleme veya yanıta cevap verme kuralını değiştirmez.
Adım 3: Özel Telegram sohbetleri nasıl açılır?
Direct message link açın ve üretilen URL’nin tamamını paylaşın. Bağlantı ortak bot içinde Agent’ınızı seçer; müşteriler botu gruba eklemeden özelden yazabilir.
Grup ortak bir konuşmadır. Kişisel bilgileri ve personel devrini özel mesajlara taşıyın.
- Özel Agent Saltmarsh Sailing School seçin. External Apps > Telegram içinde Direct message link açın. Grup bağlantılarını boş bırakın.
- Üretilen bağlantıyı kopyalayın.
start=parametresini koruyun; ortak bota verilen çıplak bağlantı Agent’ı belirlemez. - Telegram’da açın; gerekirse Start basın.
- Botu etiketlemeden
How much is Start Sailing?sorun. Okulun yanıtını doğrulayıp konuşmayı Inbox içinde bulun. - Bağlantıyı grubun karşılama mesajına sabitleyin; kişiler özel bilgi paylaşmadan önce bulabilsin.
Kendi Agent’ınız için üretilen bağlantıyı kullanın. Gösterilen yerel ayar canlı Telegram teslimatının kanıtı değildir.
Telegram, Start sonrasında Saltmarsh karşılama mesajını iletti. Ardından bilgi tabanından bir yanıtı kontrol edin; yalnızca karşılama mesajı bilgi getirmeyi test etmez.
Aynı Telegram ekranından kırpılmış iki ayrıntı, sabitlenmiş daveti gösterir. Demo bağlantısının start değeri çıkarılmıştır; kendi üretilmiş bağlantınızın tamamını sabitleyin.
Ortak botla özel sohbet aynı anda yalnızca bir Agent’a bağlıdır. Başka Agent’ın özel bağlantısı bu eşleşmeyi değiştirebilir. Kendi Telegram kimliğiniz ve ayrı bot konuşmanız için kendi botunuz yöntemini kullanın.
Direct message link kapatıldığında bağlantı üzerinden yeni bağlantılar engellenir. Mevcut sohbeti durdurmak için sohbetin anahtarını veya Disconnect kullanın. Bağlantı, gizli bilgilere erişim kısıtı değil, herkese açık bir giriş noktasıdır.
Adım 4: Deneme dersi talebi Google Sheets’e nasıl kaydedilir?
Google Sheets entegrasyonu bir tablo ve satır ekleme Action’ı oluşturur. Action’ı üç zorunlu talep alanına uyarlayın, ardından gerçek satırı kontrol edin. Bu isteğe bağlı adım ortak Telegram botuyla çalışır.
Sonuç, personelin takip edeceği bir taleptir. Yer ayırmaz veya deneme dersinin fiyatını belirlemez.
Sheets’i bağlayın ve bir Action ayarlayın
- Saltmarsh Sailing School üzerinde Actions & MCPs > Add Action > Google Sheets açın; Connect Google Sheets seçin. Doğru Google hesabına giriş yapıp istenen erişimi onaylayın.
- Oluşturulan Quickchat Leads tablosunu açın. Action URL’si bu sekmeye yöneldiği için Leads adını koruyun.
- Başlık satırını sırasıyla
Name,Preferred weekday,Sailing experience,Conversation link,Channelolarak değiştirin. - Actions & MCPs içinde oluşturulan
log_lead_to_google_sheetAction’ını aşağıdaki tarife göre düzenleyin. Parametreleri, istek gövdesini ve tablo başlıklarını birlikte değiştirin; sıraları eşleşsin.
API Action Name
Record trial-lesson request
What to ask the user first
| Format | Name | Description | Required |
|---|---|---|---|
| Text | name | Kişinin bu deneme dersi için verdiği ad. Eksikse sorun. | Evet |
| Text | preferred_weekday | Tercih edilen hafta günü, örneğin salı. Bu bir tercihtir, onaylı tarih değildir. | Evet |
| Text | sailing_experience | Kişinin belirttiği yelken deneyimi, örneğin başlangıç seviyesi. Eksikse sorun; varsaymayın. | Evet |
Üç parametrede de No default seçin; varsayılan e-posta ve soru parametrelerini kaldırın. Tarif yalnızca bu üç alanı sorar. Telegram kullanıcı adı isteğe bağlıdır, güvenilir bir zorunlu iletişim alanı değildir; konuşma bağlantısı personelin talebe dönmesini sağlar.
Yöntem ve URL: üretilen POST URL’sini koruyun. Tablo ID’si, Leads sekmesi ve valueInputOption=RAW zaten içindedir. Doldurulacak yer tutucu tablo ID’si yoktur.
Başlıklar: entegrasyon ayarlarını koruyun.
| Başlık | Değer |
|---|---|
Authorization | Bearer {{google_sheets_access_token}} |
Content-Type | application/json |
API Endpoint içindeki Body sekmesinde şunu kullanın:
{"values":[["{{name}}","{{preferred_weekday}}","{{sailing_experience}}","{{conversation_url}}","{{conversation_channel}}"]]}
Gereken parametre ve konuşma değişkenlerini Add AI Data ile ekleyin. İlk üç değer konuşmadan, son ikisi Quickchat AI’dan gelir.
API Action Description
In a private chat only, call this once when the person has requested a trial lesson and provided their name, preferred weekday and sailing experience. Ask for the next missing required field before calling. Do not call it for general course questions, in groups, or to confirm a booking. A successful call records an enquiry for the office; it does not reserve a place.
Advanced settings > Run only when açın; telegram_chat_type equals private ekleyin. metadata_ öneki veya süslü parantez olmadan çıplak metadata anahtarını kullanın. Model denese bile grup mesajında HTTP isteği gönderilmez. Çalıştırma koşulları belgesi bu kontrolü açıklar.
Response filter değerini $.updates.updatedRows yapın; Action gereksiz sağlayıcı yanıtı yerine satır sayısını döndürsün. Action açık kalsın.
Çıplak anahtar telegram_chat_type’tır. Koşul istek gönderilmeden önce denetlenir.
Tarifin yerel yapılandırması. Sheets URL’si ve OAuth izni kendi Google bağlantınızdan gelmelidir.
Satırı, ardından eksik talebi kontrol edin
Agent’ın özel Telegram bağlantısından şu mesajı gönderin:
I am Alex Morgan. I want a trial on Tuesday. I am a beginner.
Üç yeri doğrulayın: yanıt bir talebi anlatmalı, Inbox Action kartında verilen değerler görünmeli, gerçek Leads sekmesinde eşleşen satır bulunmalıdır. Güven veren bir yanıt veya yüksek Simulation puanı Sheets’e yazıldığını kanıtlamaz.
Agent, verilen adı, salı tercihini ve başlangıç seviyesindeki deneyimi kaydetti. Uygunluk ve kesin fiyat için hâlâ ofisin onayı gerekir.
Aynı kayıtlı satırın iki ayrıntısı, beş sütunun da okunmasını sağlar. Hesaba özel konuşma bağlantısı gizlenmiştir; diğer dört değer değiştirilmemiştir.
I would like a trial lesson ile ayrı test başlatın. Action çalışmadan önce Agent eksik alanları her mesajda bir soruyla istemelidir. How much is Start Sailing? de deneyin; olağan kurs sorusu satır oluşturmamalıdır. Prompt talep başına tek yazma ister, ancak bu tarif tekrarların etkisini önleyen bir rezervasyon sistemi değildir. İşletme kullanımından önce yinelenen satırları inceleyin.
Adım 5: Telegram konuşması bir insana nasıl devredilir?
Human Handoff ayarlayın; ardından Inbox içindeki atamayı doğrulayın. “Ofis yanıt verecek” diyen bir prompt kendi başına sorumluluğu devretmez veya AI’ı durdurmaz.
Kontrol noktası atama değişikliğidir. Vakayı insan tamamlasın; AI’a dönüşü ayrıca doğrulayın.
- Saltmarsh Sailing School seçin; Actions & MCPs > Human Handoff açıp etkinleştirin. Saltmarsh Group üzerinde kapalı tutun.
- Handoff Rules içindeki + düğmesine basın. Rule Name alanına
Private enquiriesyazın, Description içinehandoff-rule.txtyapıştırıp State açın. Yeni satırlar kapalı başlar. Kural bu özel Agent’ta iadeleri, şikâyetleri, insan taleplerini ve insan yardımı teklifinin kabulünü kapsar. - Keywords alanını temizleyin; hazır kuralları kapatıp yalnızca özel kuralı açık bırakarak kaydedin. Grup ayrımını ayrı Agent’taki kapalı Human Handoff sağlar; özel kural, özel Agent’ın ne zaman devredeceğini açıklar.
- Confirmation değerini
I have passed this private conversation to the Saltmarsh office. A member of staff can reply here.yapın. Human Agents’ availability için ekibin gerçek çalışma saatlerini, saat dışı mesaj için doğru bilgiyi kullanın. - Özel Telegram sohbetinden
I want a refund for last week. Can I speak to a person?gönderin. - Inbox içinde konuşmayı bulun, atamayı kontrol edin, Assign to me seçin ve
Hi, I’m Alex from the office. I’ll review your request.gönderin. Telegram’a ulaştığını doğrulayın. - Konuşma insandayken yeni müşteri mesajı gönderin. AI sessiz kalmalıdır. Operatör vakayı tamamlayıp Inbox içinde çözsün. AI’a dönüşü ayrı bir test olarak ele alın.
Özel kuralın State ayarı açıktır. Hazır tetikleyiciler kapalıdır; incelenecek tek kural kalır.
Gerçek Telegram talebi Handoff’u tetikledi. Inbox ataması ve operatörün gönderdiği yanıt ayrı ayrı doğrulandı.
Canlı kontrolde konuşma, bir kişinin devralmasına hazır olacak şekilde Unassigned durumuna geçti. Operatör Assign to me seçeneğini seçti, ofis yanıtını gönderdi ve Telegram bunu kabul etti. Yukarıdaki görüntü devir yanıtını gösterir; operatörün sonraki mesajını göstermez. Testi tekrarlarken hem atamayı hem teslimatı kontrol edin.
Bu vaka çözülene kadar operatörde kalsın. Yerel iade testimizde AI Agent seçeneğine dönmek bir yanıta izin verdi, ardından Handoff yeniden tetiklendi. AI’a dönüşün ayrıca başarılı bir takip testiyle doğrulanması gerekir; bu iş akışının tamamlanma ölçütleri arasında değildir. İnsana devir rehberi, personel ve sorumluluk konularını daha ayrıntılı ele alır.
Adım 6: Telegram chatbot’un tamamı nasıl test edilir?
Tekrarlanabilir yanıt kontrolleri için Testing kullanın; canlı Telegram yollarını ve dış etkileri ayrı doğrulayın. Grup bağlantısı, tablo kaydı veya devir teslimatı yanlışken model doğru yanıt verebilir.
Sonucu yöneten sistemi kontrol edin: gerçekler için bilgi, istekler için Action kayıtları, satırlar için Sheets, teslimat için Telegram.
Tekrarlanabilir yanıt veri seti çalıştırın
- Testing açın,
Saltmarsh: knowledge checksadlı veri seti oluşturun, Paste messages seçin. simulation-messages.txtyapıştırın. Vakalar arasındaki tek satırlık---ayırıcılarını koruyun.- Evaluation criteria açın, kitteki
evaluation-criteria.txtdosyasını yapıştırıp kaydedin. - Run > Start Run seçin; puanlarla birlikte her yanıtı inceleyin.
Bir talimatı değiştirirken aynı soruları koruyun; karşılaştırma anlamlı kalsın.
Puanın yanında yanıtı da okuyun. Bunlar yerel bilgi testidir; Telegram teslimat testi değildir.
Değerlendirici doğruluğu ölçmek için okul bilgilerine ihtiyaç duyar. Transkriptin tablo satırını, Telegram teslimatını veya atama değişikliğini kanıtlayamayacağını da bilmelidir. Standart metin Simulation Telegram metadata’sı sağlamaz; yokluğu, yalnızca özel sohbet koşulunun bozuk olduğu anlamına gelmez. Kanala bağlı kontrolleri gerçek özel sohbette yapın.
Yerel testler neyi değiştirdi?
İlk tasarım her iki giriş için tek Agent kullanıyordu. Yerel bir test, gruptaki iade talebinin ortak konuşmayı Human Handoff’a aktardığını gösterdi. Agent’ları ayırdık ve grup Agent’ında hem Handoff’u hem talep toplama Actions’ını kapattık. Grup iade ve deneme dersi kontrolleri tekrarlandığında, yanıtlar sabitlenmiş özel bağlantıya yönlendirdi ve konuşma AI’a atanmış olarak kaldı. Bu nedenle 1. adım iki konuşmayı ayırmak için hem yapılandırmayı hem talimatları kullanır.
Son on yerel bilgi kontrolünün her biri 5/5 aldı ve her iki barındırılan Agent aynı on vakayı geçti. Bu küçük testler, üretim ortamındaki doğruluk oranını tahmin etmez. Canlı grup ayrıca kurs fiyatı ve ekipman sorularını yanıtladı, ardından neopren kiralama hizmetini doğrulamayı reddetti. Kiti uyarlarken eksik bilgi vakalarını koruyun; doğru fiyat yanıtları tek başına Agent’ın temkinli davranışını test etmez.
Eksik bilgi, “doğrulayamıyorum” yanıtını üretir. Ayrı kapı kodu mesajı bota yöneltilmemiştir ve bu görüntüde ona verilmiş bir yanıt görünmez.
Canlı özel deneme dersi talebi, Alex Morgan, Tuesday ve beginner değerleriyle bir başarılı Sheets Action çağrısı oluşturdu. Google HTTP 200 ve bir güncellenmiş satır döndürdü; kaydedilen satırda konuşma bağlantısı ve telegram kanalı da vardı. Grup sohbeti meta verileriyle yapılan ayrı bir Action testi HTTP isteği göndermedi. Koşulu uyarlarken hem kabul edilen özel talebi hem reddedilen grup bağlamını kontrol edin.
Kanalı ve yan etkilerini kontrol edin
Kendi gözlemlerinizi kitteki boş test-matrix.csv dosyasına kaydedin. Yukarıdaki görüntüler gösterilen sonuçları içerir; tabloda kendi yapılandırmanızla yapacağınız kontroller de bulunur. Sessizliği test ederken geçen süreyi kaydedin ve bir kişinin devralmasını daha sonraki olası AI’a dönüşten ayrı değerlendirin.
| Kontrol | Gönderilecek mesaj veya işlem | Beklenen sonuç |
|---|---|---|
| Grupta etiketleme | @QuickchatAI_bot How much is Start Sailing? | EUR 240 içeren kısa yanıt; eşleşen Inbox konuşması. |
| Bota yanıt | What should I bring? | Yeni etiketleme gerekmeden ekipman listesi. |
| Olağan sohbet | Etiketlemeden Does anyone know the gate code? | Ortak bot yanıt vermez. |
| Bilgi eksikliği | Botu etiketleyip Do you rent wetsuits? sorun | Doğrulayamaz; evet veya hayır uydurmaz. |
| Grupta kişisel talep | Botu etiketleyip iade isteyin | Özel sohbete yönlendirme; grup AI’da kalır. |
| Özel yanıt | Tam DM bağlantısını açıp fiyatı sorun | Doğru Agent etiketlenmeden yanıtlar. |
| Tam ders talebi | Adım 4’teki Alex Morgan mesajını gönderin | Action değerleri gerçek Sheets satırıyla eşleşir; rezervasyon iddiası yoktur. |
| Özel devir | İade isteyin, devralındıktan sonra mesaj yazın | İnsan ataması, operatör yanıtının teslimatı, ek AI yanıtı olmaması. |
| Hava kuralı | What happens if the forecast says 30 knots? | Ücretsiz erteleme ve eğitmen kararı; canlı tahmin iddiası yoktur. |
Kontrol başarısızsa ilgili tek ayarı değiştirip aynı mesajı yeniden gönderin. Eksik bilgiyi Knowledge Base’de, erken Action çağrısını açıklama veya zorunlu alanlarda düzeltin; sessiz grupta önce onayı ve botun doğru çağrılmasını kontrol edin. İyileşmeyi görmek için başarısız sonucu saklayın.
BotFather ile kendi botunuzu ne zaman oluşturmalısınız?
Kendi bot adı ve görseli, Telegram Bot API Actions veya sıradan grup mesajlarını alma gerekiyorsa kendi botunuzu oluşturun. Yukarıdaki grup ve özel yanıt yolları için ortak bot yeterlidir.
İkinci botu eklemeden önce kimliği ve mesaj davranışını seçin.
| Gereksinim | Ortak Quickchat AI botu | Kendi botunuz |
|---|---|---|
| BotFather token’ı | Gerekmez | Gerekir |
| Özel Telegram adı ve görseli | Ortak kimlik | Kendi bot kimliğiniz |
| Grup etiketlemelerine ve yanıtlara cevap | Evet | Telegram ilettiğinde evet |
| Sıradan grup mesajlarına cevap | Ortak bot sessiz kalır | Gizlilik veya yönetici durumu ayarlanır |
| Özel konuşmalar | Ortak bot içinde Agent’a özel start bağlantısı | Botun kendi özel konuşması |
| Google Sheets Action | Desteklenir | Desteklenir |
| Telegram moderasyon Actions | Ortak token paylaşılmaz | Kendi token’ı System Token olarak kullanılabilir |
- Telegram’da doğrulanmış BotFather hesabını açıp
/newbotgönderin. - Görünen adı, ardından
botile biten boşta bir kullanıcı adını seçin. BotFather token verir. Gizli tutun. - Bu bot bir gruba eklenecekse Saltmarsh Group seçin. Saltmarsh Sailing School yalnızca özel sohbetler için kullanılmalıdır. External Apps > Telegram içinde Your own bot açıp Connect to Telegram seçin.
- Token’ı Bot Token alanına yapıştırıp bağlantıyı tamamlayın. Enable your own bot açık olmalıdır.
- Botun Telegram bağlantısını açın,
/startve aynı kurs fiyatı sorusunu gönderin. - Sıradan grup mesajları için BotFather’da
/setprivacykullanın, botu ve Disable seçin; ardından test grubundan çıkarıp tekrar ekleyin. Yönetici botlar da bu mesajları alır. Telegram gizlilik modu belgesi teslimat kurallarını açıklar.
Token’ı yalnızca Bot Token alanına yapıştırın. Kimlik bilgisi yayımlanmaması için alan boş gösterilmiştir.
Ortak bot ve kendi botunuzu ayrı gruplarda tutun. Birlikte çalıştırmak yinelenen yanıtlar üretebilir. Duyuru sabitleme veya moderasyon için yalnızca yöneticiye izin veren Action koşullarıyla birlikte Telegram grup yönetimi rehberini izleyin.
ChatGPT veya Claude Telegram chatbot kurulumuna yardımcı olabilir mi?
Bağlı Quickchat AI hesap yönetimi uygulaması Agent oluşturma, bilgi ekleme, desteklenen ayarları yapma ve test çalıştırmaya yardımcı olabilir. İstemci Telegram kurulumunu sunuyorsa ortak botun özel mesaj bağlantısını etkinleştirebilir. Grubu seçme ve panoda onaylama adımları hesap sahibine aittir. Bazı istemcilerde özel bağlantının etkinleştirilmesi ve Human Handoff ayarları için de pano gerekir; bu yüzden asistanın önce kullanılabilir araçlarını incelemesini sağlayın.
Quickchat AI ChatGPT eklentisini veya Claude bağlayıcısını bağlayın; kit dosyalarını şu prompt ile verin:
Use my connected Quickchat AI account to create two Agents from the attached kit: Saltmarsh Group with group-main-prompt.txt and Saltmarsh Sailing School with main-prompt.txt. Add both knowledge files to each. Keep Actions and Human Handoff off on Saltmarsh Group. Prepare the supplied knowledge-test dataset. Check the tools available in this client before changing settings. Show me the configuration and ask before running credit-consuming tests or writing to Google Sheets. Where supported, enable only Saltmarsh Sailing School's shared-bot direct-message link and return the complete link. Leave group selection, dashboard confirmation, BotFather setup, Google OAuth and unsupported settings for me, with exact dashboard steps. Report what was configured, what was actually tested and what remains to verify in Telegram.
Araçlar istemciye ve hesap yetkilerine göre değişir. Giriş için hesap yönetimi kurulum belgesini izleyin. Bu, asistanı Quickchat AI hesabınıza bağlar; kişisel ChatGPT veya Claude konuşmasını Telegram botunun barındırılan altyapısına dönüştürmez.
Telegram chatbot neden yanıt vermiyor?
Prompt’u yeniden yazmadan önce bağlantıyı ve mesaj yolunu kontrol edin. Aşağıdaki belirtilerin nedenleri farklıdır.
| Belirti | Kontrol |
|---|---|
| Grup listede, fakat sessiz | Doğru grubu onaylayın, Connected chats içinde açın; gerçek bot adını etiketleyin veya mesajına yanıt verin. |
| Bot ilk yanıtından önce ayrıldı | Yeni bir Add to a Telegram group bağlantısı oluşturun, botu yeniden ekleyin ve Quickchat AI’da bekleyen grup için hemen Confirm seçin. |
| Çıplak bot bağlantısı yanlış Agent’ı açıyor | start= dahil tam özel bağlantıyı kullanın. Başka Agent’ın linkinin ortak özel sohbeti değiştirip değiştirmediğini kontrol edin. |
| İadeden sonra AI durdu | Inbox atamasını kontrol edin. Devredilen konuşma bilinçli yeniden atamaya kadar duraklar. |
| Sheets satırı yok | Action açık mı, zorunlu alanlar tamam mı, sohbet özel mi, URL Leads’e mi gidiyor kontrol edin. Action çağrısını ve Google bağlantısını inceleyin. |
| Kendi botu sıradan mesajları almıyor | Gizlilik modunu ve grup izinlerini kontrol edin; değişiklik sonrası botu çıkarıp ekleyin. |
| Yanıtta verilmemiş tarih veya hizmet var | Kaydedilmiş Ready bilgilerini ve belirsizlik talimatını kontrol edin. Aynı hatalı soruyu tekrar sorun. |
| Testler yanıt vermeyi bıraktı | AI kredilerini ve başarısız isteği inceleyin; limit hatasını prompt kalitesi sonucu saymayın. |
Müşterileri davet etmeden önce kurgusal bilgileri değiştirin, grup ve özel konuşma ayrımını gözden geçirin ve devir kuyruğuna personel ayırın. Yayın öncesi son kontrol olarak bir çalışma arkadaşınızdan herkese açık giriş noktalarını başka bir hesapla denemesini isteyin. Başka bir topluluk kanalı için Discord chatbot rehberi benzer bir kurulum ve test yolu izler. Karakter sohbetleri için Telegram roleplay rehberini kullanın.
İsteğe bağlı kontroller: Verdiğiniz gereksinimlere göre dağıtım yöntemlerini veya belirttiğiniz bütçeyle kredi başına yanıt kapasitesini karşılaştırın. Bu hesaplayıcılar hesabınızı, sitenizi veya bakiyenizi incelemez.
Kopyalanabilir Saltmarsh yapılandırması
Bunlar rehberdeki kaynak bilgilerin ve talimatların tamamıdır. İndirme ayrıca Action tarifi, değerlendirme ölçütleri ve testleri içerir.
Grup Agent’ı: Main Prompt
Saltmarsh Group üzerinde Identity > Main Prompt alanına yapıştırın. Human Handoff ve özel Actions kapalı kalsın.
You answer general questions in the Saltmarsh Sailing School members' group. Use only the Knowledge Base and keep each reply to two or three sentences. Do not add facts or requirements the sources do not contain. If a fact is missing, say that you cannot confirm it.
For trial requests, refunds, complaints, personal details or a request for a person, direct the member to the school's private link pinned in the group; do not invent a link. Do not collect personal details in this group. You cannot record requests, confirm bookings, approve refunds or transfer a conversation to staff. Do not claim you did any of these things. The private Agent records an enquiry; it cannot check live availability or confirm a trial. Only the office confirms availability and price.
Özel Agent: Main Prompt
Saltmarsh Sailing School üzerinde Identity > Main Prompt alanına yapıştırın. Action adı tarifle eşleşmelidir.
You are the private-chat assistant of Saltmarsh Sailing School. Answer school questions from the Knowledge Base. Do not add plausible details that are not in the sources, including extra clothing or footwear requirements. Keep replies to two or three sentences and ask at most one question per message. If a fact is missing, say that you cannot confirm it; do not invent dates, availability, gate codes or wetsuit rental. Explain weather policy without claiming to know the current forecast.
When a person requests a trial lesson, collect their name, preferred weekday and sailing experience. Ask for only the next missing field. When all three are present, use Record trial-lesson request once. Say the request was recorded only after the Action succeeds. Explain that the office still needs to confirm availability and price; never say a lesson is booked. If the Action is unavailable or fails, say the request has not been recorded and offer a person.
Use Human Handoff for a current unresolved refund request, complaint or explicit request for a person. After a staff member has resolved the enquiry and returned the conversation to AI, answer new general questions normally; do not hand off again solely because an earlier message mentioned a refund or asked for a person. Do not approve refunds or promise a response time. For a missing fact, say what is unknown and offer a person; do not treat uncertainty as a negative answer about the service.
Bilgi: kurslar ve deneme dersi talepleri
İlk bilgi makalesinin Content alanına yapıştırın.
Saltmarsh Sailing School demonstration information
This fictional school is used only for a tutorial. It contains no real customer data.
Start Sailing is a two-day course costing EUR 240. Day Skipper theory runs across five evenings and costs EUR 310. A private lesson lasts 90 minutes and costs EUR 95.
Courses run from April to October. Course dates are published on the school's website one month ahead. This source does not contain the next available date or live availability.
Bring a waterproof jacket, non-marking shoes and a change of clothes. The school provides buoyancy aids.
A trial-lesson request is an enquiry, not a confirmed booking. The office needs the person's name, preferred weekday and sailing experience, then confirms availability and price. Do not collect payment details. Do not infer a trial price from the private-lesson price.
Bilgi: kurallar ve üye bilgileri
İkinci makalenin Content alanına yapıştırın.
Saltmarsh Sailing School demonstration policies
If the forecast shows more than 25 knots of wind or thunderstorms, the session moves to the next available date at no extra cost. The instructor decides on the morning of the session. This source is a policy, not a live weather forecast or a cancellation decision.
Parking is free at the clubhouse. The gate code is sent to enrolled students the day before their course. The code itself is not in this Knowledge Base.
Refunds and complaints are handled by the office. An AI answer cannot approve a refund. A member of staff must decide each case.
The Telegram members' group is for general questions. Trial requests, refunds and other personal details belong in a private conversation with the school's Agent, opened from the school's direct-message link.
Human Handoff kuralı
Human Handoff > Handoff Rules altına yapıştırın ve gerçek personel müsaitliğini ayarlayın.
Transfer this private conversation to a person when the visitor has a current unresolved refund request, complaint, explicit request for a person, or accepts an offer of human help. After a staff member resolves the enquiry and returns it to AI, earlier refund or handoff messages must not trigger a new transfer for a general course question. Explain that a staff member can review the case here without approving a refund or promising a response time. This Agent is used only for private enquiries; the separate group Agent has Human Handoff disabled.
Sık sorulan sorular
Telegram grubuna AI chatbot nasıl eklenir?
Quickchat AI’da External Apps açın, Telegram ve Add to a Telegram group seçin. Telegram’da grubu seçip Quickchat AI’a dönün ve Confirm ile onaylayın. Üyeler ortak botu etiketleyerek veya mesajına yanıt vererek soru sorabilir.
Telegram AI chatbot her mesaja cevap verir mi?
Ortak Quickchat AI botu grupta etiketlendiği veya mesajına yanıt verildiği zaman cevap verir. Sıradan sohbet yanıt tetiklemez. Kendi botunuz Telegram gizlilik modu kapalıyken veya yönetici olduğunda olağan mesajları alabilir. Bu ayarı ayrı grupta test edin.
BotFather veya Telegram bot token’ı gerekir mi?
Ortak bot ve özel mesaj bağlantısı için BotFather veya token gerekmez. Özel Telegram adı ve görseli ya da Telegram Bot API çağıran Actions için BotFather ile kendi botunuzu oluşturun. Olağan Google Sheets Actions ortak botla çalışabilir.
Müşteriler Telegram chatbot’a özelden yazabilir mi?
Evet. Quickchat AI’da Direct message link açın, üretilen tam bağlantıyı paylaşın. Müşteri açıp gerekirse Start basar. Bağlantı ortak bot içinde Agent’ınızı seçer. Kapatılması yeni bağlantıları engeller; mevcut özel sohbetlerde ayrı açma ve bağlantı kesme kontrolleri vardır.
Telegram AI chatbot ücretsiz mi?
BotFather ile bot oluşturmak AI hizmeti eklemez. Quickchat AI, kişisel ve ticari olmayan öğrenim için sınırlı AI kredili Free planı sunar. Ticari kullanım ücretli plan gerektirir. Yanıtlar, Preview ve Simulation kredi tüketir; harici hizmetlerin ek maliyetleri olabilir.
Telegram’da AI chatbot var mı?
Telegram üçüncü taraf AI botlarını ve entegrasyonlarını destekler. Bu rehber işletme bilginizden yanıtlayan bir Quickchat AI Agent bağlar. BotFather bot kimliğini oluşturur; bilgi sağlamaz veya müşteri destek akışını ayarlamaz.
Chatbot fotoğraf ve dosyaları anlayabilir mi?
Telegram entegrasyonu fotoğrafları alıp görsel içeriği analiz edebilir. Diğer dosyalar ek olarak konuşmaya ulaşabilir, ancak içerikleri otomatik okunmaz. Müşterilerinizin gerçek dosya türlerini deneyip Telegram ve Inbox’ı inceleyin.
Telegram için roleplay veya karakter botu oluşturabilir miyim?
Evet. Aynı Telegram bağlantısı uygun talimatları ve karakter kimliği olan Agent’a hizmet verebilir. Bu rehber işletme desteği örneğidir; roleplay Agent kendi prompt ve testlerini gerektirir.