Bu rehberde: Dakikalar içinde bir Telegram botu oluşturup OrqLabs'a bağlarsınız. Telegram ücretsizdir, işletme doğrulaması istemez ve webhook'u OrqLabs kendisi kaydeder.
⏱ 10 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | TELEGRAM |
| Kategori | Mesajlaşma |
| Kimlik doğrulama | Token (@BotFather bot anahtarı) |
| Kapsam | Proje bazlı; her marka için ayrı bot |
| Webhook | Evet (OrqLabs kaydı sizin yerinize yapar) |
| Yetenekler | Mesaj gönderme, mesaj alma, toplu mesaj |
| Kullanan kutular | Mesaj geldi, Mesaj gönder, Toplu mesaj, Bildir (Telegram kanalı) |
| Kullanan ajanlar | AI Chatbot, Outreach Agent |
Ne işe yarar?
- Bota yazılan özel mesajlar ve grup mesajları Gelen Kutusu'nda konuşma olur ve iş akışını tetikler.
- AI Chatbot yanıt verir, müşteri bilgisi toplar, gerekirse insana devreder.
- Tekil mesaj ve daha önce botla konuşmuş adaylara kampanya gönderirsiniz.
- Bir kanala duyuru için botu kanal yöneticisi yaparsınız.
- Bildir kutusunda Telegram seçilirse ekip bildirimleri varsayılan sohbete düşer.
Ön koşullar
- Bir Telegram hesabı.
- Platform yöneticisinin
PUBLIC_WEBHOOK_URLdeğerini herkese açık HTTPS adres olarak tanımlamış olması (üretimdehttps://api.orqlabs.com). Telegram yalnızca HTTPS kabul eder. - Ek OAuth uygulaması gerekmez; tüm yetki bot anahtarındadır.
Adım adım kurulum
A) Telegram @BotFather
- Telegram'da @BotFather sohbetini açın ve ①
/newbotyazın. - ② Botun görünen adını girin (örneğin "Marka Destek").
- ③ Kullanıcı adını girin; benzersiz olmalı ve
botile bitmeli (markadestek_bot).
- BotFather ① anahtarı verir. Biçim
<bot_id>:<secret>, örneğin1234567890:AAExample…. Güvenli bir yere kopyalayın; herkes bu anahtarla botunuzu yönetebilir. - Profili tamamlayın (isteğe bağlı):
/setdescription,/setabouttext,/setuserpic,/setcommands. - Grup desteği için: ③
/setjoingroups→ Enable. ②/setprivacy→ Disable; kapalıyken bot gruplarda yalnızca komutları ve etiketlendiği mesajları görür. Değişiklik botu gruptan çıkarıp yeniden ekleyince geçerli olur.
B) OrqLabs'ta bağlama
- Entegrasyonlar → Telegram Bot kartında Bağla.
- ② Proje seçin.
- ① Bot Token alanına anahtarı yapıştırın.
- ③ Default channel / chat ID (optional): bildirim ve duyuruların gideceği sohbet; kanal için
-100…ile başlayan kimlik veya@kanaladi. - ⑤ Bağla. OrqLabs anahtarı doğrular ve ④ webhook'u Telegram'a kendisi kaydeder. Kart Bağlı olur.
- Telefonunuzdan bota
/startyazın. Gelen Kutusu'nda yeni konuşma görünmelidir.
Chat kimliği nasıl bulunur?
| Hedef | Biçim | Yöntem |
|---|---|---|
| Kişi | Pozitif sayı (123456789) | Kişi @userinfobot'a yazar; ya da bota yazdığında Gelen Kutusu konuşma detayında contactId |
| Grup | Negatif sayı (-123456789) | Botu gruba ekleyin; ilk mesaj sonrası Gelen Kutusu'nda görünür |
| Süper grup / kanal | -100… | Kanaldaki bir mesajı @userinfobot veya @getidsbot'a iletin |
| Herkese açık kanal | @kanaladi | Doğrudan kullanın |
Kanal yayınları için botu kanala Administrator olarak ekleyin ve Post Messages iznini açın.
Webhook
Telegram'da webhook'u siz girmezsiniz. OrqLabs bağlantıyı kaydettiğinde şu adrese kaydı yapar:
https://api.orqlabs.com/api/v1/webhooks/telegram/<hesap kimliği>
Rastgele bir gizli anahtar da gönderilir; eşleşmeyen istekler reddedilir. Kart ayrıntısındaki Webhook URL kayıtlı adresi ve son hatayı gösterir.
Geliştirici notu: Elle kayıt:
https://api.telegram.org/bot<TOKEN>/setWebhook?url=<adres>. Kontrol:getWebhookInfo. Aynı anahtarı başka bir sistemdegetUpdatesile kullanamazsınız; bir bot için tek alım yöntemi geçerlidir.
İzinler
OAuth yoktur; tüm yetki bot anahtarındadır.
| Ayar | Nerede | Etkisi |
|---|---|---|
| Gizlilik modu | @BotFather /setprivacy | Kapalı: grupta tüm mesajlar gelir |
| Gruplara katılma | @BotFather /setjoingroups | Kapalı: bot gruba eklenemez |
| Kanal yöneticiliği + Post Messages | Kanal ayarları | Kanala mesaj gönderme |
Dikkat: Bot bir kullanıcıya ilk mesajı gönderemez. Kullanıcı önce
/startyazmalı. Kampanyalar bu yüzden yalnızca botla konuşmuş adaylara ulaşır.
Limitler
| Konu | Sınır |
|---|---|
| Genel gönderim | ~30 mesaj/saniye |
| Aynı özel sohbet | 1 mesaj/saniye |
| Aynı grup | 20 mesaj/dakika |
| Metin | 4.096 karakter; medya açıklaması 1.024 |
| Medya (adresle) | Fotoğraf 5 MB, diğer 20 MB |
| Toplu mesaj | Dakikada varsayılan 20; kişilere 50'ye kadar çıkabilir |
Bağlantıyı test etme
② Bağlantıyı test et botun kullanıcı adını, grup yeteneklerini ve kayıtlı webhook adresini gösterir. Ardından bota /start yazın ve Gelen Kutusu'nu kontrol edin.
Kimlik bilgilerini yenileme
- @BotFather'da
/mybots→ botunuz → API Token → Revoke current token. Eski anahtar anında geçersiz olur. - Yeni anahtarı entegrasyon kartı → Kimlik bilgileri → Güncelle → Bot Token alanına yapıştırın. OrqLabs webhook'u yeni anahtarla tekrar kaydeder.
- Botu başka projeye taşımak için ayrıntı panelinde Proje alanını değiştirip Kaydet deyin.
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
AUTH – 401 | Anahtar yanlış veya iptal edilmiş | @BotFather'dan yeniden alın |
INVALID – "chat not found" | Kimlik yanlış, -100 eksik, kullanıcı /start yazmamış | Kimliği doğrulayın |
| "bot was blocked by the user" | Kullanıcı engelledi | Adaya unreachable etiketi |
| "bot is not a member of the channel chat" | Kanala yönetici eklenmemiş | Administrators → botu ekleyin |
| "bot can't initiate conversation" | Kullanıcı bota yazmamış | /start göndermesini sağlayın (t.me/<bot>?start=…) |
RATE_LIMIT – 429 | Hız limiti | Dakika hızını düşürün |
| "message is too long" | 4.096 aşıldı | Kısaltın |
| "can't parse entities" | Biçimlendirme bozuk | Düz metin gönderin |
| "HTTPS url must be provided" | PUBLIC_WEBHOOK_URL HTTP | HTTPS adres |
| Grup mesajları düşmüyor | Gizlilik modu açık | /setprivacy → Disable; botu yeniden ekleyin |
Sık sorulan sorular
Ücretli mi? Hayır. Telegram Bot API ücretsizdir.
Müşterilerime ilk mesajı ben atabilir miyim?
Hayır. Kullanıcı önce bota yazmalıdır. QR kod veya t.me/<bot> bağlantısı paylaşın.
Bir botu iki markada kullanabilir miyim? Hayır. Bot tek projeye aittir. Her marka için ayrı bot oluşturun.