Main Flow (Flujo Principal)

El Main Flow (Flujo Principal) es el punto de entrada fundamental de tu bot en Botinfy App. Es el primer flujo que se ejecuta automáticamente cuando cualquier usuario inicia una conversación con tu bot, independientemente del canal de comunicación (WhatsApp, Instagram, Facebook).

¿Qué es el Main Flow?

El Main Flow actúa como el "receptor" de todas las conversaciones entrantes. Cada vez que un usuario envía un mensaje a tu bot, el sistema primero ejecuta el Main Flow antes de procesar cualquier otro flujo o acción.

Características Principales

• Punto de Entrada Universal: Todas las conversaciones pasan por el Main Flow primero.
• Ejecución Automática: Se ejecuta sin necesidad de ser activado manualmente por el usuario.
• Derivación de Conversaciones: Puede redirigir las conversaciones hacia otros flujos o hacia sistemas externos (como n8n para procesamiento con IA).
• Configuración Global: Define el comportamiento base de tu bot para todos los usuarios.

Configurar el Main Flow

Paso 1: Acceder a la Configuración del Bot

1. Inicia sesión en Botinfy App (app.botinfy.com).
2. Selecciona el bot para el cual deseas configurar el Main Flow.
3. Navega a la sección Flows (Flujos) en el menú lateral izquierdo.

Paso 2: Seleccionar el Flujo Principal

Tienes dos opciones:

Opción A: Usar Main Flow por defecto

1. En la vista de flujos, tendrás un flujo remarcado llamado "Main Flow", el cual viene sienddo el Flujo Principal por defecto. Puedes empezar a construir tu flujo directamente allí

Opción B: Usar otro Flujo Existente

1. Si ya tienes otro flujo creado que deseas usar como Main Flow:
   • Ve a la configuración del bot.
   • Busca la opción Main Flow o Flujo Principal.
   • Selecciona el flujo de la lista desplegable.
   • Haz clic en Guardar para aplicar los cambios.

Paso 3: Configurar el Main Flow

Una vez que tengas tu Main Flow creado, puedes configurarlo con diferentes nodos según tus necesidades:

Nodos Disponibles en Main Flow

• Send Message (Enviar Mensaje): Para enviar mensajes de bienvenida o respuestas.
• Question (Pregunta): Para hacer preguntas al usuario y capturar sus respuestas.
• Action (Acción): Para ejecutar acciones, incluyendo peticiones externas (webhooks).
• Condition (Condición): Para crear lógica condicional basada en respuestas del usuario.
• Split (Separar): Para dividir el flujo en múltiples caminos.
• Go to (Ir a): Para redirigir a otros flujos.
• Send Email (Enviar Correo): Para enviar notificaciones por correo electrónico.

Casos de Uso Comunes del Main Flow

1. Conexión con n8n (Inteligencia Artificial)

El caso más común es usar el Main Flow para derivar todas las conversaciones hacia un sistema externo de procesamiento con IA (como n8n), lo cual se explica en la sección de Enlazar con n8n.

Pero en resumen vendría siendo:

1. Agrega un Nodo de Acción dentro del Main Flow.
2. Selecciona "Acción Avanzada" y luego "Petición Externa".
3. Configura la URL: Coloca el Webhook de producción de tu sistema n8n.
4. Configura el Body (JSON): Utiliza la estructura para la peticion a n8n

De esta manera, todas las conversaciones se envían automáticamente a tu sistema de IA para procesamiento inteligente.

2. Mensaje de Bienvenida Simple

Para un bot básico, puedes configurar el Main Flow para enviar un mensaje de bienvenida:

1. Agrega un nodo Send Message.
2. Escribe tu mensaje de bienvenida.
3. Opcionalmente, agrega botones o opciones para que el usuario interactúe.

3. Menú Principal Interactivo

Puedes crear un Main Flow que presente un menú de opciones al usuario:

