Tools de Chatwoot
Las 15 operaciones de Chatwoot que tu producto ejecuta en la cuenta de tu cliente con Connect. Todas usan el mismo endpoint, POST /api/tools/{tool}/execute.
- 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.
- Vincular contacto a bandejaPOSTVincula un contacto existente a otra bandeja y devuelve el contact_inbox con su source_id, para Create conversation cuando el contacto aún no tiene source_id en esa bandeja.
- Listar bandejasGETLista las bandejas de la cuenta, una por canal, como WhatsApp, sitio web, email o API, con id, nombre y channel_type. El id es el inbox_id de conversaciones y contactos.
- Listar agentesGETLista los agentes de la cuenta con id, nombre, email, rol y availability_status. El id es el assignee_id de una conversación.
- Listar equiposGETLista los equipos de la cuenta con id, nombre y si el usuario de la conexión es miembro. El id es el team_id de las conversaciones.
- Obtener perfilGETDevuelve el usuario conectado: id, nombre, email y las cuentas a las que pertenece, cada una con id, nombre y rol. El id de cada cuenta es el account_id que piden las otras tools. El campo access_token de la respuesta viene enmascarado.
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.
