İ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#
- 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.
- Gerekenler: telefon numarası doğrulanmış normal bir hesap. Normal hesap 1, Ink+ üyesi 5 uygulama açabilir.
- Bir kullanıcı adı seç: 5–32 karakter, harf, rakam ve
_(kuafor_ayse,hava_durumu). Sonubotile bitmek zorunda değil. Kullanıcı adı sonradan değiştirilemez. - 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.
- Barındırma ülkesini seç: kodunun çalışacağı sunucu hangi ülkedeyse (Türkiye ise
TR). Bu zorunlu; nedeni Gizlilik sayfasında. - 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?#
- Kodunu bir sunucuya taşıyıp webhook kurmak: Güncellemeleri almak
- Düğmeler ve menüler eklemek: Düğmeler ve klavyeler
- Uygulamanı açan kullanıcıyı karşılayan bir sayfa: Ana sayfa ve hızlı eylemler
- Gerçek kullanıcıları etkilemeden denemek: Test ortamı
- Yayına almadan önce bilmen gerekenler: Kullanıcıya yazma kuralları ve Gizlilik