ChatKit

Cómo empezar con ChatKit

Lo que necesitas Antes de empezar, asegúrate de tener: - Una instancia de Chatwoot (propia o en la nube) y tus credenciales - Tu token de API de Chatwoot (Ajustes → Cuenta → Access Token) - Un inbox de Chatwoot ya creado para el canal que quieres automatizar (Website, WhatsApp, Telegram, Facebook) Paso 1 — Conecta ChatKit a Chatwoot 1. Inicia sesión en el constructor de ChatKit. 2. Abre Ajustes. 3. Ingresa tu URL base de Chatwoot, Token de API e ID de cuenta. 4. Haz clic en Guardar — ChatKit importa tus inboxes automáticamente. Paso 2 — Crea la configuración de tu primer inbox 1. Ve a Inboxes — tus inboxes de Chatwoot aparecen listados aquí. 2. Elige uno y ábrelo. 3. Ponle un nombre y confirma el Tipo de canal (website, WhatsApp o Telegram). Paso 3 — Construye tu primer menú 1. Haz clic en + Agregar elemento del menú (o + Agregar raíz en la vista de flujo). 2. Escribe la etiqueta de la opción (p. ej. Horarios, Precios, Soporte). 3. Define qué pasa al seleccionarla: una respuesta de Texto, tarjeta de Artículo, Select de entrada, Formulario o Submenú. 4. Usa la vista de flujo para anidar elementos (arrastra el punto inferior de un nodo sobre el punto superior de otro) y ordena la cadena principal. 5. Observa la Vista previa del chat a la derecha — se actualiza en vivo mientras construyes. Paso 4 — Ponlo en marcha 1. Asigna un AgentBot en Ajustes → General → Asignación de AgentBot para que Chatwoot enrute los webhooks a ChatKit. 2. Activa el inbox con el interruptor Activo. 3. Abre el widget web de Chatwoot y prueba: escribe una palabra clave, recorre el menú, envía un formulario. Siguientes pasos - Lee los artículos de Funciones para activar la captura de leads, los seguimientos y el contexto de transferencia. - Revisa Cómo recibir notificaciones de nuevos leads para que tu equipo reciba las menciones.

Descripción general de las funciones de ChatKit

Constructor visual de menús ChatKit es un constructor de bots de arrastrar y soltar para Chatwoot. Crea menús, submenús, respuestas de texto, tarjetas de artículos, selects de entrada y formularios de varios pasos — todo con una vista previa de chat en vivo. - Vista de lista — filas simples con controles de mover/reordenar detrás del menú ⋯ - Vista de flujo — nodos y conexiones; arrastra el punto inferior de un nodo sobre el punto superior de otro para anidarlo, los puntos laterales ordenan la cadena principal Captura de leads (integrada) Cada envío de formulario se convierte en un lead — sin necesidad de CRM externo: - Enriquecimiento de contacto — email, teléfono, nombre y campos personalizados se mapean al contacto de Chatwoot - Etiquetado por intención — las conversaciones se etiquetan con la ruta del menú (Soporte, Reembolso, ...) - Alertas al equipo — una nota privada con mención al equipo notifica a los agentes dentro de Chatwoot Configura todo esto en Ajustes → Leads y Alertas del inbox. Recordatorios de seguimiento Vuelve a enganchar conversaciones inactivas automáticamente: define un retraso y un mensaje de seguimiento, y el bot les recuerda a los usuarios que no han respondido. Transferencia a agente con contexto Cuando un usuario pide un agente (o escribe una palabra clave de transferencia), el bot: 1. Responde con tu mensaje de transferencia 2. Deja una nota privada con la ruta de intención + las respuestas del formulario 3. Marca la conversación para que el agente vea bot_handed_off Multicanal Un solo flujo funciona en Website, WhatsApp, Telegram y Facebook — cada conversación vive en tu inbox de Chatwoot. Autogestión Sin necesidad de código: actualiza menús, formularios, palabras clave y mensajes desde el constructor cuando quieras. Nosotros desplegamos, hospedamos y damos soporte.

Flujos de menú y formularios

