Dokümantasyon / Hızlı başlangıç

İlk botunuzu on dakikada başlatın

Bu kılavuz, bir Telegram botu oluşturma, Meshwire'e bağlama ve canlı bir akış yayınlama sürecinde size yol gösterir.

1. BotFather ile bir bot oluşturun

Telegram'ı açın, @BotFather'a mesaj gönderin ve /newbot komutunu çalıştırın. Bir görünen ad ve "bot" ile biten benzersiz bir kullanıcı adı seçin. BotFather size bir HTTP API token'ı verir — kopyalayın, bir sonraki adımda ihtiyacınız olacak.

/newbot
Alright, a new bot. How are we going to call it?
> Acme Support Bot
Good. Now let's choose a username for your bot.
> acme_support_bot
Done! Use this token to access the HTTP API:
110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw

2. Token'ı Meshwire'a bağlayın

Konsolda Botlar → Yeni bot'a gidin, token'ı yapıştırın ve bir barındırma modu seçin. Üretim için webhook modu önerilir; polling ise hızlı yerel testler için kullanışlıdır.

POST /v1/bots
{
  "name": "Acme Support Bot",
  "token": "110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw",
  "hostingMode": "webhook",
  "timezone": "Europe/Warsaw"
}

3. İlk akışınızı oluşturun

Akış düzenleyicisini açın ve tuvale bir trigger.command düğümü sürükleyin (örn. /start). Bunu bir hoş geldin mesajı içeren msg.text düğümüne bağlayın, ardından hızlı yanıt düğmeleri içeren bir msg.inline_keyboard düğümü ekleyin.

trigger.command(/start)
  -> msg.text("Welcome to Acme Support! How can we help?")
  -> msg.inline_keyboard(["Talk to sales", "Track an order"])

4. Test ortamında test edin

Gerçek Telegram trafiğine dokunmadan test mesajları göndermek için yerleşik simülatörü kullanın. Düğmeler ve medya dahil, akışınızın nasıl yanıt vereceğini tam olarak gösterir.

Simulator > /start
Bot: Welcome to Acme Support! How can we help?
     [ Talk to sales ]  [ Track an order ]

5. Yayınlayın

Yayınla'ya tıklayın ve kısa bir sürüm notu ekleyin. Meshwire akışı doğrular, bir sürüm anlık görüntüsü alır ve canlı trafiği ona geçirir. İstediğiniz zaman önceki bir sürüme geri dönebilirsiniz.

POST /v1/bots/{botId}/publish
{ "note": "Initial launch: welcome + support routing" }

Daha derine inmeye hazır mısınız?

Şunu keşfedin: API referansı veya giden webhook'ları kurarak olayları kendi sistemlerinizle senkronize edin.

Daha derine in

Boş tuvalle değil, şablonla başlayın

Şablon kataloğu altmıştan fazla hazır botla gelir — yerel hizmetler, emlak, profesyonel kabül, operasyon, topluluk, seyahat, eğitim ve ticaret. Her biri ad, kategori veya anahtar kelimeyle aranır ve dürüst bir karmaşıklık kademesi taşır (Başlangıç, İş, İleri, Kurumsal), böylece tıklamadan önce ne devraldığınızı bilirsiniz.\nHer şablon çalışan örnek veriyle kurulur: dükkanlar örnek ürünler ve ödeme hattıyla, rezervasyon akışları tek tıkla silinebilen örnek slotlarla. Mesele şu: bot ilk mesajdan itibaren kendini gösterir — örnekleri gerçek içeriğinizle değiştirmek size kalmış.\nKurulum sihirbazı adlandırma, BotFather tokenı ve çalışma biçimini adım adım götürür. Menüler, komutlar ve dil başına metinler dahil gerisi şablondan gelir.

Yayınlama: önce kaydet, sonra canlıya al

Builder bir taslağı ve yayınlanmış bir akışı ayrı tutar. Kaydet taslağı yazar; Yayınla mevcut tuvali kaydip yeni numaralı bir sürüm olarak dağıtır ve çalışan bot onu anında kullanır.\nYayınlama etkisiz-tekrarlanabilirdir: canlı akışla birebir aynı akış boş bir sürüm üretmez — çift tıklamanın yan etkisi yoktur. Her yayına not eklenebilir, sürümler geçmişte durur ve önceki her sürüm Sürümler sekmesinden tek işlemle geri alınabilir.\nBot başlığındaki Yayınla düğmesi en son KAYDEDİLMİŞ akışı yayınlar — iletişim kutusu bunu açıkça söyler, hangi düğmenin ne yaptığı hiçbir zaman belirsiz kalmaz.