1. Agrega un nodo Send Message con botones o opciones.
2. Agrega nodos Condition para evaluar la selección del usuario.
3. Usa nodos Go to para redirigir a flujos específicos según la opción elegida.

4. Filtrado y Derivación

El Main Flow puede actuar como un filtro que deriva conversaciones según diferentes criterios:

1. Usa nodos Condition para evaluar variables del usuario (etiquetas, campos personalizados, etc.).
2. Deriva a diferentes flujos según el perfil del usuario.
3. Esto es útil para personalizar la experiencia según el tipo de cliente.

Mejores Prácticas

Mantener el Main Flow Simple

• El Main Flow debe ser eficiente y rápido.
• Evita procesos largos que puedan hacer esperar al usuario.
• Si necesitas procesamiento complejo, derívalo a otros flujos o sistemas externos.

Mensaje de Bienvenida

• Si incluyes un mensaje de bienvenida, mantenlo breve y claro.
• Proporciona instrucciones claras sobre cómo interactuar con el bot.
• Considera incluir opciones visuales (botones, menús) para facilitar la navegación.

Manejo de Errores

• Configura respuestas de respaldo en caso de que el sistema externo no responda.
• Incluye un flujo de error que informe al usuario si algo falla.

Variables y Datos del Usuario

El Main Flow tiene acceso a todas las variables del usuario, incluyendo:

• : Nombre del usuario
• : ID único del usuario
• : Namespace del usuario
• : Último mensaje enviado por el usuario
• : Timestamp de la última interacción

Flujos Auxiliares Relacionados

Cuando configuras el Main Flow para trabajar con sistemas externos (como n8n), necesitarás crear flujos auxiliares que el sistema externo pueda llamar:

1. get_message: Flujo para capturar texto entrante del usuario.
2. send_message: Flujo para enviar mensajes de texto al usuario.
3. get_image: Flujo para capturar imágenes enviadas por el usuario.
4. send_image: Flujo para enviar imágenes al usuario (catálogos, QR, etc.).
5. stop_bot: Flujo de emergencia para detener la IA y transferir a un agente humano.

Estos flujos deben tener IDs o nombres identificables para que el sistema externo pueda ejecutarlos correctamente.

Verificar el Main Flow

Para verificar que tu Main Flow está funcionando correctamente:

1. Prueba con un Usuario Real: Envía un mensaje desde tu número personal al bot.
2. Revisa los Logs: Verifica en la sección de conversaciones que el Main Flow se ejecutó.
3. Prueba la Derivación: Si configuraste una derivación a un sistema externo, verifica que los datos se envíen correctamente.
4. Prueba los Flujos Auxiliares: Asegúrate de que los flujos auxiliares funcionen cuando son llamados.

Solución de Problemas

El Main Flow no se ejecuta

• Verifica que el flujo esté publicado y activo.
• Asegúrate de que el flujo esté seleccionado como Main Flow en la configuración del bot.
• Revisa que el bot tenga canales conectados correctamente.

Los mensajes no se derivan al sistema externo

• Verifica que la URL del webhook sea correcta y esté accesible.
• Revisa el formato del JSON en el body de la petición.
• Verifica que las variables estén correctamente escritas (con dobles llaves ).

El usuario no recibe respuestas

• Verifica que los flujos auxiliares (como send_message) estén correctamente configurados.
• Revisa que el sistema externo esté llamando correctamente a los flujos de respuesta.
• Asegúrate de que los flujos estén publicados.

Próximos Pasos

Una vez que hayas configurado tu Main Flow:

1. Crea los flujos auxiliares necesarios para tu integración.
2. Configura las variables que almacenarán el estado de las conversaciones.
3. Prueba exhaustivamente con diferentes escenarios.
4. Configura flujos adicionales para casos específicos (ventas, soporte, etc.).

Para más información sobre la configuración del Main Flow con n8n, consulta la sección de Flujo de Desarrollo - Conexión y Botinfy App.