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
| Alan | Değer |
|---|---|
| Kimlik modeli | Kullanıcı tarafından sağlanan token |
| Gerekli ENV | (yok) |
| Callback URL | ${BASE_URL}(callback yok — POST /api/v1/social/telegram/connect) |
| Scope'lar / izinler | bot her hedef chat'in member veya admin'i olmalıdır |
| Otomatik token yenileme | Hayı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
- @BotFather →
/newbotile bir bot oluştur. Token'ı sakla. - Yayın yapmak istediğin her kanal/grup/chat'e botu ekle.
- Bağlantılar → Telegram → Bağ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@channelusernameformatları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.