Meshwire

Documentation / Démarrage rapide

Lancez votre premier bot en dix minutes

Ce guide vous accompagne dans la création d'un bot Telegram, sa connexion à Meshwire et la publication d'un flux en direct.

1. Créer un bot avec BotFather

Ouvrez Telegram, écrivez à @BotFather et exécutez /newbot. Choisissez un nom d'affichage et un nom d'utilisateur unique se terminant par « bot ». BotFather vous renvoie un jeton d'API HTTP — copiez-le, vous en aurez besoin ensuite.

/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. Connecter le jeton à Meshwire

Dans la console, allez dans Bots → Nouveau bot, collez le jeton et choisissez un mode d'hébergement. Le mode webhook est recommandé pour la production ; le polling est utile pour des tests locaux rapides.

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

3. Créez votre premier flux

Ouvrez l'éditeur de flux et faites glisser un nœud trigger.command sur le canevas (par exemple /start). Connectez-le à un nœud msg.text avec un message de bienvenue, puis ajoutez un nœud msg.inline_keyboard avec des boutons de réponse rapide.

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

4. Testez dans le bac à sable

Utilisez le simulateur intégré pour envoyer des messages de test sans toucher au trafic Telegram réel. Il affiche exactement comment votre flux répondra, boutons et médias inclus.

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

5. Publiez

Cliquez sur Publier et ajoutez une brève note de version. Meshwire valide le flux, enregistre un instantané de version et bascule le trafic en direct dessus. Vous pouvez revenir à une version antérieure à tout moment.

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

Prêt à aller plus loin ?

Explorez la Référence de l'API ou configurez des webhooks sortants pour synchroniser des événements avec vos propres systèmes.

Aller plus loin

Commencez par un modèle, pas une page blanche

Le catalogue embarque plus de soixante bots prêts à l'emploi — services locaux, immobilier, accueil professionnel, opérations, communauté, voyage, éducation et commerce — cherchables par nom, catégorie ou mot-clé, et étiquetés d'un niveau de complexité honnête (Starter, Business, Advanced, Enterprise) pour savoir ce que vous adoptez avant de cliquer.\nChaque modèle s'installe avec des données d'exemple fonctionnelles : les boutiques avec produits d'exemple et rail de paiement, les réservations avec créneaux d'exemple retirables en un clic. L'idée : le bot se démontre dès le premier message — vous remplacez les exemples par votre contenu quand vous voulez.\nL'assistant d'installation guide le nom, le token BotFather et le mode d'exécution. Tout le reste — menus, commandes, textes par langue — vient du modèle.

Publier : enregistrer d'abord, mettre en ligne ensuite

Le Builder distingue un brouillon et un flux publié. Enregistrer écrit le brouillon ; Publier enregistre le canvas actuel et le déploie en nouvelle version numérotée que le bot en ligne sert immédiatement.\nLa publication est idempotente : un flux identique à celui en ligne ne crée pas de version vide — un double-clic reste sans effet secondaire. Chaque publication peut porter une note, l'historique des versions est conservé, et toute version antérieure se restaure en une action depuis l'onglet Versions.\nLe bouton Publier de l'en-tête du bot publie le dernier flux ENREGISTRÉ — le dialogue le dit mot pour mot, aucune ambiguïté sur ce que fait quel bouton.