Captain

Comienza con Captain AI

Captain es la IA de Chatwoot. Puede responder a los clientes por ti, ayudar a tus agentes a redactar respuestas y aprender de tus documentos de ayuda y conversaciones anteriores. Lo que puede hacer Captain | Funcionalidad | Lo que hace | Quién lo usa | Página | | ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Asistente | Responde a los clientes en los buzones que conectes y entrega la conversación a tu equipo cuando no puede ayudar | Clientes | Crear y conectar un asistente | | Conocimiento | Aprende de páginas web, PDFs y preguntas frecuentes (FAQs) que agregues | Administradores | Agregar conocimiento: documentos · FAQs y sugerencias de FAQ | | Límites, guías y escenarios | Controla qué responde el asistente, cómo suena y qué hace en situaciones específicas | Administradores | Límites, guías y escenarios | | Audiencia y horario | Limita a qué clientes responde el asistente y cuándo | Administradores | Controlar a quién responde Captain y cuándo | | Herramientas personalizadas | Permite que el asistente consulte información en tus propios sistemas, como el estado de un pedido | Administradores | Herramientas personalizadas | | Copilot | Ayuda a los agentes a resumir, redactar respuestas y buscar información mientras trabajan | Agentes | Copilot | | Recuerdos | Guarda detalles clave del cliente como notas de contacto para la próxima vez | Asistente | Recuerdos | | Ayuda de IA en el editor y buzón | Reformular, resumir y sugerir respuesta en el editor, transcripción de audio y Sugerir con Captain para etiquetas y prioridad de la conversación | Agentes; administradores lo habilitan | | | Condiciones de Captain en automatización | Una regla de automatización puede preguntar a Captain si una conversación coincide con una descripción que escribas, por ejemplo "el cliente quiere cancelar" | Administradores | | Plan y acceso | Plan | Captain | | ------------- | --------------------------------------------------------- | | Hacker (gratis) | No incluido | | Startups | Incluido, con créditos de IA mensuales | | Business | Incluido, con más créditos de IA mensuales. Agrega herramientas personalizadas | | Enterprise | Incluido, con la mayor cantidad de créditos mensuales de IA| - Los montos de créditos por plan y el precio para recargar están en Precios y Planes > Créditos Captain AI. Cómo se usan los créditos está en Créditos de IA y uso. - Rol: solo los administradores pueden crear o cambiar asistentes, documentos, FAQs y herramientas. Los agentes pueden ver los asistentes, probarlos en el Playground, revisar sugerencias de FAQ y usar Copilot. - Autohospedado: Captain está incluido en los planes Premium y Enterprise autohospedados, con tu propia clave de OpenAI. Consulta Habilitar Captain en autohospedado. - Prueba gratuita: Captain no está disponible durante la prueba gratuita. Cómo comprobar si lo tienes Busca Captain en la barra lateral izquierda. Si haces clic y ves Actualizar para usar Captain AI, tu cuenta está en el plan Hacker. Un administrador puede actualizar desde Facturación. Configura y prueba El orden habitual: 1. Crear y conectar un asistente, luego pruébalo en el Playground. 2. Agregar conocimiento: documentos para que conozca tu producto. 3. Opcional: Controlar a quién responde Captain y cuándo, Límites, guías y escenarios, Herramientas personalizadas. Administradores autohospedados empiezan con Habilitar Captain en autohospedado. Obtén valor - Mantén actualizado el conocimiento: revisa las sugerencias de FAQ cada semana. Consulta FAQs y sugerencias de FAQ. - Revisa el Resumen del asistente para ver la Cobertura del conocimiento y cuántas conversaciones ha manejado. - Entrega una conversación al asistente manualmente: asígnalo en el menú desplegable de encargado de la conversación. Consulta Crear y conectar un asistente. - Revisa el uso de créditos en Facturación. Consulta Créditos de IA y uso. Qué cambia en otras funciones cuando Captain está activo - Chat en vivo del sitio web: el mensaje "no estamos disponibles" no se muestra mientras el asistente responde. - Continuar conversaciones por correo electrónico: el aviso de correo electrónico no se muestra a menos que el asistente entregue la conversación. - Saludo del buzón: el mensaje de saludo del buzón no se envía mientras el asistente gestiona la conversación. Si el asistente responde a todos (audiencia definida como Todos), los clientes en sus buzones no verán el saludo. - La Lección 5 en Empieza aquí explica Captain de principio a fin. Consulta Lección 5: Acciones de IA. Solución de problemas Si Captain no responde, da respuestas incorrectas o no aprende, ve a Solucionar problemas con Captain.

Configura un asistente de Captain y conecta tus bandejas de entrada

Descubrir Un asistente responde a los clientes en los buzones que conectes y transfiere la conversación a tu equipo cuando no puede ayudar. Plan y acceso: Startups, Business o Enterprise Precios y Planes. Los administradores crean, editan y eliminan asistentes. Los agentes pueden verlos y usar el Playground. Cada buzón puede tener un asistente. Configuración y prueba Antes de empezar - Al menos un buzón para conectar (chat en vivo, WhatsApp, Instagram, correo electrónico y otros). - Algo de conocimiento para añadir de inmediato: páginas web, PDFs o preguntas frecuentes. Sin conocimiento, el asistente tendrá poco de qué responder. - Créditos de Captain: cada respuesta del asistente a un cliente utiliza créditos. 1. Crear el asistente 1. Ve a Captain > Asistentes. 2. Inicia el nuevo asistente: - Sin asistentes aún: haz clic en Crear un nuevo asistente en la página vacía. - Si ya tienes un asistente: abre el selector de asistentes junto al nombre del asistente y haz clic en Crear asistente. 3. Rellena: Nombre, Descripción y Nombre del producto son obligatorios. La descripción puede tener hasta 500 caracteres. - Nombre: un nombre interno, por ejemplo "Asistente de soporte". - Descripción: para qué sirve el asistente. Escribe un propósito, no instrucciones. - Nombre del producto: el producto que soporta. Lo utiliza cuando habla de tu producto. Captain solo responde preguntas sobre el producto que nombres aquí, así que usa el nombre de tu marca o producto, no una característica específica. 4. Elige funciones (todas comienzan desactivadas): - Generar FAQs a partir de conversaciones resueltas: Captain sugiere nuevas FAQs a partir de conversaciones resueltas. Ver FAQs y sugerencias de FAQs. - Capturar detalles clave como recuerdos de las interacciones con clientes. Ver Recuerdos. - Incluir citas de origen en las respuestas: la respuesta muestra qué documento utilizó. 5. Haz clic en Crear. - Si este es tu primer asistente, Chatwoot abre sus FAQs. - Si utilizaste el selector, Chatwoot permanece en el asistente que estabas viendo. Selecciona el nuevo asistente en el selector antes del siguiente paso. 2. Conectar un buzón 1. Selecciona el nuevo asistente en el selector de asistentes, luego ve a Buzones. 2. Haz clic en Conectar un nuevo buzón, elige el buzón y confirma. Hasta que se conecte un buzón, la Descripción general del asistente muestra: "Este asistente aún no está conectado a ningún buzón, así que no responderá a las conversaciones." 3. Configura lo que dice y cuándo finaliza Abre la Configuración del asistente. - Configuración básica: activa Permitir el acceso a la información de contacto si el asistente debe usar los datos del contacto al responder. - Configuración del sistema: - Mensaje de transferencia: lo que el asistente dice al pasar la conversación a tu equipo. - Cuando los clientes dejan de responder: elige la Acción cuando el cliente deja de responder y cuánto tiempo esperar (5 minutos a 24 horas; el valor predeterminado es 60 minutos). - Dejar que Captain lo revise (recomendado): Captain decide si resolver o transferir. Esta es la opción predeterminada. - Siempre resolver: Captain resuelve todas las conversaciones tras la espera. - Esperar al cliente: Captain nunca resuelve por sí mismo. Aun así puede transferir si el cliente lo solicita. - Enviar un mensaje al resolver (activado por defecto) envía el Mensaje de resolución antes de que Captain resuelva. Pruébalo 1. Abre el asistente y ve a Playground. 2. Haz las preguntas que tus clientes hacen con más frecuencia. Verifica que las respuestas sean precisas, cortas y con el tono adecuado. 3. Pregunta algo que no debería saber. Verifica que diga que no puede ayudar y ofrezca conectarte con tu equipo. Se transfiere cuando aceptas. 4. La respuesta puede tardar unos segundos en aparecer; puedes mantener la página abierta mientras responde. 5. Luego envía un mensaje real al buzón conectado, por ejemplo desde el widget de tu sitio web, y observa cómo llega la respuesta. Los mensajes de Playground usan créditos, igual que las respuestas a clientes. Prueba cambios antes de guardarlos En el Playground, abre Configurar prueba para probar cambios sin afectar al asistente. Los cambios solo se aplican a esta sesión de Playground a menos que los guardes. - Conocimiento: pega texto en Texto de referencia para probar una respuesta antes de que sea un documento. Haz clic en Añadir documento permanentemente para guardarlo. - Escenarios, Directrices y Limitaciones: agrega un elemento temporal con Agregar a la prueba (↵), o usa Incluir en esta prueba para activar o desactivar elementos guardados en esta prueba. Haz clic en Añadir escenario permanentemente, Añadir directriz permanentemente o Añadir limitación permanentemente para guardarlos. - Debajo de cada respuesta, Detalles de ejecución muestra los escenarios y reglas usados, herramientas utilizadas y cualquier transferencia. - Restablecer configuración de prueba limpia todo lo temporal. Obtener valor - Añade conocimiento a continuación: Añadir conocimiento: documentos. - Decide a quién responde y cuándo: Controlar a quién responde Captain y cuándo. - Da forma a sus respuestas: Limitaciones, directrices y escenarios. - Consulta el Resumen del asistente para ver conversaciones gestionadas, Cobertura de conocimiento y un Resumen de Captain. - Entrega una conversación al asistente tú mismo: en el menú desplegable de asignados de la conversación, elige el asistente (solo se muestra el asistente conectado a ese buzón). La conversación pasa a pendiente y el asistente toma el control, incluso si las reglas de audiencia o programación la habrían omitido. Para recuperarla, asígnala a una persona. - Usa el selector de asistentes (Cambiar entre asistentes) si gestionas varios, por ejemplo uno por marca o idioma. - El asistente lee los mensajes públicos anteriores de la conversación, incluyendo los enviados antes de estar conectado. Nunca ve notas privadas. - Para ver cómo va el asistente, utiliza su Resumen. Ver Descripción general y reportes de Captain. Solución de problemas | Síntoma | Causa probable | Qué hacer | | ----------------------------------------------------- | -------------------------------------- | --------------------------------------------------------| | El asistente nunca responde | No hay ningún buzón conectado | Conecta uno en Buzones | | No se puede conectar un buzón | El buzón ya tiene un asistente | Desconéctalo primero del otro asistente | | Las respuestas son vagas o incorrectas | Poco o ningún conocimiento añadido | Agrega documentos y FAQs, luego prueba nuevamente en el Playground | | No ves Crear un nuevo asistente o Crear asistente | No eres administrador | Pide acceso a un administrador | Más causas, incluidas las silenciosas: Solucionar problemas de Captain.

