Documentación / Inicio rápido

Pon en marcha tu primer bot en diez minutos

Esta guía te lleva paso a paso por la creación de un bot de Telegram, su conexión con Meshwire y la publicación de un flujo en vivo.

1. Crea un bot con BotFather

Abre Telegram, escribe a @BotFather y ejecuta /newbot. Elige un nombre visible y un nombre de usuario único que termine en "bot". BotFather te devuelve un token de la API HTTP; cópialo, lo necesitarás a continuación.

/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. Conecta el token a Meshwire

En la consola, ve a Bots → Nuevo bot, pega el token y elige un modo de alojamiento. El modo webhook se recomienda para producción; el sondeo (polling) es útil para pruebas locales rápidas.

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

3. Crea tu primer flujo

Abre el editor de flujos y arrastra un nodo trigger.command al lienzo (por ejemplo, /start). Conéctalo a un nodo msg.text con un mensaje de bienvenida y luego añade un nodo msg.inline_keyboard con botones de respuesta rápida.

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

4. Prueba en el simulador

Usa el simulador integrado para enviar mensajes de prueba sin afectar el tráfico real de Telegram. Muestra exactamente cómo responderá tu flujo, incluidos botones y contenido multimedia.

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

5. Publica

Haz clic en Publicar y añade una breve nota de la versión. Meshwire valida el flujo, guarda una instantánea de la versión y cambia el tráfico en vivo a ella. Puedes volver a cualquier versión anterior en cualquier momento.

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

¿Listo para profundizar?

Explora la Referencia de la API o configura webhooks salientes para sincronizar eventos con tus propios sistemas.

Ir más profundo

Empieza con una plantilla, no con una página en blanco

El catálogo trae más de sesenta bots listos — servicios locales, inmobiliaria, acogida profesional, operaciones, comunidad, viajes, educación y comercio — buscables por nombre, categoría o palabra clave, y etiquetados con un nivel de complejidad honesto (Inicial, Negocio, Avanzado, Empresarial) para saber qué adoptas antes de hacer clic.\nCada plantilla se instala con datos de ejemplo funcionales: las tiendas con productos de muestra y rail de pago, las reservas con huecos de muestra quitables de un clic. La idea: el bot se demuestra desde el primer mensaje — tú cambias las muestras por tu contenido cuando quieras.\nEl asistente de instalación guía el nombre, el token de BotFather y el modo de ejecución. Todo lo demás — menús, comandos, textos por idioma — viene de la plantilla.

Publicar: primero guardar, luego salir a producción

El Builder distingue un borrador y un flujo publicado. Guardar escribe el borrador; Publicar guarda el lienzo actual y lo despliega como nueva versión numerada que el bot en producción sirve de inmediato.\nPublicar es idempotente: un flujo idéntico al publicado no genera una versión vacía — el doble clic no tiene efectos secundarios. Cada publicación puede llevar nota, las versiones quedan en el historial y cualquiera se restaura en una acción desde la pestaña Versiones.\nEl botón Publicar del encabezado del bot publica el último flujo GUARDADO — el diálogo lo dice con esas palabras, sin ambigüedad sobre qué hace cada botón.