Elementos del menú y qué pueden hacer Cada elemento del menú tiene un tipo que controla qué pasa cuando el usuario lo selecciona: - Texto — responde con un mensaje - Artículo — muestra tarjetas de artículo con título, descripción y enlace - Select de entrada — muestra opciones numeradas que el usuario puede elegir - Formulario — recoge campos (texto, email, número, área de texto, select) en una sola pantalla - Formulario secuencial — recoge campos una pregunta a la vez - Tarjetas — tarjetas enriquecidas con media, título, descripción y botones - Submenú — anida más elementos debajo Construye un menú 1. Abre un inbox y haz clic en + Agregar elemento del menú. 2. Ingresa la etiqueta (lo que ve el usuario) y define su tipo. 3. Para un Submenú, agrega elementos hijos — con el botón ＋ del nodo en la vista de flujo, o anidando en el editor de menú. 4. Reordena la cadena principal con los puntos laterales (vista de flujo) o el menú ⋯ (vista de lista). Formularios que capturan leads Los formularios alimentan directamente las funciones de Leads y Alertas: las respuestas enriquecen el contacto, etiquetan la conversación por intención y activan la alerta al equipo. Los tipos de campo incluyen: - Texto — texto libre - Email — formato validado - Número — número validado - Área de texto — respuestas más largas - Select — opciones predefinidas Palabras clave de navegación Los usuarios también pueden escribir atrás / inicio (configurables) o el nombre del elemento para navegar — ideal para canales de chat sin botones.

Captura de leads y alertas al equipo

Cómo funciona Cuando un visitante completa un formulario en tu flujo de bot, ChatKit automáticamente: 1. Enriquece el contacto — las respuestas se mapean al contacto de Chatwoot: email, teléfono, nombre, más atributos personalizados (bot_<campo>) para que puedas segmentar y buscar. 2. Etiqueta la conversación por intención — la etiqueta viene del último segmento de la ruta del menú (p. ej. Soporte, Reembolso, Reservación). 3. Alerta a tu equipo — se publica una nota privada en la conversación con las respuestas; si se define un Equipo a mencionar, ese equipo recibe una notificación de Chatwoot. Configúralo Abre el inbox → Ajustes → Leads y Alertas: | Ajuste | Qué hace | |---|---| | Enriquecer contacto al enviar formulario | Mapea las respuestas al contacto de Chatwoot (activado por defecto) | | Etiquetar conversaciones por intención | Agrega la etiqueta de la ruta del menú a la conversación (activado por defecto) | | Contexto de transferencia para agentes | Nota privada con intención + respuestas al transferir (activado por defecto) | | Notificar agentes sobre nuevos leads | Publica la nota de alerta 🔔 al enviar el formulario (activado por defecto) | | Equipo a mencionar | Nombre exacto del equipo de Chatwoot a mencionar en la alerta — los miembros reciben la notificación | | Mensaje de alerta | Texto personalizado para la nota de alerta | Las menciones de equipo necesitan notificaciones activadas Para que los agentes reciban la mención, deben activar las notificaciones push en su perfil de Chatwoot. Consulta el artículo Cómo recibir notificaciones de nuevos leads.

Recordatorios de seguimiento

Qué hace Si un usuario deja de responder a mitad de la conversación, ChatKit puede enviarle un mensaje de seguimiento después de un retraso — hasta un número configurable de recordatorios — para traerlo de vuelta. Configúralo Abre el inbox → Ajustes → Seguimiento: - Retraso (segundos) — cuánto esperar tras el último mensaje del usuario antes del primer recordatorio (por defecto 120) - Máximo de recordatorios — cuántos seguimientos enviar antes de rendirse (por defecto 1) - Mensaje de seguimiento — el texto a enviar; déjalo vacío para desactivar los seguimientos por completo Buenas prácticas - Mantén el mensaje corto y útil: "¿Sigues ahí? ¿Cómo puedo ayudarte?" - Usa un retraso acorde a tu audiencia (120s es ideal para chat en vivo; más largo para WhatsApp) - No pongas demasiados recordatorios — uno o dos suele ser suficiente para no molestar a los usuarios

Transferencia a agente con contexto

