IA para Chatwoot autohospedado: opciones y configuración

Elige cómo añadir IA

La página oficial consultada el 16 de octubre de 2026 incluye Captain en Premium Support y Enterprise, pero no en Community Edition. Consulta las condiciones actuales antes de decidir.

• Captain: evalúa la IA nativa, su plan y las condiciones de tratamiento de datos.
• Servicio externo: conecta un Agent Bot a GPT KeFu y conserva tu bandeja. La IA sigue siendo externa; no es una instalación completamente local.
• Agent Bot propio: implementa la lógica o conecta una automatización. Tú mantienes el bot, las fuentes y las reglas de atención humana.

• Planes oficiales de Chatwoot autohospedado
• Guía oficial de Agent Bots

1. Reúne los datos de instancia y bandeja

Crea un proyecto Chatwoot en GPT KeFu. Abre los ajustes de la bandeja en Chatwoot y copia la URL del navegador. El formulario puede extraer URL base, Account ID e Inbox ID; también puedes ingresarlos manualmente.

La URL base es el origen HTTPS sin /app. Account ID aparece después de /app/accounts/ e Inbox ID después de /settings/inboxes/. En Profile Settings, copia el Access Token personal de un administrador, no el Bot Access Token.

2. Crea el bot y guarda su secreto de firma

En Settings → Bots, crea o edita un Agent Bot y copia su Webhook Secret. Firma los callbacks y no es el token de API. Pégalo en el campo de firma del Agent Bot en GPT KeFu.

Si el bot exige una URL antes de guardar la conexión, usa temporalmente una URL HTTPS pública que controles y no vincules ninguna bandeja todavía. Copia el secreto y guarda la conexión en GPT KeFu para obtener la URL definitiva. Guardar no activa respuestas.

3. Configura el callback definitivo

Reemplaza la URL temporal por la URL de webhook del Agent Bot mostrada en GPT KeFu. Vincula el bot en Bot Configuration de la bandeja correcta y guarda.

Usa el secreto del mismo bot. Deja desactivado el webhook opcional de cuenta: el Agent Bot ya envía estados de conversación. Si necesitas el webhook de cuenta más adelante, utiliza su URL y secreto propios.

4. Verifica ambos sentidos y activa la IA

1. Ejecuta Check connection para verificar acceso a la API con las credenciales guardadas.
2. Envía un mensaje nuevo como visitante a la bandeja vinculada. Comprueba la validación del callback firmado; repite la verificación si hace falta.
3. Con API y callback verificados, activa las respuestas de IA.
4. Envía otro mensaje nuevo y revisa la respuesta en Chatwoot. El mensaje de verificación anterior no recibe una respuesta automática retroactiva.

Resuelve la etapa que falló

• Falla de API: revisa origen HTTPS, token de administrador, Account ID, Inbox ID y bloqueos del proxy o firewall.
• Callback pendiente: comprueba la vinculación del bot y la URL definitiva. Envía un mensaje de visitante, no de agente.
• Firma inválida: copia el Webhook Secret del mismo bot y verifica que la instancia admita callbacks firmados. No desactives la validación de firmas.
• Conexión válida sin respuestas: revisa activación, funciones del plan, modelo y posibles pausas por respuestas humanas.