Conexión de Chatbots externos (Typebot vía Webhook) e integración con canales Slack

• Categoría: Integraciones y desarrolladores
• Disponibilidad: Disponible en planes Premium y Evolución
• Tiempo estimado de lectura y configuración: 12 minutos
• Rol necesario: Administrador

Además del agente de IA generativa nativo Capitán, Waclis Inbox permite conectar motores de flujos conversacionales externos (como Typebot, n8n o servicios propios) mediante Bots de agentes (Ajustes → Bots de agentes) y vincular tu espacio de trabajo de Slack desde Ajustes → Integraciones. De este modo puedes ejecutar árboles de decisión estructurados y transferir la conversación a un operador humano cambiando su estado de bot a open, o permitir que tu equipo técnico responda consultas sin salir de Slack.

1. Qué puedes hacer y cuándo te sirve

• Registrar Bots de agentes (Agent Bots) en Ajustes → Bots de agentes: Defines el nombre, la descripción y la URL de salida (Webhook URL) hacia tu flujo en Typebot, n8n o backend propio, obteniendo un token de acceso exclusivo para el bot.
• Asignar un bot específico a cada bandeja de entrada: En Ajustes → Entradas → Configuración → Configuración de bot, eliges qué bot atiende inicialmente las conversaciones nuevas de ese canal en estado bot.
• Transferir la conversación a un agente humano (Handoff): Cuando el flujo externo termina de recolectar datos o el cliente pide hablar con un asesor, el bot cambia el estado de la conversación de bot a open mediante la API para que ingrese inmediatamente a la cola de tus agentes.
• Vincular canales de Slack (Ajustes → Integraciones → Slack): Recibes las conversaciones de Waclis Inbox como hilos (threads) dentro de un canal de Slack y puedes responder al cliente o publicar notas privadas directamente desde Slack.

Cuándo conviene usar cada opción

• Formularios guiados paso a paso (Typebot / n8n): Cuando necesitas un árbol estricto de botones o preguntas secuenciales fijas antes de pasar el caso a un operador, o cuando ya tienes flujos construidos en Typebot o n8n.
• Escalamiento rápido a especialistas en Slack: Cuando tu equipo de ingeniería o administración trabaja todo el día en Slack y prefieres que colaboren o respondan desde los hilos sincronizados.

2. Disponibilidad por plan

• Plan Estándar: Incluye integración mediante API REST de Cuenta, Client API y Webhooks salientes.
• Plan Premium: Habilita Ajustes → Bots de agentes (conexión de flujos Typebot / n8n), el conector oficial de Slack en Ajustes → Integraciones y el Agente de IA nativo Capitán.
• Plan Evolución: Suma Herramientas personalizadas HTTP (Custom Tools) y Servidores MCP en Capitán, además de políticas avanzadas de capacidad y SLA tras el traspaso a humanos.

3. Requisitos previos

1. Contar con suscripción activa en Plan Premium o Plan Evolución y rol de Administrador en Waclis Inbox.
2. Para conectar Typebot o n8n: Disponer de una URL HTTPS pública donde tu flujo reciba los eventos POST de Waclis Inbox.
3. Para conectar Slack: Contar con permisos de administrador en tu espacio de trabajo (workspace) de Slack para autorizar la aplicación oficial.

4. Paso a paso en Waclis Inbox

Parte 1: Crear y vincular un Bot de agente externo (Typebot / n8n)

1. En la barra lateral izquierda de Waclis Inbox, ve a Ajustes → Bots de agentes (Ajustes → Bots) y haz clic en Añadir un nuevo bot.
2. Completa el formulario de alta del bot:

• Nombre del bot: Por ejemplo, Bot Calificador Typebot.
• Descripción: Breve detalle del propósito del flujo.
• URL del webhook (outgoing_url): Pega la URL HTTPS de tu webhook en Typebot o n8n que recibirá los eventos de los mensajes.

1. Haz clic en Guardar y copia el Token de acceso (access_token) generado para ese bot.
2. Dirígete a Ajustes → Entradas, haz clic en el icono de engranaje (Configuración) de la bandeja donde actuará el bot y abre la pestaña Configuración de bot.
3. Selecciona tu nuevo bot en la lista desplegable y pulsa Actualizar.
4. Comportamiento en vivo y traspaso a humano:

• Las conversaciones nuevas en esa bandeja se abrirán en estado bot (no consumirán cupo de tus agentes humanos mientras el bot las atiende).
• Para que tu flujo de Typebot o n8n envíe respuestas al cliente, realiza un POST a /api/v1/accounts/{account_id}/conversations/{conversation_id}/messages autenticando con la cabecera api_access_token: <TOKEN_DEL_BOT>.
• Cuando el flujo deba derivar la charla a tu equipo humano, realiza un POST a /api/v1/accounts/{account_id}/conversations/{conversation_id}/toggle_status enviando {"status": "open"}.

Parte 2: Conectar un canal de Slack en Ajustes → Integraciones

1. En Waclis Inbox, navega a Ajustes → Integraciones.
2. Ubica la tarjeta Slack y haz clic en Configurar / Conectar.
3. Se abrirá la pantalla de autorización OAuth de Slack: selecciona tu espacio de trabajo, otorga los permisos solicitados y elige el canal de Slack (por ejemplo, #atencion-clientes) donde deseas centralizar las notificaciones.
4. Una vez conectado:

• Cada conversación activa generará un hilo (thread) dedicado dentro del canal de Slack seleccionado.
• Si respondes dentro de ese hilo en Slack, tu mensaje se enviará al cliente a través de Waclis Inbox; si antepones note: o utilizas el comando de nota interna, quedará registrado como Nota privada amarilla para tu equipo.

5. Opciones y parámetros clave

6. Comparativa: Cuándo usar el Agente de IA Capitán vs. un Bot de flujo externo

7. Cómo se combina con otras funciones y con el ecosistema Waclis

• Reglas de automatización y Equipos: Cuando tu flujo de Typebot cambia el estado de la conversación a open y le añade una etiqueta (por ejemplo, ventas-mayoristas), una regla en Ajustes → Automatizaciones puede detectar el cambio y asignar el chat al equipo correspondiente mediante Round Robin.
• Notas privadas de contexto: Antes de ejecutar el paso a open, tu bot puede enviar un mensaje con "private": true resumiendo las respuestas del cliente para que el vendedor humano tenga todo el contexto sin volver a preguntar.
• Gobernanza comercial en panel.waclis.com: La habilitación del Plan Premium o Plan Evolución para usar Bots de agentes, Slack y Capitán se administra desde panel.waclis.com vía Waclis Connect.

8. Problemas frecuentes y cómo resolverlos

9. Preguntas frecuentes (FAQ)

¿Puedo usar el Agente de IA Capitán en una bandeja y un bot de Typebot en otra bandeja distinta?

Sí. La pestaña Configuración de bot dentro de Ajustes → Entradas → Configuración es independiente por cada bandeja de entrada.

¿Qué ocurre si un agente humano escribe manualmente en una conversación que estaba en estado bot?

En cuanto un operador humano envía una respuesta pública en el chat, Waclis Inbox cambia automáticamente el estado de la conversación de bot a open para que el bot ceda el control a la persona.

10. Artículos relacionados

• Configuración inicial del Agente de IA Capitán: modelos LLM e instrucciones
• Webhooks salientes en tiempo real y verificación de firma de seguridad HMAC-SHA256
• API REST de Cuenta y Client API: autenticación, tokens y endpoints principales