Skip to content

Telegram

Bot token (kullanıcı tarafından sağlanır). Global app credential yok — her kullanıcı @BotFather üzerinden kendi botunu oluşturur ve token'ı connect formuna yapıştırır. Sosyabot getMe ve getChatMember ile doğrular.

Kimlik bir bakışta

AlanDeğer
Kimlik modeliKullanıcı tarafından sağlanan token
Gerekli ENV(yok)
Callback URL${BASE_URL}(callback yok — POST /api/v1/social/telegram/connect)
Scope'lar / izinlerbot her hedef chat'in member veya admin'i olmalıdır
Otomatik token yenilemeHayır — süresi dolduğunda manuel reconnect

ENV detayları

TELEGRAM_* env bloku yoktur — bot kimlik bilgileri connect anında gönderilir ve kanal kayıdında saklanır.

Nasıl bağlanılır

  1. @BotFather/newbot ile bir bot oluştur. Token'ı sakla.
  2. Yayın yapmak istediğin her kanal/grup/chat'e botu ekle.
  3. BağlantılarTelegramBağlan'ı aç, token + chat ID'lerini yapıştır.

Token yenileme

Telegram bot token'ları asla süresi dolmaz. Yalnızca @BotFather'da token'ı yeniden ürettiğinde yeniden bağlan.

Notlar

  • Bot, chat ID'sinin doğrulanması için her hedef chat'e member veya admin olarak eklenmelidir. Sosyabot, getChatMember'ın botun admin olmadığını rapor ettiği her chat için bir uyarı döner.
  • Chat ID'leri hem sayısal (-100123456789) hem @channelusername formatlarını kabul eder. Sayısal ID'ler kararlıdır; kullanıcı adları değişir.
  • Metin Telegram API limitleri başına 4096 karaktere ve photo/video açıklamaları 1024 karaktere kesilir.

Sorun giderme

Kanal needs_reconnect gösteriyorsa, access token Telegram tarafından reddedilmiştir. Yaygın sebepler:

  • Kullanıcı Sosyabot'un yetkilendirmesini platform üzerinden iptal etmiştir.
  • Platform token'ı geçersiz kılmıştır (şifre değişikliği, güvenlik olayı).
  • OAuth uygulama kimlik bilgileriniz değişmiştir ve mevcut token'lar artık eşleşmiyordur.

Yukarıdaki bağlantı akışını yeniden çalıştır. Çalışma alanı genelinde checklist için Sorun Giderme'ye bak.

İlgili