Disparadores La transferencia ocurre cuando el usuario: - Escribe una de las palabras clave de solicitud de agente (por defecto: agente, humano — configurables por inbox) - Selecciona un elemento del menú que lleva a una transferencia Qué pasa al transferir 1. El bot responde con el mensaje de transferencia configurado. 2. Se agrega una nota privada a la conversación con: - La ruta de intención (🧭 p. ej. Explorar Menú → Soporte) - Las respuestas del formulario recopiladas hasta el momento 3. La conversación se marca con bot_handed_off y su estado pasa a Abierta, para que aparezca en la cola de agentes. Para tus agentes La nota es privada — solo tu equipo la ve. Es visible en la vista de conversación cuando la abren, así que saben inmediatamente qué estaba haciendo el cliente y qué datos ya se recopilaron. Nada de preguntar el número de pedido dos veces. Configuración - Palabras clave de solicitud de agente — Ajustes → Mensajes - Mensaje de transferencia — Ajustes → Mensajes - Contexto de transferencia — Ajustes → Leads y Alertas

Gestionar tus inboxes

Los inboxes se importan de Chatwoot ChatKit lee tus inboxes de Chatwoot automáticamente — no hay nada que crear primero en ChatKit. Cada inbox tiene su propia configuración de bot (menú, mensajes, ajustes de leads). Crea una configuración de inbox nueva 1. Inboxes → Actualizar — tus inboxes de Chatwoot aparecen. 2. Abre uno y configúralo: menú, mensajes, seguimientos y Leads y Alertas. 3. Asigna un AgentBot en Ajustes → General para que Chatwoot enrute los webhooks a ChatKit. 4. Activa Activo para ponerlo en marcha. Organiza tu menú - Vista de lista — cada fila tiene un menú ⋯: mover arriba/abajo, desvincular (hacer raíz), mover bajo otro elemento, editar, eliminar - Vista de flujo — arrastra los puntos para anidar/reordenar; pasa el cursor sobre un nodo para ＋ (agregar subelemento), ⤓ (desvincular), ✕ (eliminar) Guardado automático Los cambios en tu menú y ajustes se guardan automáticamente un par de segundos después de hacerlos — incluidos los cambios de anidación. El botón Guardar fuerza un guardado inmediato. Eliminar Al eliminar un elemento, sus hijos se separan automáticamente (se vuelven raíz) y se limpian las referencias obsoletas, así tu flujo nunca queda en un estado roto.

Cómo recibir notificaciones de nuevos leads — activa las notificaciones push

Por qué importan las notificaciones Las alertas de leads y las menciones de equipo de ChatKit notifican a tus agentes dentro de Chatwoot — pero solo si las notificaciones están activadas en el perfil de cada agente. Esta guía asegura que nunca te pierdas un lead. Activa las notificaciones push (por agente) 1. Inicia sesión en Chatwoot como el agente. 2. Haz clic en tu avatar (arriba a la derecha) → Ajustes del perfil. 3. Abre la pestaña Notificaciones. 4. En Notificaciones push, haz clic en Activar notificaciones push y acepta la solicitud del navegador. 5. Marca los eventos que quieres recibir — especialmente @menciones y Asignación de conversación. 6. Configura el Sonido de notificación y las preferencias de Email a tu gusto. Listo — tu navegador/escritorio te alertará en el momento en que un lead envíe un formulario y ChatKit publique la mención. Cómo funcionan las alertas de leads de ChatKit Cuando un visitante completa un formulario en un flujo de bot de ChatKit: 1. ChatKit publica una nota privada en la conversación con las respuestas recopiladas. 2. Si el inbox tiene un Equipo a mencionar configurado (Ajustes → Leads y Alertas), la nota incluye una mención de equipo — cada miembro de ese equipo recibe una notificación de Chatwoot. 3. La conversación también se etiqueta con la intención (p. ej. Soporte, Reembolso) y el contacto se enriquece con los datos del formulario. Solución de problemas - No recibo notificaciones de menciones — confirma que las notificaciones push estén activadas en tu perfil (arriba) y que seas miembro del equipo mencionado. - La mención se ve como texto plano — asegúrate de que el nombre del equipo en Ajustes → Leads y Alertas → Equipo a mencionar coincida exactamente con el nombre del equipo en Chatwoot. - No llega ninguna alerta — revisa que el interruptor Notificar agentes sobre nuevos leads del inbox esté activado.