# Cómo crear un chatbot {% hint style="warning" %} #### **¡Ten en cuenta!** **TUS PROYECTOS NUNCA SE ELIMINAN** y permanecen en la plataforma indefinidamente. Al expirar la suscripción, se eliminarán los siguientes datos: **Conexiones de Messenger:** desactivadas después de 3 semanas. **Mensajes largos:** los que superan los 800 caracteres se eliminan después de 3 meses. **Conversaciones:** todos los chats se almacenan de 2 a 6 meses. **Clientes:** eliminados después de 1 año. **Información adicional:** **Mensajes no entregados** se conservan durante 2 semanas. **Acceso a Messenger:** revocado 3 semanas después del vencimiento si no se realiza ningún pago. **Límites del sistema:** **Mensajes programados:** Máx. 32 por cliente. **Bots de prueba:** Limitados a 1.000 mensajes/día (incluidos los mensajes de cuentas de prueba). {% endhint %} ### Cómo crear el primer bloque en un embudo Cada chatbot creado en MaviBot está compuesto por bloques.
Un bloque es un conjunto de comandos y ajustes del chatbot, configurados por ti o por nuestros desarrolladores para tu proyecto. Cada bloque proporciona al bot instrucciones sobre cómo responder o actuar, y determina a dónde debe ir el cliente a continuación en el embudo. **Crear un bloque es sencillo: haz doble clic en cualquier espacio vacío del área de trabajo para empezar.** Puedes mover un bloque (o varios bloques) a cualquier lugar dentro del lienzo del creador para optimizar el diseño y dar a tu embudo un aspecto más limpio y ordenado. Para facilitar la comprensión, recorreremos un ejemplo de diagrama de embudo y explicaremos cómo funciona el editor usando ese ejemplo.
Estás viendo un flujo de chatbot. El flujo consta de **bloques** y **conexiones.** **Bloque de inicio (verde):** Aquí es donde comienza cada conversación. **Bloques disparadores (gris oscuro):** Estos bloques activan flujos específicos según las acciones del usuario. Cuando un usuario envía un mensaje o hace clic en un botón, puede pasar de un bloque a otro — pero **solo si se cumple la condición de transición**. Las condiciones se pueden establecer tanto en **bloques** y **Conectores.**
Para hacer que el bot se inicie cuando un usuario haga clic en el botón "**Iniciar"** en Telegram (o cualquier otro mensajero), debes especificar una **palabra de activación** en el bloque verde. Los bloques disparadores vienen en dos colores: **verde y** **gris**.
Hay cuatro tipos de **bloques de condición**: 1. **Inicio** 2. **Disparador** las pestañas "**Iniciar"** bloque tiene la máxima prioridad entre todos los bloques de condición — lo que significa que se activará **primera** si su condición coincide con cualquiera de las acciones del cliente. **Paso 1: Crea un bloque "Chat"** Para ello, haz clic en cualquier lugar del lienzo vacío del creador de flujos.
{% hint style="success" %} **¡Bueno saberlo!**\ \&#xNAN;**¿Qué es la `#{none}` construcción?**\ El `#{none}` la construcción, que aparece por defecto en el campo de respuesta, es un marcador de posición especial que se utiliza para gestionar entradas no especificadas o generales. Esto significa, por ejemplo, que un **bloque de condición** por `#{none}` se activará **cuando un cliente envíe cualquier mensaje** (si no se define ninguna palabra clave o disparador específico).\ Si dejas `#{none}` en el campo del mensaje, te permite **dirigir a los clientes a un bloque específico del embudo**independientemente del contenido de su mensaje. {% endhint %} Para crear un bloque que no envíe un mensaje, introduce `#{none}` en el campo de respuesta (esto está configurado por defecto). Después, haz clic en el bloque y selecciona su tipo — "**Iniciar".**
1. Selecciona el **"Inicio"** tipo de bloque. Esto abrirá el panel de configuración de condiciones. 2. Para esta primera prueba en el modo interno de MaviBot, define una palabra de activación simple como **"Hola"**.
Ahora, configura la respuesta del bot para cuando se active el disparador. Por ejemplo, introduce el mensaje: **"¡Hola! ¿Cómo puedo ayudarte?"**
Después asegúrate de hacer clic en "**Guardar"** para que todos los ajustes se apliquen al bloque:
**Paso 2: Crea el siguiente bloque** Para crear un nuevo bloque y conectarlo al anterior, abre el **menú de configuración adicional**.
Para construir un flujo de conversación sin interrupciones, tus bloques deben estar conectados. Así es como puedes hacerlo rápidamente: 1. Localiza y abre el **menú de configuración adicional** del bloque desde el que quieres conectar (por ejemplo, tu bloque "Iniciar"). 2. Busca y haz clic en el botón etiquetado **"Crear un bloque debajo."**
Ahora tu embudo contiene **dos bloques** que están conectados. {% hint style="warning" %} **¡Ten en cuenta!** **¿Qué significa esto en la práctica?** Si tu bot tiene dos **flujos**de conversación separados, un usuario no puede pasar por ambos al mismo tiempo. Seguirá un **flujo** o el otro, pero nunca ambos a la vez. **¿Necesitas enviar un mensaje sin interrumpir su flujo actual?** Usa bloques grises — ya sea **"Fallback"** o **"Disparador"** — para enviar mensajes separados sin interrumpir la conversación activa del usuario. {% endhint %} **Conectores** entre bloques guían al cliente a través del flujo del embudo. También puedes establecer condiciones directamente en los conectores. Esto te permite controlar el flujo, por ejemplo, haciendo que un clic en un botón o un pago exitoso sea un requisito para avanzar. **Vamos a crear un botón en el bloque “Chat”** para que el cliente pueda pasar al siguiente bloque. **Paso 3. Crea un botón** Haz clic en la línea **bloque “Iniciar”**. Verás un **“Botones”** :
Haz clic en la pestaña — esto abrirá el menú de configuración del botón.
Haz clic en **“+ Añadir botón”**, y aparecerá un menú de configuración del botón.
En el campo de texto del botón, introduce la etiqueta que quieras; por ejemplo, **“IR”**.
Haz clic en **“Añadir”**, y el botón aparecerá en la configuración del bloque.
Los botones se pueden mostrar de dos maneras: en el teclado del mensaje o directamente dentro del texto del mensaje. Ten en cuenta que algunos tipos de botones pueden no ser compatibles en ciertos mensajeros (como WhatsApp). Para una compatibilidad óptima, usa la **opción "Automático".** Esto mostrará automáticamente el botón en el formato mejor compatible con cada mensajero específico.
Y no olvides guardar la configuración del bloque.
¡Listo! ¡Has creado tu primer bloque disparador con un botón! 🎉 **Paso 4. Configura la conexión** Vamos a configurar el conector para que, cuando un cliente haga clic en el botón, pase al siguiente bloque. **Así es como se hace:** 1. Localiza la **flecha** (conector) que sale de tu bloque de botón. 2. **Pasa el cursor** sobre la flecha. 3. Haz clic en el **icono de engranaje** que aparece para abrir su configuración.
Se abrirán los ajustes de la conexión, donde debes elegir el botón que has creado.
Luego debes elegir **"Coincidencia exacta"** en el **"Tipo de coincidencia"**:
Y haz clic en **"Guardar"**.
Una vez que guardes la configuración de la conexión, la condición se mostrará directamente en el conector. Esto te da una referencia visual clara de qué desencadena la transición entre bloques.
La conexión puede ser curva:
Esto te permite ver claramente las conexiones que se superponen. Para ello, toma la flecha con el ratón en el punto donde quieras doblarla y arrástrala hasta la ubicación deseada. No hay límite en la cantidad de dobleces que puedes hacer. Para eliminar dobleces innecesarios de un conector, simplemente haz doble clic en el nodo deseado con el botón izquierdo del ratón. **Paso 5. Bloque “Chat”** Por defecto, cuando hiciste clic en el lienzo antes, se creó un bloque blanco **“Chat”** — este es el bloque más utilizado al construir flujos de chatbot. Puedes configurar casi cualquier cosa dentro de un bloque “Chat” (excepto las condiciones). De hecho, la mayoría de tu chatbot probablemente consistirá en **“Chat”** bloques.
A diferencia de los bloques de condición, un **“Chat”** bloque solo se puede acceder si: * Está conectado mediante una conexión desde un bloque anterior, o * Has enviado una campaña que dirige a los usuarios hacia él. Si quieres que el cliente entre en el bloque en función de un disparador, el disparador debe configurarse en: * En la **conexión** (como se muestra en el Paso 4), o * Usando un **temporizador**. En la **"Chat"** bloque: introduce el mensaje que el bot enviará al cliente (cuando haga clic en el botón en el **"Inicio"** bloque).
Asegúrate de hacer clic en **“Guardar”** en el **“Chat”** ajustes del bloque. {% hint style="success" %} ¡Ahora has creado tu primer chatbot! {% endhint %} #### Video tutorial {% embed url="" %} ## Pruebas del chatbot Después de crear — o incluso mientras construyes — cualquier chatbot, es importante **probar** el bot para asegurarte de que tus flujos funcionan correctamente y de que la configuración está bien establecida. Puedes conectar el bot a un proyecto y probarlo allí. Sin embargo, si creas un bot para **WhatsApp**, ten en cuenta que **no puedes enviarte mensajes a ti mismo**. Por eso hay otra forma: puedes abrir un **chat en línea** con el bot e interactuar con él directamente. Para ello, haz clic en el **botón en la esquina inferior izquierda** del creador:
Cuando haces clic en el **botón “Probar chatbot”** , se abrirá una ventana de prueba.
El **área izquierda** de la ventana de prueba muestra los bloques que has creado para el chatbot.
En el **lado derecho**verás los datos del cliente de prueba — es decir, tu propio perfil de usuario simulado.
En la **centro de la pantalla**verás el **chat en línea** donde puedes probar el bot. Para ello, escribe la frase de activación del **“Iniciar”** .
Así funciona el bot:
{% hint style="success" %} **¡Enhorabuena!** 🎉 **Has creado con éxito un chatbot funcional que incluye:** * **Configuración de disparadores** tanto en bloques como en conectores * **Un botón totalmente operativo** * **Pruebas en tiempo real** que te permiten ver exactamente cómo funciona tu chatbot {% endhint %} ### Acerca de la pestaña "Pruebas" Después de crear el flujo del chatbot en modo de prueba, verás todos los paneles con información sobre los bloques a la izquierda.
Cada panel en el lado izquierdo de la pantalla muestra el número del bloque, su tipo y su contenido.
Puedes filtrar y mostrar bloques por su tipo usando el botón "Filtrar" correspondiente.
Para probar la ejecución de un solo bloque del flujo, puedes seleccionar el bloque correspondiente haciendo clic en él y luego hacer clic en **"Enviar bloque."**
El bloque seleccionado se enviará en nombre del chatbot en la sección central de la pantalla — la ventana de pruebas. En esta misma área, puedes probar todo el flujo de bloques начиная desde el primer bloque del diagrama. {% hint style="info" %} No tienes que empezar a probar el flujo del chatbot desde el principio: por ejemplo, si has añadido nuevos bloques a tu flujo, puedes usar la **función "Enviar bloque"** y comenzar a probar el flujo desde el bloque seleccionado. {% endhint %} En el lado derecho de la pantalla, encontrarás la vista del cliente de prueba.
En esta misma ventana del cliente, están disponibles las siguientes funciones: – Asignar o añadir etiquetas/listas al cliente; \ – Añadir variables; \ – Ver las variables asignadas al cliente a través de la ejecución del flujo del chatbot. De esta manera, puedes probar completamente el flujo del chatbot (o cualquier parte de él) y ver inmediatamente la ficha del cliente y sus datos. ### Opciones de respuesta en el bot Ahora vamos a añadir una pregunta con múltiples opciones de respuesta a nuestro flujo inicial. Las opciones de respuesta se representan mediante conectores que salen del bloque. Un conector tendrá la condición **“Sí,”** y el otro — “No.” Para ello, haz clic en el segundo bloque etiquetado “Chat” y crea dos bloques debajo de él usando el menú de configuración adicional.
**Ahora que hemos añadido dos bloques a nuestro flujo, el siguiente paso es configurar el disparador en su conexión.** **Así es como se hace:** 1. Pasa el cursor sobre el conector (flecha) que lleva al segundo bloque. 2. En el campo de disparador que aparece, introduce la respuesta del usuario que debe activar esta ruta, por ejemplo, **"Sí"**.
Luego asegúrate de guardarlo. Después de eso, especifica también la otra opción de respuesta en los ajustes de la segunda flecha.
En el bloque anterior, del que salen las dos flechas con opciones de respuesta, introduce cualquier pregunta.
Ahora, en los **bloques "Chat"** a los que conduce la conexión con opciones de respuesta, introduce el mensaje de respuesta del bot.
Ahora el flujo final se ve así:
#### Así es como funciona este flujo: 1. El usuario escribe **“Hola”** y entra en el bloque verde. 2. Luego, el usuario hace clic en un botón y pasa al segundo bloque; 3. El usuario escribe **“Sí”** o **“No”** y continúa a uno de los estados según la respuesta. Pero, ¿y si el usuario escribe algo más, ni **“Sí”** ni **“No”**? La conversación no avanzará a ninguno de los siguientes estados y permanecerá atascada en el actual. El diálogo se estancará. ## Cómo crear un bucle Para evitar que el bot se quede en silencio cuando un usuario envía un mensaje que no coincide con ninguno de los disparadores en los conectores, añadiremos un bucle. Para ello, haz un bucle en la pregunta añadiendo una flecha **sin ningún disparador** que apunte **de vuelta al mismo bloque**. {% hint style="info" %} ¡Bueno saberlo!\ Los bloques y las conexiones **sin disparadores** tienen **menor prioridad** que aquellos **con disparadores**. {% endhint %} Para crear un bucle, haz clic en el bloque en el que le haces una pregunta al cliente. En el formulario de configuración que se abre, haz clic en los tres puntos de la esquina superior derecha y luego selecciona **“Crear un bucle.”**
Esto creará un bucle en el flujo.
Ahora, si el cliente envía un mensaje al bot que difiere de **“Sí”** o **“No,”** el mensaje del segundo bloque se enviará de nuevo. **¿Qué pasa si el cliente no responde al mensaje del bot?** Puedes enviar mensajes de seguimiento usando un **temporizador** para recordarle al cliente que se necesita una respuesta. Entonces, cuando el usuario entra en el bloque con la pregunta *“¿Estás feliz?”*, y no responde con **“Sí”** o **“No”**, queremos enviar un mensaje como:**“No respondiste a la pregunta :(”** y luego volver a hacer la pregunta. Para ello, usaremos un **temporizador.** ## Cómo crear un mensaje con temporizador Vamos a crear un nuevo bloque al que llevará la flecha desde el bloque **"¿Estás feliz?"** y también eliminaremos el bucle. Para ello, pasa el cursor sobre el bucle y haz clic en el **icono de cruz** para eliminarlo.
Ahora, ve a la configuración de la flecha que lleva al nuevo bloque desde el bloque de la pregunta.
En la configuración de la flecha, hay un panel llamado **“Retraso antes de la respuesta”** — este es un temporizador que establece la cantidad de tiempo después de la cual el flujo avanzará automáticamente al siguiente bloque.
También debes activar la casilla **“Cancelar si salió del bloque”** para que el mensaje no se envíe si el cliente sí responde a la pregunta.
Ahora, introduzcamos el mensaje en el nuevo bloque:
Y desde el nuevo bloque, dibuja una conexión de vuelta al bloque de la pregunta. Para ello, pasa el cursor sobre el bloque — verás que aparece un punto que te permite crear una conexión:
Paso 1. Haz clic en el botón y arrastra el conector hasta el bloque con la pregunta. Paso 2. Los dos conectores se superpondrán, así que tendrás que arrastrar uno de ellos hacia arriba. \ Para ello, pasa el ratón sobre los conectores y busca el tirador alargado — úsalo para ajustar la curva y separar la conexión. Paso 3. Luego, haz clic y mantén presionado el conector y arrástralo hacia arriba. Ahora ve a la configuración de la flecha recién creada y establece un **temporizador de 1 segundo**, para que el cliente sea redirigido de vuelta al bloque de la pregunta. El flujo final se ve así:
{% hint style="success" %} ¡Has creado con éxito tu primer chatbot — completo con botones, conectores, opciones de respuesta, bucles y flechas de redirección temporizadas! {% endhint %} ## **Cómo añadir etapas del embudo (listas)** Usando etapas del embudo (listas), puedes organizar tu bot de la forma que te resulte más conveniente. Sigue siendo un solo gran espacio de trabajo donde se encuentran todas las ramas del bot, pero visualmente está dividido en páginas separadas. El bot en sí sigue funcionando como un único flujo. Cuando las cadenas de flujo se dividen entre listas, **bloques enlazados** se crean automáticamente. Para añadir una nueva lista, haz clic en el **icono de más** en la esquina inferior derecha del espacio de trabajo e introduce el nombre de la nueva lista.
Para continuar el flujo actual en una nueva lista, haz clic en un bloque o selecciona varios bloques, luego haz clic en la flecha↪️ con la información emergente **“Haz clic para mover los elementos seleccionados a otra lista.”** Cuando aparezca la advertencia sobre mover bloques, elige la lista deseada en el menú desplegable de la parte inferior, junto al icono de más.
En la ventana que se abre, verás instrucciones sobre lo que hay que hacer para completar la transferencia. ## Cómo conectar mensajeros Después de probar, puedes conectar el flujo a los mensajeros. Para ello, ve a la **Mensajeros** sección del menú principal.
A continuación, debes hacer clic en el botón del mensajero deseado. {% hint style="success" %} Lee cómo conectar bots en diferentes mensajeros en la **“**[**Mensajeros**](/doc/es/chatbot/mensajeros.md)**”** artículo. {% endhint %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.mavibot.ai/doc/es/chatbot/builder/funnel.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.