Atención al cliente
Chatwoot en tu producto y en tus agentes de IA, con una API
El toolkit de Chatwoot cubre las conversaciones, mensajes, contactos, bandejas, agentes y equipos de una cuenta Chatwoot Cloud: iniciar y asignar conversaciones, cambiar su estado y etiquetas, enviar mensajes o notas internas y gestionar contactos. Con Connect, tu producto o agente de IA llama a estas operaciones por un solo endpoint, mientras Connect guarda las credenciales y registra cada ejecución.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/chatwoot_create_conversation/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"account_id": 1,
"source_id": "<source_id>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a Chatwoot.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Chatwoot. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con Chatwoot.
Abrir conversación desde tu app
Cuando un usuario necesita ayuda, encuentra o crea el contacto y crea una conversación en la bandeja correcta con un primer mensaje.
Triaje con agente de IA
Un agente lee los últimos mensajes de una conversación, responde o deja una nota privada, etiqueta, asigna a un agente o equipo y define el estado.
Contactos siempre sincronizados
Busca contactos por email o teléfono y actualiza sus campos cuando cambie el registro del cliente en tu CRM o SaaS.
Tools
15 tools de Chatwoot
- Listar conversacionesGETLista las conversaciones de una cuenta, por defecto las abiertas, con estado, etiquetas, inbox_id, can_reply, el contacto en meta.sender, el responsable y el último mensaje. data.meta trae los conteos por tipo de responsable. Las páginas empiezan en 1; un payload vacío significa que no hay más páginas.
- Crear conversaciónPOSTInicia una conversación con un contacto en una bandeja, opcionalmente con un primer mensaje. source_id identifica al contacto en esa bandeja: viene de contact_inboxes en Search contacts, de Create contact o de Create contact inbox. En bandejas de WhatsApp, el primer mensaje va como plantilla aprobada en message.template_params.
- Actualizar estado de la conversaciónPOSTDefine el estado de una conversación: open, resolved, pending o snoozed. Sin snoozed_until, una conversación en snoozed espera la próxima respuesta del contacto, y cualquier respuesta del contacto la reabre.
- Asignar conversaciónPOSTAsigna una conversación a un agente o a un equipo. Cuando se envía assignee_id, team_id se ignora.
- Actualizar etiquetas de la conversaciónPOSTDefine las etiquetas de una conversación. La lista enviada reemplaza las etiquetas actuales, así que debe incluir las que se quieren conservar.
- Listar mensajesGETDevuelve los últimos mensajes de una conversación en orden ascendente, con meta que contiene etiquetas, contacto y responsable. sender_type indica quién envió cada mensaje, y private marca las notas internas. Para mensajes más antiguos, pasa before con el id del más antiguo recibido.
- Crear mensajePOSTEnvía un mensaje en una conversación. Un mensaje saliente llega al contacto por el canal de la bandeja, como WhatsApp, email o el widget del sitio; private true crea una nota interna que solo ven los agentes. En WhatsApp, template_params envía una plantilla aprobada.
- Buscar contactosGETBusca los contactos que tienen identificador, email o teléfono, por nombre, identificador, email o número de teléfono, 15 por página. Cada contacto trae contact_inboxes, que une cada bandeja con el source_id que necesita Create conversation. meta.count es el total; una página con menos de 15 contactos es la última.
- Crear contactoPOSTCrea un contacto en una bandeja de la cuenta. La respuesta trae el contacto y el contact_inbox con el source_id que necesita Create conversation.
- Actualizar contactoPUTActualiza un contacto: envía solo los campos a cambiar.
Clave de API
Tu cliente pega la clave de la app en una pantalla de Connect, o tu sistema envía la clave con POST /api/customer-toolkits, sin pantalla.
Preguntas sobre el toolkit de Chatwoot
¿Necesito implementar la API de Chatwoot?
No. Connect ya trae 15 tools de Chatwoot descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de Chatwoot?
Con el modo que acepta el toolkit: Clave de API. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