Agregar documentos al conocimiento del Capitán

Descubrir Los documentos enseñan a tu asistente sobre tu producto. Agrega páginas web o archivos PDF, y Captain los lee, responde a partir de ellos y crea preguntas frecuentes a partir de estos documentos. Plan y acceso: Startups, Business o Enterprise Precios y Planes. Los administradores pueden agregar, actualizar o eliminar documentos. Cada plan de pago incluye hasta 2,000 documentos. El límite se comparte entre todos los asistentes de la cuenta, y cada PDF o página web rastreada cuenta como un documento. Configura y prueba Antes de empezar - Un asistente. Consulta Crear y conectar un asistente. - Las páginas web deben ser públicas. Captain no puede leer páginas que requieren inicio de sesión. - Los PDF deben pesar 10 MB o menos y contener texto real (las imágenes escaneadas pueden no ser legibles). - Si tu sitio web bloquea rastreadores en robots.txt, permite Chatwoot primero (ver más abajo). Agregar un sitio web o PDF 1. Ve a Captain > Documentos. 2. Haz clic en Crear un nuevo documento. 3. Elige el Tipo de documento: - URL: ingresa la dirección de la página. Captain lee esa página y las páginas enlazadas bajo la misma ruta. Por ejemplo, https://example.com/help cubre cada página que comienza con esa dirección. - Archivo PDF: haz clic en Elegir archivo PDF y selecciona el archivo. 4. Opcional: agrega un Nombre de documento (opcional). 5. Elige el asistente y haz clic en Crear. Captain lee e indexa el contenido. Las páginas que encuentra mientras rastrea se agregan como documentos separados. Permitir que Chatwoot rastree tu sitio Chatwoot utiliza Firecrawl para leer sitios web y respeta tu archivo robots.txt. Si algunas páginas están bloqueadas, agrega esto a https://yourdomain.com/robots.txt: User-agent: FirecrawlAgent Allow: / Verifica que el archivo esté disponible en esa dirección y luego añade o actualiza el documento. Si tu robots.txt bloquea el rastreador cuando agregas un sitio web, no se agregan páginas y no se muestra ningún error. El asistente entonces dará respuestas incompletas o genéricas. Pruébalo 1. Abre el menú del documento y elige Ver detalles. 2. Verifica que el Contenido rastreado (o Detalles del PDF) muestre tu texto, y que Preguntas frecuentes relacionadas liste preguntas lógicas. 3. Haz una pregunta de esa página en el Playground del asistente. Obtén valor - Mantén los documentos actualizados: usa Actualizar ahora en un documento, o selecciona varios y haz clic en Actualizar. La lista muestra cuándo fue la última vez que se actualizó cada uno. - Los documentos de sitios web también se actualizan automáticamente: mensualmente en Startups (el día 1), semanalmente en Business (los domingos) y diariamente en Enterprise. El procesamiento puede demorar, por lo que es posible que una página no se actualice en ese momento exacto. Los PDF subidos no se actualizan automáticamente. - Una sola rastreo de sitio web agrega hasta 500 páginas, y nunca más que el límite de documentos restante. - Prefiere fuentes enfocadas, como tu centro de ayuda, en lugar de todo el sitio de marketing. - Usado en conversaciones muestra qué conversaciones usaron un documento. - Eliminar un documento borra todo lo que Captain aprendió de él. - Los artículos del centro de ayuda no se leen automáticamente. Para usarlos, agrega la dirección de tu centro de ayuda como un documento de tipo URL. Cada versión en un idioma de un artículo es una página aparte, así que cada una cuenta como un documento. - Las preguntas frecuentes creadas a partir de un documento se publican inmediatamente. Se listan en FAQs y no necesitan aprobación. - Las preguntas frecuentes que genera Captain siempre están en el idioma de tu cuenta. El asistente igual responde en el idioma del cliente. - Captain no elimina datos personales o confidenciales de lo que agregas. Solo añade contenido que estés dispuesto a que el asistente cite a los clientes. Solucionar problemas | Síntoma | Causa probable | Qué hacer | | -------------------------------------------------------------------- | ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | | El estado muestra No se pudo sincronizar con Acceso denegado | La página requiere inicio de sesión, o tu sitio bloqueó la solicitud (error 401 o 403). | Haz la página pública, o permite la solicitud en tu sitio. | | Agregaste un sitio web pero no aparece ninguna página, o las respuestas son genéricas | Tu robots.txt puede estar bloqueando el rastreador. | Permítelo como se muestra en Permitir que Chatwoot rastree tu sitio, luego agrega el documento de nuevo. | | Página no encontrada | La URL es incorrecta o la página se movió | Corrige la URL y agrégala de nuevo | | La página tardó demasiado en responder | Tu sitio estaba lento | Usa Reintentar actualización más tarde | | La página devolvió contenido vacío | El contenido solo carga con scripts, o la página está vacía | Usa una página con texto plano, o sube un PDF | | actualización detenida | Una actualización no terminó | Usa Reintentar actualización | | Los detalles del PDF dicen que no se pudo extraer contenido legible | PDF escaneado o solo con imágenes | Sube un PDF con texto | | Banner: Se alcanzó el límite de documentos | La cuenta tiene 2,000 documentos entre todos sus asistentes | Elimina documentos que ya no necesites, o consulta Precios y Planes | Más motivos: Solucionar problemas con Captain.

Agrega preguntas frecuentes y revisa las sugerencias de preguntas frecuentes en Captain

Descubre Las preguntas frecuentes (FAQs) son pares de preguntas y respuestas que utiliza tu asistente para responder. Puedes escribirlas tú mismo, y Captain sugiere nuevas a partir de tus documentos y de las preguntas frecuentes de los clientes. Plan y acceso: Startups, Business o Enterprise Precios y Planes. Los administradores escriben y editan las FAQs. Cualquiera puede revisar las sugerencias de FAQ; los agentes solo ven las sugerencias de conversaciones a las que pueden acceder. Configura y prueba Antes de comenzar - Un asistente con algunos documentos. Ver Agregar conocimientos: documentos. - Para sugerencias desde conversaciones, activa Generar FAQs a partir de conversaciones resueltas en el asistente. Ver Crear y conectar un asistente. Escribe una FAQ 1. Ve a Captain > FAQs. 2. Haz clic en Crear nueva FAQ. 3. Ingresa la pregunta y la respuesta, elige el asistente y haz clic en Crear. Revisa las sugerencias de FAQ Captain agrupa preguntas recurrentes de los clientes en sugerencias y las ordena según la demanda de los clientes. Las sugerencias se escriben en el idioma de tu cuenta. Solo provienen de conversaciones resueltas donde un agente respondió. Las conversaciones que Captain maneja por sí solo no generan sugerencias. 1. Ve a Captain > FAQs y haz clic en Revisar sugerencias (o abre Sugerencias de FAQ). 2. Abre una sugerencia. Conversaciones fuente muestra las conversaciones que la originaron. 3. Edita la pregunta o la respuesta si es necesario y haz clic en Guardar cambios. 4. Haz clic en Aprobar para agregarla al conocimiento de Captain, o en Descartar para eliminarla. Las FAQs que Captain genera a partir de un documento aparecen bajo FAQs relacionadas de ese documento. Las FAQs creadas desde tus documentos se publican al instante y no necesitan aprobación. Pruébalo Haz la pregunta aprobada en el Playground del asistente y comprueba que utilice tu respuesta. Obtén valor - Revisa las sugerencias semanalmente. Provienen de preguntas reales de clientes, así que llenan los vacíos más importantes. - Mantén las respuestas cortas y específicas. Una pregunta por FAQ. - En el Resumen del asistente se muestra la Cobertura de conocimientos: FAQs aprobadas frente a sugerencias pendientes de revisión. Aparece un banner cuando hay sugerencias listas. - Busca con Buscar FAQs... y selecciona varias para eliminarlas de una vez. Solución de problemas | Síntoma | Causa probable | Qué hacer | | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- | | Nunca aparecen sugerencias | Generar FAQs a partir de conversaciones resueltas está desactivado, o se han resuelto pocas conversaciones. O no hubo respuesta de un agente. Se requiere al menos una respuesta de agente. | Actívalo en el asistente y dale tiempo | | El asistente sigue dando la respuesta anterior | La FAQ es una sugerencia, no está aprobada | Apruébala | | No se puede crear o editar una FAQ | No eres administrador | Pide a un administrador, o solo aprueba sugerencias | | Un agente ve menos sugerencias que un administrador| Los agentes solo ven sugerencias de conversaciones a las que pueden acceder | Es lo esperado | | No se encontraron conversaciones fuente accesibles. | Las conversaciones están en bandejas que no puedes ver, o fueron eliminadas | Pide a un administrador con acceso que lo revise | Más causas: Solucionar problemas en Captain.

