Telegram'dan taşıma
inkiveta Bot API'si Telegram Bot API 10.4 ile uyumludur. Mevcut bir Telegram botunu çoğu zaman yalnız sunucu adresini değiştirerek taşırsın. Atölye → "Telegram'dan taşı" ekranı da aynı satırları gösterir (T = token).
| Kütüphane (denenen sürüm) | Ayar | Dikkat |
|---|---|---|
| python-telegram-bot 22.8 | Application.builder().token(T).base_url("https://app.inkiveta.com/bot").base_file_url("https://app.inkiveta.com/file/bot").build() | base_url sonunda / olmamalı · local_mode kapalı kalmalı · iki adres de verilmeli |
| aiogram 3.31.0 | Bot(T, session=AiohttpSession(api=TelegramAPIServer.from_base("https://app.inkiveta.com"))) | kök bot içermez · is_local=False |
| Telegraf 4.16.3 | new Telegraf(T, { telegram: { apiRoot: "https://app.inkiveta.com" } }) | alt yol kullanılırsa sonda / şart |
| grammY 1.46.0 | new Bot(T, { client: { apiRoot: "https://app.inkiveta.com" } }) | apiRoot sonunda / hata verir · @grammyjs/files için apiRoot ayrıca verilir |
Test ortamı ayarları: Test ortamı.
Adım adım#
- inkiveta'da Atölye'den uygulamanı oluştur ve token'ı al (İlk sohbet botun).
- Kodunda token'ı ve sunucu adresini değiştir (tablo).
- Atölye → Profil'de barındırma ülkesini beyan et; sunucun yurt dışındaysa aktarım sözleşmesini kabul et (Gizlilik).
setMyCommands, açıklama, profil fotoğrafı gibi ayarları yeniden yap — bunlar Telegram'dan taşınmaz.- Önce test ortamında dene, sonra gerçek ortamda webhook'u kur ya da yoklamayı başlat.
Bilinmesi gereken farklar#
| Konu | inkiveta'da |
|---|---|
| Sohbet türü | Yalnız özel sohbet (kullanıcı ↔ bot). Grup, kanal, inline mod, business, hikâye, hediye, Passport yok |
| Kullanıcı kimliği | Uygulamaya özel takma kimlik; aynı kişi iki uygulamada farklı id. Telefon numarası gelmez |
| 403 | Kullanıcının yazma tercihi de 403 üretir; kullanıcıyı silmeden önce description'a bak (kurallar) |
| Stars | Yerine Ink: XTR de INK de kabul, 1 birim = 1 Ink (Ödemeler) |
file_path | Göreli döner (photos/…); indirme adresi https://app.inkiveta.com/file/bot<token>/<file_path> |
| Barındırma | Gerçek ortamda barındırma ülkesi beyanı zorunlu (KVKK) |
| Mini App | Biyometri, sensör ve kamera köprüleri yok; alan adı doğrulaması gerekir (Mini App) |
| Webhook yanıtında yöntem | Yanıt gövdesindeki her yöntem yürütülür (Telegraf'ın 5 yöntemlik listesinden geniş) |
| Fazlası | Yerel bileşenler, ana sayfa ve hızlı eylemler, test ortamı, akış editörü, bildirim önemi, veri silme talebi |
Desteklenmeyen yöntemler#
Telegram'ın 193 yönteminin 87'si (grup/kanal/inline/business/stories/gift/passport) inkiveta'da anlamsızdır ve şunu döner:
400 Bad Request: method is not available for bots on this platform
404 Not Found yalnız hiç var olmayan (yanlış yazılmış) yöntem adına döner. Tam liste ve her yöntemin durumu: Yöntem listesi.
İpucu: Kodunda grup işleyicileri varsa silmene gerek yok; özel sohbet dışında update gelmeyeceği için hiç tetiklenmezler. Yalnız bu yöntemleri çağıran satırlar hata alır.
Kütüphanede inkiveta'ya özel şeyleri kullanmak#
inki önekli yöntemleri ve uzantı update'lerini (inki_component_action, inki_feedback, inki_data_deletion_request) kütüphaneler tanımaz:
| Kütüphane | Yöntem çağırmak | Uzantı update'ini okumak |
|---|---|---|
| python-telegram-bot | context.bot.do_api_request("inkiSendComponent", api_kwargs={...}) | update.api_kwargs["inki_component_action"] |
| aiogram | Kendi TelegramMethod alt sınıfın ya da doğrudan HTTP | ham update sözlüğü (update.model_extra) |
| Telegraf | ctx.telegram.callApi("inkiSendComponent", {...}) | ctx.update.inki_component_action |
| grammY | bot.api.raw.inkiSendComponent({...}) | ctx.update.inki_component_action |
allowed_updates listende bu türleri açıkça istemeyi unutma (veri silme talebi her zaman gelir).