Geliştirici paneli inkiveta.com

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)AyarDikkat
python-telegram-bot 22.8Application.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.0Bot(T, session=AiohttpSession(api=TelegramAPIServer.from_base("https://app.inkiveta.com")))kök bot içermez · is_local=False
Telegraf 4.16.3new Telegraf(T, { telegram: { apiRoot: "https://app.inkiveta.com" } })alt yol kullanılırsa sonda / şart
grammY 1.46.0new 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#

  1. inkiveta'da Atölye'den uygulamanı oluştur ve token'ı al (İlk sohbet botun).
  2. Kodunda token'ı ve sunucu adresini değiştir (tablo).
  3. Atölye → Profil'de barındırma ülkesini beyan et; sunucun yurt dışındaysa aktarım sözleşmesini kabul et (Gizlilik).
  4. setMyCommands, açıklama, profil fotoğrafı gibi ayarları yeniden yap — bunlar Telegram'dan taşınmaz.
  5. Önce test ortamında dene, sonra gerçek ortamda webhook'u kur ya da yoklamayı başlat.

Bilinmesi gereken farklar#

Konuinkiveta'da
Sohbet türüYalnız özel sohbet (kullanıcı ↔ bot). Grup, kanal, inline mod, business, hikâye, hediye, Passport yok
Kullanıcı kimliğiUygulamaya özel takma kimlik; aynı kişi iki uygulamada farklı id. Telefon numarası gelmez
403Kullanıcının yazma tercihi de 403 üretir; kullanıcıyı silmeden önce description'a bak (kurallar)
StarsYerine Ink: XTR de INK de kabul, 1 birim = 1 Ink (Ödemeler)
file_pathGöreli döner (photos/…); indirme adresi https://app.inkiveta.com/file/bot<token>/<file_path>
BarındırmaGerçek ortamda barındırma ülkesi beyanı zorunlu (KVKK)
Mini AppBiyometri, sensör ve kamera köprüleri yok; alan adı doğrulaması gerekir (Mini App)
Webhook yanıtında yöntemYanı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üphaneYöntem çağırmakUzantı update'ini okumak
python-telegram-botcontext.bot.do_api_request("inkiSendComponent", api_kwargs={...})update.api_kwargs["inki_component_action"]
aiogramKendi TelegramMethod alt sınıfın ya da doğrudan HTTPham update sözlüğü (update.model_extra)
Telegrafctx.telegram.callApi("inkiSendComponent", {...})ctx.update.inki_component_action
grammYbot.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).