Usa Capitán Recuerdos

Descubre Con los recuerdos activados, el asistente guarda detalles clave de una conversación como notas en el contacto, para que tu equipo y Copilot tengan contexto la próxima vez. El asistente no lee estas notas cuando responde a los clientes. Plan y acceso: Startups, Negocios o Empresa ([Link: Pricing & Plans]). Un administrador lo activa por asistente. Configura y prueba Antes de comenzar - Un asistente. Consulta Create and connect an assistant. Activa los recuerdos 1. Ve a Captain > Assistants, abre el asistente y dirígete a Settings. 2. Activa Capture key details as memories from customer interactions. 3. Guarda. Qué se guarda Detalles que ayudan para la próxima vez, como: - Preferencias y los productos o plan que usa el cliente. - Preguntas o problemas recurrentes. - Necesidades especiales, como una integración de la que dependen. - Contexto como el tamaño del equipo. Pruébalo Ten una conversación en la que menciones una preferencia, por ejemplo "Usamos el plan Pro y preferimos email", y resuélvela. Luego abre el contacto y revisa Notes. Obtén valor - Los recuerdos aparecen en las Notes del contacto con "Bot" como autor y la hora en que se guardaron. Los agentes los ven en la barra lateral de la conversación. - Los recuerdos se guardan cuando una conversación en una bandeja conectada se resuelve, ya sea que la haya gestionado el asistente o un agente, siempre que la cuenta tenga créditos. - Los agentes pueden eliminar un recuerdo pero no pueden editarlo. - Informa a los clientes sobre lo que almacenas, conforme a tu política de privacidad. Solución de problemas | Síntoma | Causa probable | Qué hacer | | ----------------------------------- | ------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | | No aparecen notas | El interruptor está apagado, la conversación no está resuelta o no surgió nada relevante | Verifica la configuración; resuelve la conversación | | Los recuerdos se detuvieron | Se acabaron los créditos | Consulta AI credits and usage | | Notas solo aparecen en algunos contactos | Solo las conversaciones resueltas en bandejas conectadas al asistente crean recuerdos | Esperado | Más causas: Troubleshoot Captain.

Trabaja más rápido con Captain Copilot

Descubrir Copilot es un asistente de IA para agentes, dentro de cada conversación. Pídele que resuma, redacte una respuesta, revise el tono, traduzca o busque información. Plan y acceso: Startups, Business o Enterprise Precios y Planes. Cualquier agente puede usarlo, en cualquier buzón. No hay nada que activar por buzón. Cada solicitud a Copilot utiliza créditos de Captain. Configura y prueba Antes de empezar - Al menos un asistente Captain. Copilot utiliza el conocimiento de un asistente cuando busca información. También busca en tus artículos del centro de ayuda si tienes permisos para gestionar la base de conocimientos. El asistente no necesita estar conectado a un buzón. Para obtener IA que ayude a los agentes pero nunca responda a los clientes, crea un asistente y no lo conectes a ningún buzón. Consulta Crear y conectar un asistente. Usa Copilot 1. Abre una conversación. 2. A la derecha, abre la pestaña Copilot. 3. Elige una sugerencia de Prueba estos mensajes (Resume esta conversación, Sugiere una respuesta, Califica esta conversación), o escribe tu propia solicitud. Fuera de una conversación, Copilot ofrece en su lugar Conversaciones de alta prioridad y Listar contactos. 4. Si tienes varios asistentes, usa Seleccionar asistente para elegir de quién usar el conocimiento. 5. Cuando Copilot redacte una respuesta que te guste, haz clic en Usar esto para ponerla en el cuadro de respuesta. Edita y luego envía. 6. Haz clic en Restablecer para empezar de nuevo. Pruébalo Abre una conversación real, elige Sugiere una respuesta y comprueba que el borrador utiliza el conocimiento de tu producto. Obtén valor - Sé específico: "Escribe una respuesta cortés explicando el retraso y ofreciendo la entrega el viernes" funciona mejor que "responde". - Lee siempre un borrador antes de enviarlo. Copilot sugiere; el agente decide. - Usa Mostrar pasos para ver cómo Copilot llegó a una respuesta. - Sugiere una respuesta en Copilot utiliza toda la configuración del asistente seleccionado: su descripción, pautas de respuesta, límites y preguntas frecuentes. Sugiere una respuesta en el editor de respuestas usa solo las preguntas frecuentes (del asistente conectado al buzón, o todas las preguntas frecuentes aprobadas en la cuenta), no las pautas ni el tono. - Las acciones del editor como reformular y resumir son funciones de IA separadas. - Para obtener etiquetas sugeridas o una prioridad para una conversación, usa Sugerir con Captain en la barra lateral de la conversación. Soluciona problemas | Síntoma | Causa probable | Qué hacer | | ------------------------------------------------------------------------------------ | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | | No aparece la pestaña Copilot | La cuenta es Hacker (gratuita), o Captain no está activo| Consulta Captain en Chatwoot | | "No tienes créditos de Copilot. Puedes comprar más créditos en la sección de facturación." | No quedan créditos | Compra créditos en Facturación, o espera a la renovación | | "Hubo un error al generar la respuesta. Por favor, inténtalo de nuevo." | Error temporal | Inténtalo de nuevo | | Las respuestas ignoran tus documentos | Asistente incorrecto seleccionado, o no tiene documentos| Usa Seleccionar asistente; agrega documentos | Más causas: Soluciona problemas con Captain.

Habilitar Captain en autoalojado

Descubrir Puedes ejecutar Captain en tu propia instalación de Chatwoot con tu propia clave de OpenAI. Plan y acceso: incluido en los planes autohospedados Premium y Enterprise. Consulta [Link: Editions & licensing]. Necesitas acceso a la consola de Super Admin. La edición Community no incluye Captain. Premium y Enterprise obtienen las mismas funciones y ajustes de Captain. Configurar y probar Antes de comenzar - Una clave API de OpenAI. - Opcional: un endpoint compatible con OpenAI si alojas tu propio modelo. - Opcional: una clave API de Firecrawl para un mejor rastreo de sitios web. Sin ella, Chatwoot utiliza un rastreador incorporado más simple. 1. Configura Captain para la instalación 1. Abre la consola de Super Admin y ve a Configuración. 2. En la tarjeta de Captain, haz clic en el ícono de ajustes (engranaje). 3. Rellena: - Clave API de OpenAI. - Modelo de OpenAI establece el modelo para las funciones de Copilot y editor. Déjalo en blanco para usar gpt-4.1-mini. El asistente utiliza gpt-5.2 por defecto. Para cambiarlo, ve a Super Admin › Cuentas, edita la cuenta y abre la pestaña Modelos de Captain. Si usas un endpoint personalizado, asegúrate de que sirva los modelos que selecciones aquí. [Screenshot: captain-11-c3-captain-models.png] - Endpoint de la API de OpenAI (opcional), para un modelo autohospedado compatible. - Modelo de Embedding (opcional). - Clave API de FireCrawl (opcional). 4. Haz clic en Enviar. 2. Activa Captain para una cuenta Las cuentas creadas mientras tu instalación está en Premium o Enterprise ya tienen Captain activado. Para las cuentas creadas antes de eso: 1. En la consola de Super Admin, ve a Cuentas. 2. Abre la cuenta y haz clic en Editar. 3. En las funciones premium, activa Captain. Las reglas, directrices de respuesta y escenarios vienen incluidos. Para herramientas personalizadas, activa también Herramientas Personalizadas (Custom tools). 4. Guarda. Pruébalo Inicia sesión en esa cuenta. Captain aparece en la barra lateral. Crea un asistente y envía un mensaje en el Playground. Consulta Crear y conectar un asistente. Obtén valor - OpenAI te cobra por el uso en tu propia clave. Chatwoot no cuenta créditos de Captain en instalaciones autohospedadas. - ¿Actualizando desde una versión anterior donde los asistentes usaban el campo de Instrucciones? Ya no se utilizan Instrucciones. Muévelas a reglas y directrices de respuesta antes de actualizar (Guardrails, guidelines and scenarios). - Todo lo demás funciona igual que en la nube. Continúa con Agregar conocimiento: documentos. Solución de problemas | Síntoma | Causa probable | Qué hacer | | ------------------------------ | ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | No aparece Captain en la barra lateral | No está activado para la cuenta, o no hay una licencia Premium o Enterprise | Verifica ambos pasos; revisa tu licencia | | No hay Herramientas | Herramientas Personalizadas está desactivado para la cuenta | Actívalas en Super Admin > Cuentas | | El asistente no responde | Clave de OpenAI inválida o inactiva, o un nombre de modelo no compatible | Verifica la clave. Revisa que tu endpoint sirva el modelo del asistente (gpt-5.2 por defecto, o el configurado en la pestaña Modelos de Captain de la cuenta). | | Faltan páginas en documentos web | No hay clave de Firecrawl, por lo que se usa el rastreador simple | Agrega una clave API de FireCrawl | | Los documentos web no se sincronizan | Clave API de Firecrawl inválida | Verifica que la clave API de Firecrawl sea válida. Si hay clave, Chatwoot siempre usa Firecrawl, así que una clave inválida hace que fallen los documentos web. Elimina la clave para usar el rastreador incorporado. | | Sigue fallando | Un error en el servidor | Consulta los registros web y de los workers |

