Dokumentation / Schnellstart

Starten Sie Ihren ersten Bot in zehn Minuten

Diese Anleitung führt Sie durch die Erstellung eines Telegram-Bots, dessen Anbindung an Meshwire und die Veröffentlichung eines live geschalteten Flows.

1. Einen Bot mit BotFather erstellen

Öffnen Sie Telegram, schreiben Sie @BotFather und führen Sie /newbot aus. Wählen Sie einen Anzeigenamen und einen eindeutigen Benutzernamen, der auf „bot“ endet. BotFather gibt Ihnen einen HTTP-API-Token zurück — kopieren Sie ihn, Sie benötigen ihn als Nächstes.

/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. Den Token mit Meshwire verbinden

Gehen Sie in der Konsole zu Bots → Neuer Bot, fügen Sie den Token ein und wählen Sie einen Hosting-Modus. Der Webhook-Modus wird für die Produktion empfohlen; Polling eignet sich für schnelle lokale Tests.

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

3. Erstellen Sie Ihren ersten Flow

Öffnen Sie den Flow-Editor und ziehen Sie einen trigger.command-Knoten auf die Arbeitsfläche (z. B. /start). Verbinden Sie ihn mit einem msg.text-Knoten mit einer Willkommensnachricht und fügen Sie dann einen msg.inline_keyboard-Knoten mit Schnellantwort-Schaltflächen hinzu.

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

4. In der Sandbox testen

Verwenden Sie den integrierten Simulator, um Testnachrichten zu senden, ohne echten Telegram-Datenverkehr zu berühren. Er zeigt genau, wie Ihr Flow reagieren wird, einschließlich Schaltflächen und Medien.

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

5. Veröffentlichen

Klicken Sie auf Veröffentlichen und fügen Sie eine kurze Release-Notiz hinzu. Meshwire validiert den Flow, erstellt einen Versions-Snapshot und schaltet den Live-Datenverkehr darauf um. Sie können jederzeit zu einer früheren Version zurückkehren.

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

Bereit für mehr?

Entdecken Sie die API-Referenz oder richten Sie ausgehende Webhooks ein, um Ereignisse mit Ihren eigenen Systemen zu synchronisieren.

Tiefer einsteigen

Mit einer Vorlage starten, nicht mit einem leeren Blatt

Der Vorlagen-Katalog bringt mehr als sechzig fertige Bots mit — lokale Dienste, Immobilien, professionelle Aufnahme, Betrieb, Community, Reisen, Bildung und Handel —, jeweils durchsuchbar nach Name, Kategorie oder Stichwort und mit einer ehrlichen Komplexitätsstufe (Starter, Business, Advanced, Enterprise), damit du weißt, was du übernimmst, bevor du klickst.\nJede Vorlage installiert sich mit funktionierenden Beispieldaten: Shops mit Beispielprodukten und Zahlungs-Rail, Buchungs-Flows mit buchbaren Beispiel-Slots, die sich mit einem Klick entfernen lassen. Der Punkt: Der Bot demonstriert sich selbst ab der ersten Nachricht — du ersetzt die Beispiele, wann immer du bereit bist.\nBei der Installation führt der Assistent durch Benennung, BotFather-Token und Betriebsart. Alles andere — Menüs, Befehle, sprachabhängige Texte — kommt aus der Vorlage.

Veröffentlichen: erst speichern, dann live gehen

Der Builder kennt einen Entwurf und einen veröffentlichten Flow. Speichern schreibt den Entwurf; Veröffentlichen übernimmt die aktuelle Arbeitsfläche, speichert sie und stellt sie als neue nummerierte Version bereit, die der laufende Bot sofort bedient.\nVeröffentlichen ist idempotent: Ein Flow, der byteidentisch mit dem Live-Flow ist, erzeugt keine leere Version — ein Doppelklick hat keine Nebenwirkungen. Jede Veröffentlichung kann eine Notiz tragen, Versionen bleiben im Verlauf, und jede frühere Version lässt sich im Tab „Versions“ mit einer Aktion zurückrollen.\nDer Veröffentlichen-Knopf im Bot-Header veröffentlicht den zuletzt GESPEICHERTEN Flow — der Dialog sagt genau das, damit nie die Frage bleibt, welcher Knopf was tut.