Chatwoot CLICódigo abierto

Chatwoot CLI pone a tus agentes de código a trabajar en soporte.

La CLI oficial permite que los agentes de código lean conversaciones, busquen en tu centro de ayuda y preparen trabajo de soporte desde la terminal. La skill de agente incluida hace que retengan todo lo visible para el cliente hasta que lo apruebes.

Ver en GitHub Lee la documentación de la CLI

Código abierto · Chatwoot Cloud y autoalojado

support-agent — chatwoot

agent Resume las conversaciones urgentes. Solo lectura, no cambies nada.

● Cargando la skill de Chatwoot CLI y revisando la cola.

$ chatwoot convs --assignee all -s open -o json

{

"data": { "payload": [

{ "id": 8421, "priority": "urgent",

"status": "open", "inbox_id": 7 },

{ "id": 8398, "priority": "high",

"status": "open", "inbox_id": 3 }

] }

}

Cola leída

2 conversaciones necesitan atención

Cambios realizados

Ninguno

Resumen listo.

Una interfaz, trabajo de soporte real

Lo que tu agente de IA puede hacer en Chatwoot

La CLI devuelve datos estructurados sobre los que tu agente puede razonar. Cuando el siguiente paso sea responder, asignar, etiquetar o resolver, la skill oficial hace que tu agente te muestre primero el comando exacto.

Resumen de la cola

Empieza el día con un resumen de soporte útil.

Solo lectura
Dale un prompt a tu agente

Resume las conversaciones abiertas asignadas a mí. Agrúpalas por urgencia y no cambies nada en Chatwoot.

Comando
$ chatwoot convs --assignee me -s open -o json

Salida estructurada → resumen del agente

Cola abierta: 12 conversaciones
Urgentes: 2 · Altas: 3 · Estándar: 7

#8421 — reembolso bloqueado tras un cargo duplicado
#8398 — configuración de SSO enterprise esperando 18h

No se hizo ningún cambio.

Triaje

Encuentra las conversaciones que necesitan a un humano ahora.

Solo lectura
Dale un prompt a tu agente

Encuentra todas las conversaciones urgentes abiertas en todas las bandejas. Devuelve los IDs y el último mensaje de cada cliente. Solo lectura.

Comando
$ chatwoot convs --assignee all -s open -o json | jq '.data.payload[] | select(.priority == "urgent")'

JSON filtrado

{
  "id": 8421,
  "priority": "urgent",
  "status": "open",
  "inbox_id": 7
}

Consulta de conocimiento

Fundamenta una respuesta en contenido de ayuda publicado.

Solo lectura
Dale un prompt a tu agente

Busca en nuestro centro de ayuda artículos sobre cómo cambiar el email de facturación. Dame la mejor coincidencia y cita su enlace público.

Comando
$ chatwoot hc articles --query "billing email" -o json

Resultado de búsqueda del centro de ayuda

{
  "title": "Actualiza tus datos de facturación",
  "slug": "update-billing-details",
  "category": "Configuración de la cuenta",
  "link": "https://support.example.com/..."
}

Acción privilegiada

Redacta primero. Envía solo cuando apruebes.

Requiere aprobación
Dale un prompt a tu agente

Lee la conversación 8421 y redacta una respuesta concisa. Muéstrame el comando exacto de la respuesta, pero no lo ejecutes hasta que lo apruebe.

Comando
$ chatwoot conv 8421 reply "Encontré el cargo duplicado y pedí a nuestro equipo de facturación que lo revierta. Te actualizo por aquí dentro de un día hábil."

Punto de aprobación

Respuesta visible para el cliente preparada.
Comando no ejecutado.

Esperando aprobación explícita para la conversación #8421.

Chatwoot para agentes de código

La Chatwoot CLI: una interfaz de verdad para la cola de soporte.

Un agente de código es útil cuando puede obtener contexto fiable y mostrar su trabajo. Chatwoot CLI le da ambas cosas. En lugar de hacer clic por el panel o raspar tablas de la terminal, el agente puede solicitar conversaciones de la mesa de soporte, contactos del CRM, bandejas, etiquetas, equipos y artículos del centro de ayuda en un formato predecible.

