API de Chatwoot: conversaciones, contactos y bandejas con IA
Chatwoot es una plataforma de atención omnicanal de código abierto, y su API REST cubre conversaciones, mensajes, contactos y ajustes de la cuenta. La usan empresas que alojan su propio Chatwoot o emplean la versión en la nube y quieren conectar bots y automatizaciones. El acceso es por token de usuario o de agent bot.
Qué ofrece la API de Chatwoot
Conversaciones
Listar, filtrar, asignar y cambiar el estado de las conversaciones.
Mensajes
Enviar mensajes y notas privadas en una conversación, con archivos adjuntos.
Contactos
Crear, buscar y actualizar contactos y sus atributos.
Bandejas de entrada
Consultar y configurar canales como WhatsApp, correo y sitio web.
Etiquetas, equipos y atributos
Clasificar conversaciones y repartirlas entre equipos.
Webhooks y agent bots
Recibir eventos de mensajes y conversaciones y responder como bot.
Cómo acceder a la API de Chatwoot
- Con las credenciales de tu empresaCada llamada lleva un token de acceso en la cabecera: el token de perfil de un usuario o el token de un agent bot creado en la cuenta.
- En la instalación propia, los límites dependen de tu servidor. En la nube, sigue las reglas del plan.
- Las conversaciones contienen datos personales: define cuánto se conservan y quién ve el historial.
- Empieza con el bot en una sola bandeja de entrada y escala después.
Documentación oficial: www.chatwoot.com/developers/api
Qué hace un agente de iTeam con la API de Chatwoot
Primera atención en Chatwoot
El agente responde como bot en las bandejas de entrada, resuelve las dudas comunes y pasa a una persona con la conversación resumida.
Etiquetas automáticas
Cada conversación recibe una etiqueta de tema y de urgencia, y va al equipo correcto.
Contacto enriquecido
El agente busca al cliente en el CRM o el ERP y guarda atributos en el contacto, como el plan y el último pedido.
Informe de motivos
Cada semana el agente lee las conversaciones resueltas y muestra los motivos de contacto que más crecieron.
De la credencial al agente trabajando, con aprobación
Crea el agent bot en Chatwoot
En Chatwoot, crea un agent bot (o un usuario de integración), copia el token y define en qué bandejas de entrada actúa.
Define permisos por agente
En iTeam, la credencial de Chatwoot va a la bóveda y cada agente recibe una lista cerrada de acciones (responder conversaciones, aplicar etiquetas, pasar a una persona). Las acciones que modifican datos requieren la aprobación de una persona.
Valida en pequeño y amplía después
Empieza por un caso: envía un mensaje de prueba a una bandeja de entrada interna. Con el resultado comprobado, el proceso gana volumen, siempre con auditoría y con aprobación donde haya riesgo.
Equipos de IA listos que usan Chatwoot
Preguntas sobre la API de Chatwoot
¿La API de Chatwoot es gratuita?
Chatwoot es de código abierto y la API viene incluida, tanto en la instalación propia como en los planes en la nube. El costo es el del alojamiento o el del plan contratado.
¿Necesito programar para usar la API de Chatwoot con iTeam?
No hace falta. iTeam lee la documentación de la API de Chatwoot, arma las llamadas y el equipo de implantación ajusta el flujo contigo. A la empresa le toca aprobar y hacer seguimiento.
¿El agente de iTeam reemplaza a los agentes de Chatwoot?
No. Atiende como bot, resuelve lo repetitivo y transfiere al equipo con contexto. Las personas de atención siguen en Chatwoot, con menos cola.