Créditos y uso de Captain AI

Descubrir Captain utiliza créditos de IA. Cada plan de pago incluye créditos gratuitos cada mes, y puedes comprar más. Plan y acceso: Startups, Business o Enterprise. Cuántos créditos incluye cada plan, y el precio para recargar, están en Precios y Planes > Créditos de Captain AI. Los administradores ven el uso y pueden comprar créditos en Facturación. Configura y prueba Qué usa créditos Cada uno de estos usa un crédito: - Una respuesta del asistente a un cliente. - Un mensaje en el Playground del asistente. - Una solicitud de Copilot. - Una acción del editor, como reformular, resumir o sugerir respuesta. - Una transcripción de audio. Agregar documentos, aprobar preguntas frecuentes, sugerencias de etiquetas y prioridades desde Sugerir con Captain, y condiciones de Captain en reglas de automatización no usan créditos. Ver tu uso 1. Ve a Configuración > Facturación. 2. La sección de Captain muestra los Créditos y Documentos usados. Haz clic en Actualizar para actualizar. Comprar más créditos 1. En Facturación > Captain, haz clic en Comprar más créditos. 2. Elige un paquete y haz clic en Comprar Créditos, luego confirma. Tu tarjeta guardada se cobra de inmediato. Créditos comprados: - Se agregan de inmediato y se usan después de los créditos mensuales de tu plan. - Expiran después de 6 meses. - Requieren una suscripción activa para ser usados. - No son reembolsables. Pruébalo Después de comprar, verifica el nuevo saldo en Facturación > Captain. Obtén valor - Los créditos mensuales se reinician en la fecha de renovación de tu plan. Comprar créditos o cambiar de plan no reinicia el uso. - Los créditos mensuales no utilizados no se acumulan. Si usas más créditos de los mensuales, el extra se descuenta de los créditos comprados. - Cuando cambias de plan, tu saldo sube o baja según la diferencia entre los créditos mensuales de ambos planes. Tu uso se mantiene igual. - Cambiar el número de asientos no reinicia el uso. - Para que los créditos duren más: conecta el asistente solo a los buzones donde ayuda, usa las reglas de audiencia y programación (Controla a quién y cuándo responde Captain), y desactiva funciones de IA que no uses, como la transcripción. - Una barra de aviso te alertará cuando hayas usado más del 80% de tus créditos. No hay alerta por correo electrónico, y los créditos no se recargan automáticamente. - El uso es un total único para la cuenta. No se divide por agente, asistente o función. Para ver cómo rinde cada asistente, usa su Resumen (Resumen y reportes de Captain). Solución de problemas | Síntoma | Causa probable | Qué hacer | | --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- | ----------------------------------------------------------------- | | Las nuevas conversaciones van directo al equipo sin respuesta del asistente | Créditos agotados | Compra créditos o espera la renovación | | El asistente dice "Transfiriendo a otro agente para mayor asistencia." a mitad de charla| Créditos agotados durante la conversación | Compra créditos o espera la renovación | | Copilot indica que no tienes créditos de Copilot | Créditos agotados | Compra créditos o espera la renovación | | El uso no se puso a 0 después de comprar | Previsto. El uso solo se reinicia en la renovación; la compra suma saldo | Ninguna | | Los créditos se usan más rápido de lo esperado | El asistente está en buzones ocupados, o se usan mucho las funciones de IA | Limita la audiencia o programación; desactiva funciones no usadas | | No puedes comprar créditos | No eres administrador, o no hay suscripción activa | Consulta a un administrador; revisa la suscripción | Más causas: Solución de problemas de Captain.

Actualización de robots.txt para permitir que el Asistente de Chatwoot rastree su sitio web

Chatwoot utiliza Firecrawl internamente para obtener e indexar el contenido de tu sitio web. Esto permite que el Asistente de Chatwoot responda preguntas utilizando la información de tu sitio. Sin embargo, si el robots.txt de tu sitio web tiene reglas Disallow, Firecrawl las respetará y no rastreará esas páginas. Cuando eso ocurre: - No se agregarán documentos de tu sitio web a Chatwoot - El Asistente no recibirá ningún contexto adicional - Las respuestas pueden volverse incompletas o genéricas Para asegurar que el Asistente funcione correctamente, debes permitir que Firecrawl rastree tu sitio web. Paso 1: Verifica tu robots.txt Visita: https://yourdomain.com/robots.txt Busca cualquier entrada Disallow: que pueda bloquear agentes de usuario. Paso 2: Añade una regla Allow para Firecrawl Pide a tu administrador o desarrollador web que agregue las siguientes líneas al archivo robots.txt: User-agent: FirecrawlAgent Allow: / Esto le indica a Firecrawl que tiene permitido rastrear todo tu sitio, incluso si otros bots están restringidos. Paso 3: Guarda y publica Después de actualizar el robots.txt, asegúrate de que el archivo esté implementado y sea accesible públicamente. Puedes verificarlo visitando: https://yourdomain.com/robots.txt y comprobando que las nuevas reglas aparecen.

El capitán decide resolver automáticamente o delegar las conversaciones.

Cuando Captain gestiona una conversación con un cliente, no permanece en estado de "pendiente" para siempre. Después de un período de inactividad, Captain evalúa la conversación y decide uno de dos resultados: resolverla (si las necesidades del cliente fueron satisfechas) o transferirla a un agente humano (si aún queda algo sin resolver). Este artículo explica cómo funciona esa decisión y qué puedes esperar. El flujo de auto-resolución Esto es lo que sucede después de que Captain responde a un cliente: 1. La conversación permanece con el estado Pendiente mientras Captain la gestiona. 2. Si no hay nueva actividad durante 1 hora, Captain evalúa la conversación. 3. Según la evaluación, Captain: - Resuelve la conversación — envía un mensaje de resolución y la cierra. - Transfiere a un agente humano — reabre la conversación para que tu equipo pueda atenderla. En ambos casos, Captain añade una nota privada explicando por qué tomó la decisión. Cómo evalúa Captain una conversación Captain lee toda la conversación y comprueba si las necesidades del cliente fueron atendidas. La evaluación es intencionadamente conservadora — en caso de duda, Captain mantiene la conversación abierta y la transfiere a un humano. Es mejor que un agente encuentre una conversación que realmente no necesitaba atención, a que un cliente vea su conversación cerrada mientras aún necesita ayuda. Cuándo Captain resuelve Captain resuelve una conversación cuando está seguro de que la pregunta del cliente fue completamente respondida y no queda nada por abordar. El cliente no necesita decir explícitamente "gracias" o confirmar — si Captain dio una respuesta completa y el cliente no hizo ningún seguimiento, eso es suficiente. Por ejemplo, si un cliente pregunta "¿Cuáles son sus horarios de atención?" y Captain responde con los horarios, y el cliente no responde durante una hora — Captain resolverá. La respuesta fue autosuficiente y completa. Captain también resuelve cuando el cliente envió texto sin sentido o palabras sueltas sin alguna pregunta reconocible, y Captain pidió aclaración pero no obtuvo respuesta. Cuándo Captain transfiere Captain transfiere a un humano siempre que exista la posibilidad de que el cliente aún necesite ayuda. Algunos ejemplos comunes: - Captain sugirió al cliente probar algo (como limpiar la caché o actualizar una configuración) — el cliente podría estar aún intentándolo. - Captain indicó al cliente un enlace o recurso externo — podría estar leyéndolo todavía. - El cliente pidió algo que Captain no pudo hacer — incluso si Captain explicó el motivo, la necesidad sigue sin cubrirse. - El cliente planteó varios temas y no todos fueron atendidos. El principio rector: si hay alguna ambigüedad respecto a si el cliente ha terminado, Captain optará por mantener la conversación abierta para tu equipo. Qué ve el cliente Cuando Captain resuelve: El cliente recibe un mensaje de resolución. Puedes personalizar este mensaje en la configuración de tu asistente Captain — si no configuras uno, se usa el mensaje predeterminado. Cuando Captain transfiere: Si has configurado un mensaje de transferencia en la configuración de tu asistente Captain, el cliente verá ese mensaje. El estado de la conversación cambia a Abierto, y tu equipo puede verla en su cola. Si tu equipo se encuentra fuera del horario laboral, el cliente también recibirá automáticamente tu mensaje de fuera de oficina. Preguntas frecuentes ¿La auto-resolución funciona en todos los idiomas? Sí. Captain evalúa las conversaciones según el significado y la intención, independientemente del idioma utilizado. ¿Dónde puedo ver por qué Captain resolvió o transfirió una conversación? Revisa la conversación por una nota privada de Captain. Añade una nota con su razonamiento antes de cada decisión de resolver o transferir. No quiero que Captain auto-resuelva las conversaciones en mi cuenta. Contáctanos con nuestro equipo de soporte y podemos desactivar la auto-resolución en tu cuenta.

