Skip to content

Fase 2: Conexión y Configuración Inicial (Botinfy App)

En esta fase se configuran los "ojos y oídos" del agente mediante la plataforma Botinfy.

1. Vinculación de Canales (CRÍTICO)

Esta acción requiere sincronización en tiempo real con el cliente.

  • Acción: Agendar y realizar una videollamada con el cliente.
  • Tarea: Guiar al cliente para conectar sus redes sociales oficiales a la plataforma Botinfy:
    • WhatsApp Cloud API.
    • Instagram Business.
    • Facebook Page.

2. Configuración del Main Flow y Conexión Webhook

El Main Flow es el punto de entrada para cualquier usuario que escriba. Aquí derivaremos la conversación hacia la inteligencia de n8n.

1. Configuración del Nodo de Acción (Webhook)

Dentro del Main Flow:

  1. Agrega un nuevo nodo de tipo Acción.

  2. Selecciona la opción Acción Avanzada y luego Petición Externa.

  3. URL: Aquí colocarás el Webhook de Producción que obtendrás al configurar n8n (Fase 3).

  4. Body (JSON): Utiliza la siguiente estructura JSON estándar. Para especificaciones más detalladas sobre las variables, consulta la sección de Botinfy App.

    json
    {
      "username": "{{user_name}}",
      "user_ns": "{{user_ns}}",
      "id": "{{user_id}}",
      "last_message": {{last_message :: $}},
      "timestamp": "{{last_interaction}}"
    }

2. Flujos Auxiliares Requeridos

Además del Main Flow, debes crear los siguientes flujos con sus respectivos IDs o nombres identificables para que el agente pueda ejecutarlos:

  1. get_message: Captura de texto entrante.
  2. send_message: Salida de texto hacia el usuario.
  3. get_image: Captura de imágenes enviadas por el usuario.
  4. send_image: Envío de imágenes (catálogos, QR, etc.).
  5. stop_bot: Flujo de emergencia para detener la IA.

3. Definición de Variables

Dentro de la App de Botinfy, define las variables que almacenarán el estado de la conversación y datos del usuario.

  • message: El contenido del mensaje actual.
  • last_interaction: Timestamp o flag de la última vez que habló la IA.
  • thread_id: (Opcional) Para mantener el hilo en asistentes avanzados.

4. Generación de Credenciales

  • Ve a la sección de configuración de API en Botinfy.
  • Genera una nueva API Key.
  • Importante: Guarda esta Key en un lugar seguro (ej. gestor de contraseñas), la necesitarás en la Etapa 3 para configurar los nodos HTTP en n8n.

Documentación de Botinfy