Junto con la CLI, Chatwoot también ofrece Captain, el copiloto de IA dentro del producto, y los Agent Bots, que te permiten conectar bots personalizados a tus bandejas. La CLI es para el agente de código que ya trabaja contigo en una terminal: Codex, Claude, Cursor, Grok u otra herramienta que pueda ejecutar comandos de shell.

01

Haz triaje sin saltar entre pestañas

Pide la cola abierta, una sola conversación o cada mensaje que mencione un reembolso. El agente puede resumir lo que encuentra, agrupar problemas relacionados y señalarte las conversaciones que vale la pena abrir en Chatwoot.

convsconv <id>messagescontactsinboxes
02

Usa respuestas publicadas

Busca en tu centro de ayuda de Chatwoot antes de redactar una respuesta. La CLI puede listar portales, buscar artículos por consulta o categoría y traer el artículo completo que tu agente debería usar como contexto.

hcshc articles --queryhc article <slug>
03

Devuelve datos en los que un agente puede confiar

La salida de texto está pensada para personas. Los agentes pueden pedir JSON para parsear, CSV para una exportación o el modo silencioso cuando un pipeline solo necesita IDs de recursos. Los códigos de salida y los errores se comportan como en cualquier herramienta de línea de comandos.

-o json-o csv-qsalida distinta de cero ante errores
04

Cubre los casos poco comunes

Los trabajos de soporte habituales tienen comandos de primera clase. Cuando la CLI aún no cubre un endpoint, el comando de API en crudo puede hacer una petición autenticada contra la cuenta de Chatwoot configurada. Las llamadas que no son GET siguen requiriendo aprobación.

chatwoot api /conversations/123-X PATCH--data
IA en Chatwoot

Tres formas de poner la IA a trabajar

Captain

El copiloto de IA dentro de Chatwoot. Responde a los clientes directamente desde tu contenido de ayuda.

Agent Bots

Conecta tu propio bot a cualquier bandeja mediante webhooks y la API de Agent Bots.

Chatwoot CLI

Estás aquí

Agentes de código en tu terminal, que leen la cola y preparan el trabajo que tú apruebas.

Cómo funciona

Configura la Chatwoot CLI en cuatro pasos.

La skill oficial de agente enseña a tu agente de código la gramática de la CLI, el contrato de salida estructurada y la regla de que las escrituras sobre estado compartido esperan tu confirmación explícita.

  1. 01

    Instala la CLI

    El instalador detecta tu sistema operativo y arquitectura, descarga el binario correspondiente y verifica su checksum SHA256.

    curl -fsSL https://chwt.app/install-cli | sh
  2. 02

    Autentícate

    Introduce tu URL base de Chatwoot, tu API key y tu ID de cuenta. La CLI los valida antes de guardarlos; la API key va al llavero de tu sistema operativo.

    chatwoot auth login
  3. 03

    Añade la skill de agente

    Instala la skill oficial incluida para que tu agente de código conozca la gramática de comandos, los formatos de salida y las reglas de aprobación de escrituras.

    npx skills add chatwoot/cli
  4. 04

    Pide, revisa, aprueba

    Deja que el agente lea y resuma con libertad. Para respuestas, asignaciones, etiquetas, prioridades, estados o llamadas a la API que muten datos, revisa el comando exacto y confírmalo primero.

Hecho para agentes. Responsable ante humanos.

Las lecturas son fáciles. Las escrituras te esperan.

Un agente puede inspeccionar la cola y preparar un plan por su cuenta. La skill oficial le indica que se detenga y te pregunte antes de cambiar datos de soporte compartidos o enviar un mensaje.

Lee libremente

convsmessagescontactsinboxesagentslabelsteamscentro de ayudasolicitudes GET

Confirma antes de escribir

replyassignresolvelabelprioritycambios de estadollamadas API no GET
Credenciales
Las API keys locales viven en el llavero del sistema operativo. CHATWOOT_API_KEY está disponible para CI y entornos sin interfaz.
Despliegue
El inicio de sesión acepta tu URL base, así que la misma CLI funciona con Chatwoot Cloud o con tu instalación autoalojada.
Salida para agentes
Usa JSON para un parseo fiable, CSV para exportaciones o el modo silencioso para pipelines de solo IDs. El texto legible para humanos sigue siendo el predeterminado.
Cobertura de la API
Prefiere los comandos de primera clase. Cuando no existe uno, el comando en crudo chatwoot api ofrece una vía de escape autenticada bajo la cuenta configurada.