Cómo configurar herramientas personalizadas para Captain

Las Herramientas Personalizadas permiten que Captain llame a tus APIs externas durante las conversaciones, para que pueda comprobar el estado del sistema, buscar horarios o recuperar datos de tus propios servicios sin pasar a un agente humano. Cuando un cliente hace una pregunta, Captain extrae los valores relevantes de la conversación, los inserta en tu solicitud API y utiliza la respuesta para formar su contestación. Las Herramientas Personalizadas están disponibles en el plan Business y superiores. Crear una herramienta Navega a Captain -> Tools y haz clic en Crear una nueva herramienta. Completa los siguientes campos: Nombre de la herramienta — Un nombre corto como "Estado del sistema" o "Búsqueda de horarios" (máx. 55 caracteres). Descripción — Indica a Captain cuándo debe usar esta herramienta. Este es el campo más importante. Escríbelo como si estuvieras informando a un agente de soporte: “Comprueba el estado actual del sistema, incluyendo incidentes o mantenimientos en curso.” Descripciones vagas como “API de estado” harán que Captain pierda oportunidades de usar la herramienta. Método — Elige GET (para obtener datos) o POST (para enviar datos). URL del Endpoint — La URL de tu API. Utiliza {{ parameter_name }} para insertar valores extraídos de la conversación: https://api.yourcompany.com/v1/showtimes?q={{ query }} La URL debe usar HTTPS, debe ser un nombre de host (no una dirección IP) y no puede apuntar a localhost o redes privadas. Autenticación — Elige cómo tu API autentica las solicitudes: | Tipo | Lo que proporcionas | |------|---------------------| | Ninguna | Sin autenticación | | Bearer Token | Una cadena de token | | Basic Auth | Nombre de usuario y contraseña | | API Key | Un nombre de encabezado personalizado y valor | Las credenciales de autenticación solo son visibles para los administradores de la cuenta. Parámetros — Define lo que Captain debe extraer del mensaje del cliente. Cada parámetro necesita un nombre, tipo y descripción. Por ejemplo: query (String) — "El título de la película o fecha sobre la que pregunta el cliente." Plantilla de solicitud (solo POST) — Una plantilla JSON usando sintaxis Liquid: { "query": "{{ query }}", "source": "captain" } Plantilla de respuesta — Controla lo que Captain ve de la respuesta de tu API. Si se deja en blanco, Captain recibe el JSON sin procesar. Usa Liquid para extraer campos relevantes: Estado del sistema: {{ response.status }}. {{ response.message }} Utiliza response para acceder al cuerpo JSON analizado. Las plantillas de respuesta ayudan a Captain a centrarse en los datos relevantes y evitan campos internos como IDs de bases de datos o información de depuración. Probar tu herramienta Haz clic en Probar conexión antes de guardar para verificar que tu endpoint es accesible. La prueba informa el código de estado HTTP. Un resultado verde (HTTP 200–299) significa que la conexión y autenticación funcionan. Ten en cuenta que la prueba envía la URL sin completar los valores de los parámetros, por lo que solo verifica que tu endpoint sea accesible y que tus credenciales sean aceptadas. Si la prueba falla, revisa lo siguiente: - 401 No autorizado — Tus credenciales de autenticación son incorrectas. Verifica tu bearer token, API key o nombre de usuario/contraseña. - 403 Prohibido — Tu API está rechazando la solicitud. Si requieres verificación de identidad, ten en cuenta que las solicitudes de prueba no incluyen encabezados de contacto. - 404 No encontrado — La URL del endpoint es incorrecta. Verifica la ruta y asegúrate de que tu API esté en funcionamiento. - Timeout — Tu API tardó demasiado en responder. Las herramientas personalizadas tienen un tiempo de espera de 30 segundos; asegúrate de que tu endpoint responda dentro de ese intervalo. Contexto enviado con cada llamada de herramienta Cuando Captain llama a tu API, incluye encabezados de metadatos para que tu backend sepa el contexto: | Encabezado | Descripción | |--------|-------------| | X-Chatwoot-Account-Id | El ID de tu cuenta | | X-Chatwoot-Conversation-Id | El ID de la conversación | | X-Chatwoot-Contact-Email | El email del cliente (si está disponible) | | X-Chatwoot-Contact-Inbox-Verified | Si la identidad del cliente está verificada por HMAC | Encabezados adicionales incluyen X-Chatwoot-Assistant-Id, X-Chatwoot-Tool-Slug, X-Chatwoot-Contact-Id, X-Chatwoot-Contact-Phone y X-Chatwoot-Conversation-Display-Id. Puedes usar estos encabezados para buscar al cliente en tu propio sistema, registrar qué conversaciones activaron llamadas a la API y verificar la autenticidad de las solicitudes. Seguridad Protecciones integradas: - Todos los endpoints deben usar HTTPS - Las solicitudes a rangos de IP privadas, localhost y dominios .local están bloqueadas - No se siguen redirecciones HTTP - Las respuestas están limitadas a 1 MB - Las credenciales de autenticación solo son visibles para administradores Verificación de identidad: Si tu herramienta devuelve datos específicos del cliente (órdenes, facturación, detalles de cuenta), tu API debe comprobar el encabezado X-Chatwoot-Contact-Inbox-Verified. Sin la verificación HMAC activada en tu bandeja de entrada, un visitante podría establecer cualquier correo electrónico en el widget de chat. Solo devuelve datos sensibles cuando este encabezado sea true. Para herramientas que devuelven datos públicos (horarios, estado del sistema), esta comprobación no es necesaria. Inyección de prompts: Si tu API devuelve contenido generado por el usuario (reseñas, publicaciones en foros), un texto malicioso podría influir en el comportamiento de Captain. Usa plantillas de respuesta para extraer solo campos estructurados y sanitiza el contenido de tu lado de API. Límites | Límite | Valor | |-------|-------| | Máx. de herramientas por cuenta | 15 | | Recomendado | 10 o menos (aparece una advertencia por encima de 10) | | Longitud del nombre de la herramienta | 55 caracteres | | Tamaño de la respuesta | Máx. 1 MB | | Tiempo de espera de la solicitud | 30 segundos | Cuándo usar herramientas personalizadas Las herramientas personalizadas son más adecuadas para búsquedas estructuradas con entradas predecibles: comprobar el estado del sistema, obtener horarios o buscar registros por ID. Si ya tienes una integración dedicada de Chatwoot para tu caso de uso (por ejemplo, Shopify para e-commerce), usa esa en su lugar: las integraciones dedicadas manejan la búsqueda, la coincidencia difusa y la sincronización de datos de manera más fiable que una sola llamada API. Ejemplos Comprobación de estado del sistema Una herramienta sencilla sin parámetros: Captain la llama cuando un cliente pregunta si algo está caído. | Campo | Valor | |-------|-------| | Nombre de la herramienta | Estado del sistema | | Descripción | Comprueba el estado operativo actual del sistema, incluidos incidentes en curso o mantenimientos programados. Usa cuando un cliente reporte problemas o pregunte si el sistema está caído. | | Método | GET | | URL del endpoint | https://status.yourcompany.com/api/v1/status | | Autenticación | Ninguna | | Parámetros | (ninguno) | | Plantilla de respuesta | Estado del sistema: {{ response.status }}. {{ response.message }} | Búsqueda de horarios / cartelera Para negocios con horarios, calendarios o listas de eventos: los clientes preguntan qué está disponible y Captain obtiene el horario actual. | Campo | Valor | |-------|-------| | Nombre de la herramienta | Búsqueda de horarios | | Descripción | Busca los horarios de películas y funciones. Utiliza cuando un cliente pregunta qué películas están en cartelera o cuándo se proyecta una película específica. | | Método | GET | | URL del endpoint | https://api.yourcinema.com/v1/showtimes?q={{ query }} | | Autenticación | Bearer Token | | Parámetros | query (String, obligatorio) — "El título de la película o la fecha de la proyección por la que pregunta el cliente" | | Plantilla de respuesta | {% for show in response.showtimes %}{{ show.title }} — {{ show.date }} a las {{ show.time }}{% endfor %} | Las Herramientas Personalizadas funcionan mejor cuando las entradas son directas y la respuesta de la API es predecible: comprobaciones de estado, búsquedas y otras consultas estructuradas son el caso ideal.

