Geliştirici paneli inkiveta.com

İlk sohbet botun: 5 dakika

Bu sayfanın sonunda, sana yazılanı geri söyleyen ve bir "başarılı" kutusu gönderen çalışan bir sohbet botun olacak. Python ya da Node.js bilmen yeter; ikisi de yoksa curl ile de ilerleyebilirsin.

1. Uygulamanı oluştur#

  1. inkiveta uygulamasında Keşfet → "Kendi uygulamanı yap" yolunu izle (Keşfet alt çubuktadır; web sürümünde yan raydadır). Burası Atölye'dir.
  2. Gerekenler: telefon numarası doğrulanmış normal bir hesap. Normal hesap 1, Ink+ üyesi 5 uygulama açabilir.
  3. Bir kullanıcı adı seç: 5–32 karakter, harf, rakam ve _ (kuafor_ayse, hava_durumu). Sonu bot ile bitmek zorunda değil. Kullanıcı adı sonradan değiştirilemez.
  4. Bir görünen ad gir (ör. "Ayşe Kuaför"). Tanınmış bir markaya benzeyen adlar reddedilir; markanın sahibiysen Atölye → Destek'ten itiraz edebilirsin.
  5. Barındırma ülkesini seç: kodunun çalışacağı sunucu hangi ülkedeyse (Türkiye ise TR). Bu zorunlu; nedeni Gizlilik sayfasında.
  6. Uygulama Geliştirici Şartları'nı onayla.

2. Token'ı al#

Oluşturma bitince ekranda token görünür. Biçimi Telegram'la aynıdır:

text4711:AAH7xQe...35 karakter...

: işaretinden önceki sayı uygulamanın kimliğidir. Token'ı bir yere kaydet; sonra yalnız Atölye → Anahtar'dan, Sahip ya da Geliştirici rolündeysen görebilirsin.

Önemli: Token uygulamanın tam yetkisidir (mesaj gönderme, ödeme iadesi dahil). Kodun içine gömme, GitHub'a koyma; ortam değişkeninde sakla. Sızdığını düşünürsen Atölye → Anahtar → Yenile: eski token anında geçersiz olur.

3. Bağlantıyı dene#

Terminalde:

bashexport BOT_TOKEN='4711:AAH...'   # kendi token'ın
curl -s "https://app.inkiveta.com/bot$BOT_TOKEN/getMe"

Şuna benzer bir yanıt görmelisin:

json{"ok":true,"result":{"id":4711,"is_bot":true,"first_name":"Ayşe Kuaför","username":"kuafor_ayse",
 "can_join_groups":false,"can_read_all_group_messages":false,"supports_inline_queries":false,
 "inki_api_version":"1.0.0","inki_signature_public_key":"<base64url>"}}

{"ok":false,"error_code":401,"description":"Unauthorized"} görüyorsan token yanlış ya da yenilenmiş demektir.

4. Kendinle sohbet başlat#

Uygulaman sana ancak sen onu başlattıktan sonra yazabilir. inkiveta'da uygulamanı ara (ya da https://inkiveta.com/@<kullanici_adi> bağlantısını aç), profil sayfasında Başlat'a bas. Uygulamana /start mesajı gider.

5. İlk kodun: yankı botu#

Aşağıdaki örnekler uzun yoklama (getUpdates) kullanır; yani sunucunun internetten erişilebilir olması gerekmez, kendi bilgisayarında çalıştırabilirsin.

Python (python-telegram-bot)#

bashpip install "python-telegram-bot==22.8"
pythonimport os
from telegram import Update
from telegram.ext import Application, CommandHandler, ContextTypes, MessageHandler, filters

TOKEN = os.environ["BOT_TOKEN"]

async def basla(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
    await update.message.reply_text("Merhaba! Bana bir şey yaz, aynen geri söyleyeyim.")

async def yanki(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
    await update.message.reply_text(update.message.text)

app = (Application.builder().token(TOKEN)
       .base_url("https://app.inkiveta.com/bot")            # sonunda / YOK
       .base_file_url("https://app.inkiveta.com/file/bot")  # dosya indirme için
       .build())
app.add_handler(CommandHandler("start", basla))
app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, yanki))
app.run_polling()
bashBOT_TOKEN='4711:AAH...' python bot.py

Node.js (grammY)#

bashnpm install [email protected]
jsimport { Bot } from "grammy";

const bot = new Bot(process.env.BOT_TOKEN, {
  client: { apiRoot: "https://app.inkiveta.com" },   // sonunda / YOK
});

bot.command("start", (ctx) => ctx.reply("Merhaba! Bana bir şey yaz, aynen geri söyleyeyim."));
bot.on("message:text", (ctx) => ctx.reply(ctx.message.text));

bot.start();
bashBOT_TOKEN='4711:AAH...' node bot.mjs

Telegraf ya da aiogram kullanıyorsan yapılandırma satırı Telegram'dan taşıma sayfasında.

Şimdi uygulamana "selam" yaz: aynısı geri gelmeli. 🎉

Kütüphanesiz (curl)#

Kütüphane şart değil; her şey düz HTTPS isteği:

bash# bekleyen mesajları al
curl -s "https://app.inkiveta.com/bot$BOT_TOKEN/getUpdates"

# gelen update'teki chat.id'ye yanıt gönder
curl -s "https://app.inkiveta.com/bot$BOT_TOKEN/sendMessage" \
  -H 'Content-Type: application/json' \
  -d '{"chat_id":4185489292941965,"text":"Merhaba!"}'

chat_id, getUpdates yanıtındaki message.chat.id değeridir.

6. İlk yerel bileşenin#

Telegram'da olmayan bir şey deneyelim: uygulamanın kendi tasarımıyla çizilen bir başarı kutusu. Python'da yankı işleyicisini şununla değiştir:

pythonasync def yanki(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
    await context.bot.do_api_request("inkiSendComponent", api_kwargs={
        "chat_id": update.effective_chat.id,
        "component": {"type": "notice", "version": 1, "tone": "success",
                      "title": "Mesajın alındı", "text": update.message.text},
        "fallback_text": "Mesajın alındı: " + update.message.text,
    })

grammY'de:

jsbot.on("message:text", (ctx) =>
  bot.api.raw.inkiSendComponent({
    chat_id: ctx.chat.id,
    component: { type: "notice", version: 1, tone: "success", title: "Mesajın alındı", text: ctx.message.text },
    fallback_text: "Mesajın alındı: " + ctx.message.text,
  })
);

fallback_text zorunludur: bileşeni henüz tanımayan eski bir uygulama sürümü bu metni düz mesaj olarak gösterir. Diğer 56 bileşen: Yerel bileşenler.

Sırada ne var?#