Inicio rápido

Instala la Chatwoot CLI en minutos.

Instala la versión publicada, inicia sesión en tu cuenta de Chatwoot y añade la skill oficial para que tu agente conozca los comandos y las reglas de seguridad.

quick-start

1 — Instala

$ curl -fsSL https://chwt.app/install-cli | sh

2 — Conecta

$ chatwoot auth login

3 — Enseña a tu agente

$ npx skills add chatwoot/cli

✓ Credenciales validadas

✓ API key guardada en el llavero del sistema

✓ Skill de agente lista

¿Nuevo en Chatwoot?

Atiende el soporte al cliente con los agentes de código que ya usas.

Chatwoot es la plataforma de soporte al cliente de código abierto detrás de la CLI: bandeja omnicanal, centro de ayuda y Captain AI. Si tu equipo ya trabaja con un agente de código, este puede hacer triaje de conversaciones, consultar respuestas publicadas y redactar respuestas para tu aprobación desde el primer día, en Chatwoot Cloud o autoalojado.

  • Claude Code
  • Codex
  • Cursor
  • GitHub Copilot
  • Gemini CLI
  • Grok
  • Windsurf

…y cualquier otro agente que pueda ejecutar comandos de shell.

Preguntas, respondidas

Chatwoot CLI y agentes de IA

Los detalles prácticos antes de dar a un agente acceso a una cuenta de soporte real.

¿Qué es Chatwoot CLI?

Chatwoot CLI es la interfaz de línea de comandos oficial y de código abierto de Chatwoot. Permite que personas, scripts y agentes de código lean datos de soporte y ejecuten flujos de trabajo comunes de conversaciones desde una terminal.

¿En qué se diferencia la CLI de Captain y Agent Bots?

Cubren tres superficies distintas. Captain es el copiloto de IA de Chatwoot dentro del producto, que responde a los clientes desde tu contenido de ayuda. Agent Bots conecta un bot personalizado a tus bandejas mediante la API de Agent Bots. La Chatwoot CLI es para agentes de código en tu terminal, que leen datos de soporte y preparan trabajo que tú apruebas.

¿Qué agentes de código con IA pueden usarla?

Cualquier agente que pueda ejecutar comandos de shell puede usar la CLI. Eso incluye Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Grok y Windsurf. La skill de Chatwoot incluida está diseñada para entornos de agentes que admiten skills instalables o instrucciones de proyecto.

¿Funciona con Chatwoot autoalojado?

Sí. Durante el inicio de sesión proporcionas la URL base de Chatwoot, la API key y el ID de cuenta. Eso permite que la misma CLI se conecte a Chatwoot Cloud o a una instalación autoalojada de Chatwoot.

¿Puede un agente enviar respuestas o resolver conversaciones?

La CLI admite respuestas, notas privadas, asignaciones, etiquetas, prioridades y cambios de estado. La skill oficial de agente los trata como escrituras privilegiadas: el agente debe mostrar el comando exacto y esperar tu aprobación explícita antes de ejecutarlo.

¿Dónde guarda la CLI mi API key?

El inicio de sesión interactivo guarda la API key en el llavero de tu sistema operativo. Los ajustes no secretos viven en el archivo de configuración de la Chatwoot CLI. Los entornos de CI y sin interfaz pueden proporcionar CHATWOOT_API_KEY en su lugar.

¿Puedo usar Chatwoot CLI en scripts?

Sí. Usa la salida JSON cuando el código necesita la respuesta completa, CSV para exportaciones tabulares o el modo silencioso para un ID por línea. El comando de API en crudo está disponible cuando un flujo de trabajo aún no tiene un comando de primera clase en la CLI.

La interfaz oficial para agentes de código

Pon la cola donde trabaja tu agente.

Consigue Chatwoot CLI Comienza tu prueba gratuita

o solicita una demostración