Configura herramientas personalizadas para Captain

Descubrir Las herramientas personalizadas permiten que el asistente llame a tus propios sistemas durante una conversación, por ejemplo para verificar un pedido, una garantía o una reserva, en lugar de transferir la conversación. Plan y acceso: Business o Enterprise ([Enlace: Precios y Planes]). En Startups, Herramientas usualmente muestra Actualizar para usar herramientas con Captain. Cada asistente tiene su propia lista de herramientas. Los administradores crean herramientas, y solo los administradores pueden ver las credenciales guardadas. Autoalojado: el Super Admin activa Herramientas Personalizadas para la cuenta. Configuración y prueba Antes de empezar - Un endpoint HTTPS en un nombre de host público. Chatwoot bloquea HTTP sin cifrar, direcciones IP, localhost, redes privadas y direcciones .local. - El endpoint debe aceptar la conexión en 2 segundos y responder en 20 segundos, con una respuesta de 1 MB o menos. - Sus credenciales, si las necesita. Crear una herramienta 1. Ve a Captain > Herramientas y haz clic en Crear una nueva herramienta. Primero usa el selector de asistentes en la parte superior para elegir el asistente para el que es la herramienta. El formulario se abre en un panel lateral. 2. Completa lo siguiente: - Nombre de la herramienta: corto, por ejemplo "Consulta de pedidos" (55 caracteres o menos). - Descripción: cuándo debe usarla el asistente, escrita como un informe para un agente nuevo. Esto determina si el asistente elige la herramienta. - Método: GET para leer datos; POST, PUT o PATCH para enviar o modificar datos; DELETE para eliminar algo. - URL del endpoint: usa {{ parameter_name }} para valores que el asistente completará, por ejemplo https://api.example.com/orders/{{ order_id }}. - Tipo de autenticación: Ninguno, Bearer Token, Basic Auth o API Key (con Nombre del header y Valor del header). Usa esto para las credenciales. - Headers: haz clic en Agregar header para headers fijos que tu API necesite en cada llamada, como una versión de la API o ID de inquilino (hasta 16). Los valores se envían exactamente como los escribas. Chatwoot establece Authorization, Host, Content-Length, Content-Type y cualquier header que empiece por X-Chatwoot, así que no puedes agregar esos. - Parámetros: haz clic en Agregar parámetro para cada valor que el asistente debe obtener del cliente. Da un nombre, tipo, descripción y marca Obligatorio si es necesario. - Plantilla de cuerpo de la solicitud (Opcional): para POST, PUT o PATCH. Esta y la plantilla de respuesta están en Plantillas. La plantilla de solicitud es un cuerpo JSON. Soporta Liquid, por ejemplo {{ order_id }} para un parámetro. - Plantilla de respuesta (Opcional): selecciona los campos que necesita el asistente, por ejemplo Pedido {{ response.order_id }} estado: {{ response.status }}. Lee la respuesta del API a través de response, por ejemplo {{ response.status }}. Deja la plantilla en blanco para enviar a Captain el JSON crudo. 3. Haz clic en Probar conexión, luego en Crear. Probar conexión solo funciona para endpoints sin plantillas ni cuerpo de solicitud. Para los demás, prueba en el Playground. Un resultado verde significa que tu endpoint devolvió un estado 2xx: es accesible y aceptó las credenciales. Prueba Haz una pregunta en el Playground que requiera la herramienta, por ejemplo "¿Dónde está el pedido 1234?". Verifica que la respuesta use datos reales. Obtén valor - Las herramientas personalizadas funcionan mejor para búsquedas con entradas claras, como un estado de pedido, una reserva o un registro por ID. - Cada asistente puede tener hasta 50 herramientas. Mantén la lista corta igualmente: con muchas herramientas el asistente es más propenso a elegir la equivocada. - Agregar, editar, desactivar o eliminar una herramienta solo la cambia para el asistente que estás viendo. Las herramientas que existían antes de que fueran por asistente fueron copiadas a cada asistente, así que revisa cada uno. - ¿Manejas varios asistentes? Da a cada uno solo las herramientas que necesita. - Desactiva una herramienta con su interruptor en vez de eliminarla. Si un escenario la usa, Chatwoot te advertirá primero. Ver Límites, pautas y escenarios. - Chatwoot envía headers con cada llamada para que tu sistema sepa la cuenta, conversación, correo y teléfono de contacto, asistente y si el contacto está verificado. Para datos privados, revisa el header X-Chatwoot-Contact-Inbox-Verified antes de responder. Sin validación de identidad, un visitante puede escribir cualquier email en el widget. Las herramientas que solo devuelven datos públicos no necesitan esta verificación. Ver [Enlace: Validación de identidad]. - Si tu API devuelve texto escrito por los clientes, devuelve solo los campos estructurados que necesitas. Captain lee la respuesta tal cual, así que texto libre podría contener instrucciones que podría seguir. Solución de problemas | Síntoma | Causa probable | Qué hacer | | ------------------------------------------ | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ | | Conexión fallida | Endpoint inaccesible, no HTTPS o credenciales incorrectas | Verifica la URL y credenciales; asegúrate de que sea HTTPS público | | Conexión fallida con 401 | Las credenciales son incorrectas | Verifica el Tipo de autenticación y las credenciales | | Conexión fallida con 403 | Tu API rechazó la solicitud | Las solicitudes de prueba no llevan headers de contacto, así que un endpoint que los necesita falla la prueba. Prueba en Playground | | Conexión fallida con 404 | Ruta de la URL incorrecta | Verifica la ruta de la URL | | Conexión fallida por timeout | Tu API se demoró más de 20 segundos en responder, o más de 2 segundos en conectar | Acelera el endpoint | | URL rechazada | Dirección IP, localhost o dirección privada | Usa un nombre de host público | | Un header es rechazado | Es un header que Chatwoot establece, está duplicado, o su valor tiene marcadores | Elimínalo, o mueve las credenciales a Tipo de autenticación | | Falta una herramienta en otro asistente | Las herramientas pertenecen a un solo asistente | Cambia a ese asistente y crea la herramienta ahí | | No se puede agregar otra herramienta | El asistente ya tiene 50 herramientas | Elimina las herramientas que no utiliza | | El asistente nunca usa la herramienta | La descripción es vaga | Reescribe la Descripción para decir exactamente cuándo usarla | | El asistente usa la herramienta equivocada | Demasiadas herramientas o descripciones similares | Elimina o desactiva herramientas; haz las descripciones únicas | | Respuesta lenta o sin respuesta, luego transferencia | El endpoint tardó más de 20 segundos o devolvió más de 1 MB | Acelera el endpoint; reduce la respuesta con una Plantilla de Respuesta | Más causas: Solución de problemas de Captain.

Controla a quién responde el Capitán y cuándo.

