Tu equipo ya responde a los clientes en ChatWoot. Esto llega al mismo ChatWoot desde tu propio código — sus bandejas de entrada, lo que está abierto, lo que se dijo y la respuesta que envías — sin una segunda bandeja de entrada y sin mover nada.
Conéctalo una vez
En la página de salas, con la sesión iniciada: la dirección de tu panel de ChatWoot y un token de acceso de administrador. Al conectar se añade un webhook para que vuelvan las respuestas del equipo; al soltar la conexión se elimina. La API nunca acepta ninguno de los dos: POST /chatwoot/v1/connections/link responde 403 con la página donde se ponen.
Qué está abierto
curl "https://makehybrid.com/chatwoot/v1/connections" \ -H "X-API-KEY: $MAKEHYBRID_KEY" curl "https://makehybrid.com/chatwoot/v1/connections/$CONNECTION_ID/conversations?status=open" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
Cada conversación trae el contacto con el que es, el agente al que está asignada, su bandeja de entrada y cuándo se movió por última vez. Sus mensajes llegan del más antiguo al más reciente, y cada uno indica en qué sentido fue: incoming es el del cliente, outgoing el del equipo.
Responder, anotar, resolver
curl -X POST https://makehybrid.com/chatwoot/v1/connections/$CONNECTION_ID/conversations/$CONVERSATION_ID/messages \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "Content-Type: application/json" \
-d '{"content":"It went out this morning — here is the tracking link."}'
curl -X PATCH https://makehybrid.com/chatwoot/v1/connections/$CONNECTION_ID/conversations/$CONVERSATION_ID \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "Content-Type: application/json" \
-d '{"status":"resolved"}'
Envía private en true y será una nota que el cliente nunca ve. Cualquier otra cosa se escribe como el usuario conectado y el cliente la ve, así que un agente que escribe en tu nombre escribe delante de tu cliente.
Que te avisen en vez de preguntar
Registra un endpoint de webhook y cada mensaje de cualquier conversación de ese ChatWoot se publica en él: el del cliente como chatwoot.message_received, el del equipo como chatwoot.message_sent. Los mismos endpoints y la misma firma que los de la LinkedIn API.
curl -X POST https://makehybrid.com/chatwoot/v1/webhooks/endpoints \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "Content-Type: application/json" \
-d '{"url":"https://acme.com/hooks/chatwoot","events":["chatwoot.message_received"]}'
Preguntas frecuentes
¿Verán mis clientes algo nuestro?
No. Es tu ChatWoot en tu dirección, y todo se escribe como el usuario cuyo token es. No se cambia la marca de nada y no se instala nada nuestro en él.
¿Qué pasa cuando ChatWoot está caído?
502 errors/chatwoot_unavailable, y nada se pone en cola ni se reintenta a tus espaldas. Un token rechazado es 409 errors/chatwoot_disconnected, lo que significa que un miembro tiene que volver a conectarlo.
¿Puede un agente de IA responder a los clientes ahí?
Puede, a través de https://makehybrid.com/chatwoot/mcp/<tu clave de API> o en una sala. Dale instrucciones que digan cuándo responder y cuándo dejar mejor una nota privada: el cliente ve todo lo que no es privado.