Sección 1

Introducción y Acceso

Bienvenido al manual de usuario oficial de Digzu Chatbot Multi Agent. Esta plataforma le permite diseñar árboles de decisión interactivos, integrar modelos de Inteligencia Artificial (Gemini, Groq, OpenAI) y automatizar ventas directamente en los números oficiales de WhatsApp Business de su empresa.

Iniciando Sesión

La plataforma utiliza la autenticación segura de Firebase (Google). Siga estos pasos:

  1. Ingrese a la URL proporcionada de su panel administrativo.
  2. Verá una pantalla de bienvenida. Haga clic en "Iniciar Sesión".
  3. Ingrese sus credenciales corporativas (Correo y Contraseña).
  4. Una vez validado, accederá al Canvas (lienzo) principal de trabajo.

Nota: Su sesión se mantendrá activa de forma segura. Si necesita cerrar sesión, utilice el menú desplegable de configuraciones en la barra superior.


Sección 2

Configuración de WhatsApp

Para que el bot pueda enviar y recibir mensajes, es imperativo vincular su cuenta de Meta de manera oficial. Utilizamos el método Embedded Signup para un proceso rápido y sin fricciones.

Pasos para Conectar su Número

  1. En la barra superior del panel, haga clic en ⚙️ Configuraciones.
  2. Seleccione el botón azul que dice Conectar con Meta.
  3. Se abrirá una ventana emergente de Facebook. Inicie sesión con su cuenta personal de Facebook que tenga permisos administrativos sobre el Negocio.
  4. Siga los pasos en pantalla para seleccionar o crear su cuenta WABA (WhatsApp Business Account) y seleccione los números de teléfono que desea activar.
  5. Al finalizar, la ventana se cerrará y la plataforma validará su conexión de forma automática.

⚠️ Importante sobre múltiples números: Si usted adquiere un nuevo número y repite este proceso, asegúrese de marcar tanto el número viejo como el nuevo en la ventana de Facebook. Si desmarca el viejo, Meta revocará el acceso y ese bot dejará de funcionar.

Renombrar un Número

Por defecto, el sistema intentará mostrar el número real (ej. +57300...). Si desea organizarlos mejor:

  1. Seleccione el número en la lista desplegable de la barra superior.
  2. Haga clic en el ícono de lápiz (✏️) que se encuentra al lado.
  3. Escriba un identificador amigable, por ejemplo: "Ventas Sede Norte".

Sección 3

Píxel de Meta (CAPI)

La plataforma soporta la API de Conversiones de Meta (CAPI). Esto significa que el bot puede avisarle automáticamente a Facebook cuando un cliente realiza una acción valiosa (como agendar una cita o completar una compra), permitiendo que sus campañas publicitarias se optimicen solas.

¿Cómo configurarlo?

  1. Vaya a ⚙️ Configuraciones y seleccione Configuración CAPI Meta.
  2. ID del Píxel: Lo obtiene en su Administrador de Eventos de Meta (Event Manager).
  3. Token de Acceso (CAPI): En el Administrador de Eventos, vaya a Configuración de la API de conversiones y genere un token de acceso permanente.
  4. Guarde los cambios.

Una vez configurado, podrá arrastrar nodos de tipo "Evento CAPI" en su flujo para disparar conversiones en puntos estratégicos de la conversación.


Sección 4

Creación y Gestión de Flujos

El núcleo de la plataforma es el lienzo de flujos (Canvas). Es una interfaz gráfica de "arrastrar y soltar" (Drag & Drop) que define cómo responde el bot.

Crear un Nuevo Flujo

Haga clic en + Nuevo Flujo en la barra superior. Inmediatamente aparecerá un nodo inicial llamado "Start".

Conectar Nodos

Haga clic sostenido en el pequeño punto (puerto) en el borde derecho de un nodo y arrástrelo hacia el puerto izquierdo del siguiente nodo.

Consideraciones Importantes:

  • Auto-Guardado: Recuerde hacer clic en el botón verde "Guardar Flujo" constantemente. Los cambios no se aplican en WhatsApp hasta que no guarde.
  • Zoom y Navegación: Use la rueda del ratón (Scroll) para hacer zoom in/out. Haga clic sostenido en cualquier espacio vacío del lienzo para moverse.
  • Eliminar Nodos o Conexiones: Seleccione el nodo o la línea de conexión haciendo clic sobre él y presione la tecla Delete (Suprimir) o Backspace en su teclado.

Sección 5

Tipos de Nodos y Reglas

Arrastre las cajas desde el menú lateral izquierdo hacia el lienzo para construir la lógica de la conversación. A continuación, explicamos cada tipo de nodo disponible:

🚀

Inicio (Start)

Punto de entrada obligatorio. Representa la palabra clave o detonante. Ej: si dice "Precio", al usuario enviar "Precio" iniciará este flujo.

Texto

Envía un mensaje de texto plano o emojis. Útil para respuestas rápidas y estructuradas de forma inmediata.

🖼️
🎵
📄

Imagen / Audio / Documento

Envía archivos multimedia. Límite de 3MB para Imágenes y 1MB para los demás. Los audios deben ser formatos compatibles con WhatsApp (mp3, ogg, etc).

Pregunta

Hace una pregunta al usuario y espera su respuesta. El valor escrito por el cliente se puede guardar en una variable para usarla después.

🧾

Validador

Evalúa si la respuesta capturada cumple con un formato esperado (Ej. es un correo válido o tiene X caracteres). Divide el flujo en "Válido" e "Inválido".

⚖️

Condición

Compara variables con valores específicos (Ej. si "Edad" > 18) para bifurcar la lógica. Permite habilitar características avanzadas como IA (Gemini/Groq/OpenAI) para que la IA decida la condición en base a la respuesta del usuario.

📋

Lista / Menú

Envía un menú de opciones clickeables nativo de WhatsApp. El usuario selecciona una opción y el flujo continuará por el puerto correspondiente.

⏱️

Timer (Pausa)

Detiene la ejecución del flujo por un tiempo específico (segundos o minutos) antes de pasar al siguiente paso. Ideal para enviar mensajes espaciados.

🔴

Fin

Finaliza la conversación actual o sirve para reiniciar y transferir el flujo de vuelta al nodo de Inicio si es necesario.

🌐 Píxel de Meta (CAPI): Casi todos los nodos anteriores cuentan con la opción de registrar un Evento CAPI Meta en segundo plano. Esto permite optimizar sus campañas publicitarias avisándole a Facebook en qué etapa del flujo llegó el usuario.