Descubrir Puedes elegir a qué clientes responde el asistente (Audiencia) y cuándo (Horario). Las conversaciones que el asistente no atiende permanecen Abiertas para tu equipo. Audiencia y Horario pertenecen al asistente, por lo que se aplican a cada bandeja de entrada a la que está conectado. Plan y acceso: Startups, Business o Enterprise : Precios y Planes. Los administradores cambian estos ajustes. Configurar & probar Antes de comenzar - Un asistente conectado a una bandeja de entrada. Ver Crear y conectar un asistente. - Para un horario, el horario laboral activado para esa bandeja, en la propia configuración de la bandeja de entrada. Ver [Enlace: Canales y bandejas de entrada explicados]. - Para reglas de audiencia sobre tus propios datos, los atributos personalizados de contacto que quieras usar. Ver [Enlace: Contactos]. Elegir la audiencia 1. Ve a Captain > Asistentes, abre el asistente y ve a Configuración > Audiencia. 2. Elige: - Todos: el asistente responde en cada conversación en sus bandejas. Esta es la opción predeterminada. - Audiencia específica: el asistente responde solo a los clientes que cumplen tus condiciones. [Captura de pantalla: captain-6-a2-specific.png] 3. Para una audiencia específica, añade condiciones. Cada una tiene un atributo, un operador y un valor. - Atributos de contacto: Nombre, Email, Teléfono, Identificador, País, Ciudad, Empresa, Creado el, Última actividad, Bloqueado, Etiquetas. - Atributos de la conversación: Usuario autenticado, Idioma del navegador. El idioma del navegador proviene solo del widget del sitio web, por lo que no funciona para WhatsApp, Telegram, SMS u otros canales. Etiquetas se refiere a etiquetas del contacto, no etiquetas de la conversación. Usuario autenticado significa que el visitante fue verificado con validación de identidad (HMAC) en tu widget web. - Tus atributos personalizados de contacto. - Los operadores que puedes elegir dependen del atributo. Por ejemplo, Nombre solo ofrece igual y diferente, Email también ofrece contiene (úsalo para filtrar un dominio como @acme.com), y las fechas ofrecen mayor que, menor que y días antes. 4. Elige si los clientes deben cumplir todas las condiciones o cualquiera de ellas. Puedes agrupar condiciones, por ejemplo "El plan es Pro Y (País es EE. UU. O País es Canadá)". Puedes anidar grupos solo un nivel: un grupo puede contener subgrupos, pero un subgrupo no puede contener otro grupo. 5. Guardar. Elegir el horario 1. En la misma Configuración, abre Horario. 2. Elige En cualquier momento (predeterminado), Durante horario laboral o Fuera de horario laboral. 3. Guardar. Ambas reglas deben cumplirse: el asistente responde solo cuando el cliente está en la audiencia y es dentro del horario establecido. Pruébalo 1. Inicia una nueva conversación como un cliente que cumple las condiciones, dentro del horario. El asistente responde. 2. Inicia una como un cliente que no cumple. Va a tu equipo sin respuesta del asistente. Obtener valor - Configuraciones comunes: asistente solo fuera del horario laboral; asistente solo para usuarios autenticados del sitio web; asistente para todos excepto clientes con etiqueta "VIP". - Las reglas se revisan cuando inicia una conversación o se reabre una ya resuelta, no en cada mensaje. Una vez que el asistente está en una conversación permanece hasta que se resuelva o se transfiera. Los cambios se aplican solo a conversaciones nuevas o reabiertas. - La coincidencia de texto no distingue mayúsculas/minúsculas. Los números de teléfono coinciden con o sin el + inicial. Un atributo de casilla nunca marcado cuenta como no marcado. - El horario sigue los horarios comerciales de la bandeja de entrada y su zona horaria. Si la zona horaria es incorrecta, el asistente puede estar inactivo durante la mayor parte del día para tus clientes, sin avisar. - Estas reglas deciden cuándo se une el asistente de forma automática. Un agente aún puede transferir cualquier conversación al asistente desde el desplegable de asignados, lo que ignora audiencia y horario. Ver Crear y conectar un asistente. Solución de problemas | Síntoma | Causa probable | Qué hacer | | ----------------------------------------------------- | --------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | El asistente responde a alguien que excluiste | Los detalles del contacto cambiaron después de iniciar la conversación | Esperado. La regla se aplica a partir de la próxima conversación nueva o reabierta. Abre el contacto y revisa sus atributos en la barra lateral. Captain verifica los valores que tenía al iniciar. | | El asistente está en una conversación que debió saltar| Un agente asignó la conversación al asistente | Esperado. La asignación manual ignora audiencia y horario. | | El horario no tiene efecto | El horario laboral está desactivado para esa bandeja. Bandejas sin horario cuentan como "siempre activo"| Activa el horario laboral en la configuración de la bandeja de entrada. | | Tu atributo no está en la lista | Es un atributo personalizado de conversación. Solo funcionan los personalizados de contacto | Usa un atributo de contacto en su lugar. Créalo en Configuración › Atributos personalizados y elige Contacto. | | No puedes guardar la audiencia | Una condición no tiene valor (marcada en rojo), o la audiencia específica no tiene condiciones | Completa o elimina la condición. Está presente y No está presente (solo para fechas) no necesitan valor. | | El asistente está silencioso para todos | La audiencia u horario los excluye | Revisa ambos ajustes, luego Solucionar problemas de Captain |

Establecer límites, directrices y escenarios del Capitán

Descubrir Tres conjuntos de reglas configuran tu asistente: Límites deciden qué preguntas responde, Directrices de respuesta deciden cómo suenan sus respuestas, y Escenarios le indican qué hacer en situaciones específicas. Planifica y accede: Startups, Business o Enterprise Precios y Planes. Los administradores los editan. Son parte de cada cuenta de Captain, en cualquier plan de pago. | Conjunto de reglas | Úsalo para | Ejemplo | | ---------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | | Límites | Mantener al asistente en tema y alejado de preguntas prohibidas | "No des consejos legales ni médicos." | | Directrices de respuesta | Tono, longitud y estructura de las respuestas | "Mantén las respuestas por debajo de tres oraciones. Sé amigable, no formal." | | Escenarios | Manejo paso a paso de una situación, usando opcionalmente una herramienta personalizada | "Cuando un cliente pida un reembolso, solicita el número de pedido, compruébalo con la herramienta de búsqueda de pedidos, luego transfiere." | Configura y prueba Antes de comenzar - Un asistente. Consulta Crear y conectar un asistente. - Para escenarios que llaman a tus sistemas, una herramienta personalizada. Consulta Herramientas personalizadas. Añadir límites y directrices de respuesta 1. Ve a Captain, abre el asistente y ve a Configuración. 2. Abre Límites o Directrices de respuesta. 3. Haz clic en Añadir un límite o Añadir una directriz de respuesta, escribe la regla como una frase corta y haz clic en Crear. [Captura de pantalla: captain-5-g3-add-guardrail.png] 4. Para añadir reglas desde los ejemplos, escribe en el cuadro debajo de los ejemplos y haz clic en Añadir y guardar (↵), o pulsa Enter. 5. Para cambiar una regla, haz clic en su icono de lápiz, edita el texto y pulsa Enter. Añadir un escenario 1. Ve a Captain, abre el asistente y ve a Escenarios. 2. Haz clic en Añadir un escenario y completa: - Título: un nombre corto, por ejemplo "Solicitud de reembolso". - Descripción: cuándo se aplica este escenario. - Cómo manejarlo: qué debe hacer el asistente, en pasos sencillos. Para usar una herramienta en un paso, escribe @ y elígela de la lista, por ejemplo Transferir a Humano o una de tus herramientas personalizadas. Si el escenario debe terminar con tu equipo, añade la transferencia como último paso. 3. Haz clic en Crear. 4. Para modificar un escenario, ábrelo, edita los campos y haz clic en Actualizar cambios. Prueba En el Playground, haz una pregunta que cada regla deba detectar (por ejemplo, una pregunta fuera de tema y una solicitud de reembolso). Verifica que la respuesta siga la regla. Saca provecho - Comienza con tres a cinco límites y directrices. Añade más cuando observes un problema real en las conversaciones. - Escribe las reglas como instrucciones para un nuevo miembro del equipo, no como palabras clave. - Los límites son instrucciones para la IA, no un filtro. Hacen que las respuestas fuera de tema sean mucho menos probables pero no pueden descartarlas por completo, así que mantén claro el Mensaje de transferencia. - Si una herramienta utilizada en un escenario está deshabilitada, ese escenario puede dejar de funcionar. Chatwoot te avisará antes de que la deshabilites. Solución de problemas | Síntoma | Causa probable | Qué hacer | | --------------------------------------- | ------------------------------------------------------------------------------------------ | ---------------------------------------------------- | | El asistente ignora una regla | La regla es vaga o entra en conflicto con otra | Reescríbela como una frase clara; elimina conflictos | | El escenario nunca se ejecuta | La descripción de la situación no coincide con cómo preguntan los clientes | Describe la situación con palabras de los propios clientes | | El escenario se detiene a medias | Su herramienta personalizada está deshabilitada o falla | Revisa la herramienta en Herramientas | | No aparece Escenarios en el asistente| La cuenta es Hacker (gratuita), o, en autohospedado, Captain no está activado para la cuenta | Actualiza tu plan, o pide a tu Súper Admin que active Captain | Más causas: Solucionar problemas de Captain.

Solucionar problemas, capitán

