Kanallar: Telegram, WhatsApp, VK
Telegram, WhatsApp ve VK'yı aynı projeye bağlayın. Kanalların özelliklerini ve yanıtların nereye gönderildiğini öğrenin.
Bu sayfada
Bir GetMyBot projesi Telegram, WhatsApp ve VK üzerinden yanıt verebilir. Örneğin ders programını paylaşan bir tepkiyi üç uygulamada da kullanabilirsiniz. Yanıt, kişinin mesaj gönderdiği uygulamaya döner.
Başka bir uygulama bağladığınızda düğmeleri ve eylemleri kontrol edin: uygulamaların desteklediği özellikler farklıdır. Aşağıda bu farkları ve bağlantı adımlarını bulabilirsiniz.
Kanal nedir?
Kanal, mesajların gönderilip alındığı bağlı bir hesaptır: belirli bir Telegram botu, WhatsApp Business numarası veya VK topluluğu. Bir GetMyBot botuna birden çok kanal bağlanabilir. Tepkiler ortaktır: abone WhatsApp'tan yazdığında, mesaj Telegram'dakiyle aynı tepkiler tarafından işlenir ve yanıt WhatsApp'a gönderilir.
Düğmeler, metin biçimlendirmesi ve eylemler her uygulamada aynı şekilde çalışmaz. Oluşturucu, desteklenmeyen bir ayarı gizleyebilir veya desteklenen bir biçime dönüştürebilir. Kullanıma açmadan önce mesajı bağlı her kanalda deneyin.
Ana kanal (primary_channel)
Her botun bir ana kanalı (primary_channel) vardır: botun öncelikle ilişkilendirildiği uygulama. Genellikle Telegram'dır; ancak Telegram hesabı olmadan doğrudan bir WhatsApp veya VK botu da oluşturabilirsiniz. Ana kanal bot oluşturulurken belirlenir ve bot listesinde görünür. Diğer kanalları daha sonra eklersiniz.
Kanalların özellikleri
Aşağıdaki özet, her kanalın hangi uygulama özelliklerini desteklediğini gösterir. Güncel makine tarafından okunabilir listeyi GET /api/channels/capabilities API uç noktasından alabilirsiniz.
Telegram: En kapsamlı kanal. Satır içi düğmeler ve yanıt klavyesi, düğme tıklamasını tepkiye bağlama (callback), emoji tepkileri, /start deep link'i, mesaj düzenleme, silme ve iletme, yanıtı tetikleyici olarak kullanma, katılımcı olayları, yetkiler ve moderasyon desteklenir. Fotoğraf karuselindeki kartlar, tek bir mesajda düğmelerle değiştirilir. Metin biçimleri: Plain / HTML / Markdown. WhatsApp şablonları, listeleri ve 24 saatlik oturum penceresi Telegram'da kullanılmaz.
WhatsApp (WhatsApp Cloud API üzerinden): Satır içi düğmeler, callback, emoji tepkileri ve /start deep link'inin yanı sıra mesaj şablonları, etkileşimli listeler (interactive list) ve 24 saatlik oturum penceresi vardır. Metin biçimleri: Plain / Markdown. Yanıt klavyesi; mesaj düzenleme, silme ve iletme; yanıtı tetikleyici olarak kullanma; katılımcı olayları; yetkiler ve moderasyon; tek mesaj içinde karusel kartları arasında gezinme desteklenmez. Ayrıntılar için WhatsApp sayfasına bakın.
VK: Mesajlar ve ekler, satır içi düğmeler ve yanıt klavyesi, callback, emoji tepkileri, /start deep link'i, mesaj düzenleme, silme ve iletme, katılımcı olayları, engelleme ve engeli kaldırma, kapalı topluluğa önceden gönderilmiş katılım isteğini onaylama ve ücretli VK Donut abonelik olayları desteklenir. Yalnızca düz metin biçimlendirmesi vardır; HTML/Markdown gösterilirken temizlenir. WhatsApp şablonları, listeler, tek mesaj içinde karusel gezinmesi ve oturum penceresi VK'da yoktur.
Tüm kanallarda satır içi düğmeler, callback, emoji tepkileri ve /start deep link'i kullanılabilir. Fotoğraf destekleyen kanallarda fotoğraf karuseli bloğu da kullanılabilir. Telegram'da, bütün fotoğrafların uygun dosya kimlikleri varsa kartlar tek mesajda gösterilir. WhatsApp ve VK'da, ayrıca Telegram'da bu kimlikler yoksa, kartlar ayrı fotoğraf mesajları olarak gönderilir. Bkz. Mesajlar ve düğmeler.
VK Donut
Topluluğunuzda VK Donut açıksa bot, ücretli aboneliklerle ilgili şu sistem olaylarını alır:
| Oluşturucudaki olay | Anahtar | Kullanılabilir değişkenler |
|---|---|---|
| VK Donut: subscription created (abonelik başlatıldı) | donut_subscription_created | {{event.donut_amount}}, {{event.donut_amount_without_fee}} |
| VK Donut: subscription prolonged (abonelik yenilendi) | donut_subscription_prolonged | {{event.donut_amount}}, {{event.donut_amount_without_fee}} |
| VK Donut: subscription expired (abonelik sona erdi) | donut_subscription_expired | yok |
| VK Donut: subscription cancelled (abonelik iptal edildi) | donut_subscription_cancelled | yok |
{{event.donut_amount}} ödeme tutarıdır; {{event.donut_amount_without_fee}} ise VK komisyonu çıkarıldıktan sonraki tutardır. Sona erme ve iptal olaylarında tutar bulunmaz. Ücretli sürenin bitmesi yeni bir ödeme yapıldığı anlamına gelmez; eski bir tutarı göstermek yanıltıcı olur.
Bu olay aboneyle ilgilidir, aboneden gelen bir mesaj değildir. Bu nedenle özel mesaj gönderme hakkı açmaz, engeli kaldırmaz, «son etkinlik» zamanını değiştirmez ve mesaj sayısını artırmaz. Karttan ödeme alınması kişinin yazdığı anlamına gelmez. Abone platformda henüz yoksa kaydı oluşturulur; böylece ona etiket ve yetki uygulanabilir.
Ücretli bir topluluk için örnek akış:
- VK Donut: subscription created ve VK Donut: subscription prolonged olayları için tepki oluşturun. Etiketleri değiştir eylemiyle «Kulüp» etiketini
ttl_days= 31 süreyle ekleyin. Ardından kapalı topluluğun bağlantısını içeren bir mesaj gönderip kişiden katılım isteği göndermesini isteyin. - Katılım isteğini kişi gönderdikten sonra onaylayın. Hakları değiştir → Katılma isteğini onayla eylemi, yalnızca önceden gönderilmiş bir isteği kabul eder (
groups.approveRequest). İstek henüz yoksa onaylanacak bir şey de yoktur. Bu eylemi birinci adımdan sonra çalışan bir tepkiye koyun: örneğin aynı mesajın altındaki «İstek gönderdim» düğmesine veya sonraki VK Donut: subscription prolonged olayına. - Label expired (
label_expired) tetikleyicisine Hakları değiştir → Çıkar eylemini ekleyin. Böylece VK'dan aboneliğin sona erdiği olayı gelmese bile etiket süresi dolunca kişi kulüpten çıkar. Ayrıntılar: Tetikleyiciler → Etiketin süresi doldu. - VK Donut: subscription cancelled ve VK Donut: subscription expired olayları için Etiketleri değiştir → «Kulüp» etiketini kaldır eylemini, gerekiyorsa hemen Çıkar eylemini kullanın.
VK yetki eylemlerindeki Sohbet (chat_id) alanına, bağlı VK topluluğunun sayısal kimliğini girin. Kanal listesinde görünen topluluk kimliğiyle aynı olmalıdır. VK yalnızca o topluluğun üyelerini yönetebilir. Farklı bir kimlik girerseniz eylem VK'ya gönderilmeden reddedilir. Başka bir topluluğu yönetmek için onu ayrı bir kanal olarak bağlayın.
Olayları etkinleştirme:
- Long Poll: Bot, kanal bağlandığında ve platform her başlatıldığında olaylara otomatik abone olur. Önceden bağlanmış topluluklar için ek işlem gerekmez.
- Callback API: Topluluk ayarlarında API ile çalışma → Callback API → Olay türleri → VK Donut bölümünü açın ve tablodaki dört olayı da etkinleştirin.
Kanal nasıl bağlanır?
Kanalları Projeler sayfasından ekleyebilirsiniz.
- Projeler sayfasını açıp ilgili projeyi bulun.
- Proje kartında Kanal ekle düğmesine basın.
- Telegram, WhatsApp veya VK'yı seçin.
- Kanal bilgilerini girin: Telegram için token, WhatsApp için Meta bilgileri, VK için topluluk bilgileri.
- Doğrula düğmesine basın. Platform, bilgileri mesajlaşma hizmeti üzerinden kontrol eder.
- Bağla düğmesine basın.
WhatsApp ve VK kanallarında, bağlandıktan sonra bir webhook adresi görünür (🔗 simgesi). Gelen olayların bota ulaşması için bu adresi ilgili hizmete girin: WhatsApp için Meta uygulamasına, VK için topluluk ayarlarına. WhatsApp adımları: WhatsApp → Webhook kurulumu.
Sonraki adımlar
- WhatsApp: bağlantı, webhook, oturum penceresi ve mesaj şablonları.
- Projeler ve kanallar: bot bağlantısının temel adımları.
- Tepkiler: temel bilgiler: botun bütün kanallarda kullandığı davranış.
Kanal kimlik bilgileri
Telegram için BotFather'ın verdiği tam token gerekir. VK için topluluk token'ı ve sayısal topluluk kimliği; Callback API kullanıyorsanız ayrıca gizli anahtar ve doğrulama kodu gerekir. WhatsApp için Phone Number ID, WhatsApp Business Account ID, hesaba erişim token'ı, webhook Verify Token'ı ve Meta uygulamasının App Secret değeri gerekir.
Bağlanmadan önce bilgileri kontrol edin. Bir anahtarı değiştirdiğinizde ilgili hizmetteki ayarı da güncelleyin: Verify Token, webhook adresini doğrular; App Secret, gelen olayların imzasını kontrol eder. Bunlar API erişim token'ının yerine geçmez.
Gelen olaylar ve webhook adresleri
VK Callback API için MyBot'un gösterdiği adresi topluluğun sunucu ayarlarına girin; gizli anahtar ve doğrulama kodu iki tarafta aynı olmalıdır. Long Poll için herkese açık bir adres veya bu iki değer gerekmez. WhatsApp için adresi Meta uygulamasına kaydedin, aynı Verify Token'ı girin ve mesaj olaylarına abone olun. Yalnızca gönderim kimlik bilgilerini girmek, gelen mesajları etkinleştirmez.
Instagram ve Messenger yetkilendirmesi
Bağlantı sihirbazı Meta oturum açma sayfasını açar. İlgili Facebook Sayfasını veya profesyonel Instagram hesabını yöneten hesapla giriş yapın, istenen izinleri verin ve bu proje için hesapları seçin. Sihirbaz izinleri, webhook aboneliğini ve mesaj teslimine hazır olup olmadığını kontrol eder. Kanalı kullanmadan önce başarısız kontrolleri giderin. Bağlı bir kanalda seçilen hesapları daha sonra yeniden gözden geçirebilirsiniz.