Descubrir Utiliza esta página cuando Captain esté silencioso, dé respuestas incorrectas o no esté aprendiendo. La mayoría de los problemas provienen de una configuración, no de un fallo. Plan y acceso: Captain necesita Startups, Business o Enterprise Pricing & Plans. La mayoría de las soluciones requieren un administrador. Configuración y prueba: la revisión rápida Cuando el asistente está en silencio, revisa estos puntos en orden: 1. Plan: ¿está Captain en la barra lateral? Si ves Upgrade to use Captain AI, la cuenta está en Hacker (gratis). Captain no está disponible durante la prueba gratuita. 2. Créditos: Settings > Billing > Captain. Sin créditos disponibles, Captain no funciona. 3. Bandeja de entrada: ¿la bandeja de entrada está listada en Inboxes del asistente? 4. Público: ¿está configurado en Specific audience y el cliente coincide? 5. Horario: ¿es During business hours o Outside business hours, y coincide el horario? 6. Temporalidad: las reglas se verifican cuando comienza o se reabre una conversación. Una conversación en curso mantiene su primera decisión. 7. Estado: Captain responde solo cuando una conversación está Pending. Si está Open, Captain permanece silencioso. Eso ocurre cuando un agente respondió, el asistente transfirió la conversación, o una regla de automatización asignó la conversación a alguien. Captain no vuelve a una conversación abierta a menos que se le reasigne al asistente. Pruébalo Inicia una conversación completamente nueva, como un cliente que coincide con el público, dentro del horario, en una bandeja de entrada conectada. Valor: silencio versus fallo - Silencio: ninguna respuesta generalmente significa que una de las verificaciones anteriores detuvo a Captain antes de que comenzara. - Silencio en ciertos momentos del día: el horario sigue el de la bandeja de entrada y su zona horaria. Verifica la zona horaria en la configuración de la bandeja de entrada. - Transferencia: cuando Captain no puede responder, envía tu Handoff message y pasa la conversación a tu equipo. - Sin créditos: una conversación nueva va directamente a tu equipo sin respuesta. En una conversación que ya está atendiendo Captain, envía "Transferring to another agent for further assistance." y la transfiere. Resolución de problemas Respuestas | Síntoma | Causa probable | Qué hacer | | ----------------------------------------------------------------------------- | ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | El asistente nunca responde | Una de las revisiones rápidas | Trabaja en la revisión rápida anterior | | Responde a personas excluidas | Sus datos cambiaron después de iniciar la conversación | Esperado; se aplica desde la siguiente conversación. Consulta Controlar a quién responde Captain y cuándo | | Responde fuera del horario establecido | El horario comercial está desactivado en la bandeja de entrada | Activa el horario comercial en la configuración de la bandeja de entrada | | Respuestas incorrectas o inventadas | Conocimiento faltante o desactualizado | Agrega o actualiza documentos; aprueba sugerencias de FAQ. Usa Report Captain message en la respuesta para decirle a Chatwoot qué salió mal | | El asistente está en una conversación que el público u horario debería omitir | Un agente lo asignó al asistente desde el listado de asignados | Esperado. Asigna la conversación a una persona para recuperarla | | Responde preguntas fuera de tema | Sin limitaciones | Agrega limitaciones. Consulta Guardrails, guidelines and scenarios | | Transfiere demasiado seguido | Falta de conocimiento, o una herramienta personalizada falla | Revisa sugerencias de FAQ; revisa Tools | | Las conversaciones se resuelven muy pronto | Always resolve está seteado con una espera corta | Elige Let Captain review it (recommended) o una espera más larga | Conocimiento | Síntoma | Causa probable | Qué hacer | | ------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | El documento muestra Failed to sync | La página requiere inicio de sesión, o tu sitio bloqueó la solicitud (error 401 o 403). Puede que la página también esté ausente o sea lenta. | Consulta Añadir conocimiento: documentos | | Agregaste una página web pero no aparecen páginas, o respuestas genéricas | Puede que tu robots.txt bloquee el rastreador. | Permite el rastreador en tu robots.txt y agrega el documento de nuevo. Consulta Añadir conocimiento: documentos | | No hay sugerencias de FAQ | Generate FAQs from resolved conversations está desactivado. O ningún agente respondió en las conversaciones resueltas. Se necesita al menos una respuesta de agente. | Actívalo. Consulta FAQs y sugerencias de FAQ | | Límite de documentos alcanzado | La cuenta tiene 2,000 documentos entre todos sus asistentes | Elimina documentos no usados; consulta Pricing & Plans | Herramientas, Copilot y créditos | Síntoma | Causa probable | Qué hacer | | ---------------------- | ------------------------------------------- | ------------------------------------------------------------------------------------------------------ | | Herramienta personalizada nunca usada | Descripción poco clara o demasiadas herramientas | Consulta Herramientas personalizadas | | Mensaje de error de Copilot | Error temporal o sin créditos | Intenta de nuevo; revisa los créditos | | Créditos se usan rápido | Bandejas de entrada ocupadas o mucho uso de IA | Consulta Créditos y uso de IA | Cuándo contactar al soporte Contacta al soporte si la revisión rápida pasa y Captain sigue silencioso en una conversación nueva. Envía: - Tu ID de cuenta (Settings > Account settings). - El nombre del asistente y la bandeja de entrada. - Un enlace a una conversación afectada y la hora en que ocurrió. - Si el asistente respondió en el Playground.

Resumen y reportes del capitán

Back to Captain in Chatwoot. Descubrir Cada asistente tiene una Descripción general que muestra cómo está funcionando: cuántas conversaciones manejó, cuántas resolvió por sí mismo, por qué transfirió la conversación, y cómo lo calificaron los clientes. Plan y acceso: Startups, Business o Enterprise Precios y Planes. Cualquiera que pueda abrir Captain ve la Descripción general. Solo los administradores pueden hacer clic en un número para ver las conversaciones detrás de este. Configura y prueba Antes de comenzar - Un asistente conectado a una bandeja de entrada que haya gestionado algunas conversaciones. Consulta Crear y conectar un asistente. Hasta que se conecte una bandeja de entrada, la Descripción general muestra "Este asistente aún no está conectado a ninguna bandeja de entrada, por lo que no responderá a conversaciones." Abre la Descripción general 1. Ve a Captain y elige el asistente en el selector de asistentes. 2. Abre Descripción general. 3. Elige el periodo en la parte superior: un número de días, Esta semana, Semana pasada, Este mes o Mes pasado. El valor predeterminado es Este mes. [Screenshot: captain-13-o1-overview.png] Qué significa cada número | Número | Qué significa | | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | | Conversaciones gestionadas | Conversaciones donde Captain respondió al cliente o transfirió la conversación a tu equipo | | Tasa de resolución automática | El porcentaje de conversaciones gestionadas que Captain resolvió sin ayuda de tu equipo. Más alto es mejor | | Tasa de transferencia | El porcentaje de conversaciones gestionadas que Captain transfirió a tu equipo | | Tasa de reapertura | El porcentaje de conversaciones resueltas por Captain a las que los clientes regresaron después. Más bajo es mejor | | Resoluciones de Captain que siguieron cerradas | El porcentaje de conversaciones resueltas por Captain que siguen cerradas siete días después. Solo se cuentan las de al menos siete días de antigüedad | | Mediana del tiempo de resolución | El tiempo típico desde que una conversación llegó a Captain hasta que fue resuelta | | Mensajes por conversación | El número promedio de respuestas que Captain envió en cada conversación que gestionó | | Ahorrado en esfuerzo y tiempo de agente | Una estimación, basada en dos minutos ahorrados por cada respuesta pública de Captain | Las otras tarjetas - Resumen de Captain: un breve resumen escrito de cómo está funcionando el asistente. Aparece una vez que hay suficiente actividad. - El diagrama de flujo: cómo se dividen las conversaciones gestionadas en Resueltas por Captain, Transferidas y Cerradas con el equipo, y cuántas resoluciones de Captain fueron Reabiertas en 7d o Permanecieron cerradas. - Motivos de transferencia: por qué Captain transfirió conversaciones a tu equipo: Solicitado por el cliente, Falta de conocimiento, Solicitud no compatible, Restricción de política, Fallo de herramienta, Aclaración pendiente del cliente, Límite de uso o No clasificado. [Screenshot: captain-13-o2-flow.png] - Tendencia de resoluciones: conversaciones gestionadas y resueltas por Captain durante el periodo, comparado con el periodo anterior en los mismos días de la semana. - CSAT de Captain: la calificación promedio de los clientes para conversaciones resueltas por Captain y conversaciones asistidas por Captain, comparadas con las conversaciones gestionadas solo por tu equipo. - Cobertura de conocimiento: FAQs aprobadas frente a FAQs sugeridas pendientes de revisión. Haz clic en Revisar FAQs para ir a la cola. - Uso: Créditos y Documentos usados en la cuenta. Haz clic en Actualizar uso para actualizar, o en Comprar más créditos. Ver las conversaciones detrás de un número Los administradores pueden hacer clic en un número, o un motivo de transferencia, para ver las conversaciones detrás de este. Haz clic en Cargar más para ver más. [Screenshot: captain-13-o3-drilldown.png] La lista cuenta "episodios". Una conversación puede aparecer más de una vez si Captain la gestionó en momentos diferentes, por ejemplo, después de que fue reabierta. Pruébalo Elige Este mes, haz clic en Tasa de transferencia y abre algunas conversaciones. Verifica que los motivos de transferencia coincidan con lo que ocurrió. Aprovecha Usa los motivos de transferencia para decidir qué solucionar primero: | Si esto es alto | Prueba esto | | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Falta de conocimiento | Agrega documentos y aprueba sugerencias de FAQ. Consulta Agregar conocimiento: documentos y FAQs y sugerencias de FAQ | | Fallo de herramienta | Revisa tus herramientas. Consulta Herramientas personalizadas | | Restricción de política o Solicitud no compatible | Revisa que tus reglas y escenarios no sean demasiado estrictos. Consulta Reglas, directrices y escenarios | | Límite de uso | La cuenta se quedó sin créditos. Consulta Créditos de IA y uso | | Solicitado por el cliente | Suele ser esperado. Si es muy alto, revisa las respuestas del asistente en el Playground | - Si la Tasa de reapertura sube, es posible que las respuestas parezcan correctas pero no resuelvan el problema. Lee algunas conversaciones reabiertas. - Ahorrado en esfuerzo y tiempo de agente es una estimación, no una medición. - Para reportes en todos los bots de la cuenta. Solucionar problemas | Síntoma | Causa probable | Qué hacer | | ---------------------------------------------------- | ---------------------------------------------------------------------- | ------------------------------------------- | | "No hay datos disponibles para este periodo." | No hay bandeja de entrada conectada, o Captain no gestionó conversaciones en ese periodo | Conecta una bandeja de entrada, o elige otro periodo | | Un periodo muestra "No hay suficiente historial de reportes aún" | El asistente no tiene datos de hace tanto tiempo | Elige un periodo más corto | | Resoluciones de Captain que siguieron cerradas no tiene valor | No hay ninguna resolución en el periodo que tenga al menos siete días de antigüedad | Esperado. Vuelve a revisar más tarde | | Hacer clic en un número no hace nada | No eres administrador | Pide ayuda a un administrador | | Una conversación aparece dos veces en una lista | Captain la gestionó en dos episodios diferentes | Esperado | | Los números de uso parecen antiguos | La tarjeta no se ha actualizado | Haz clic en Actualizar uso | Más causas: Solucionar problemas de Captain.