Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade Chatwoot con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.
Resumen
Chatwoot, la bandeja de soporte omnicanal, en la nube o autoalojada: conversaciones y mensajes de WhatsApp, e-mail, chat web y canales sociales, contactos, etiquetas, agentes, equipos, respuestas predefinidas e informes de soporte (primera respuesta, tiempos de resolución y de respuesta). Las respuestas, notas privadas y nuevas conversaciones están incluidas, pero desactivadas al instalar.
Prueba a pedir
Prompts de ejemplo para Chatwoot
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Chatwoot, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
Chatwoot
Chatwoot, la bandeja de soporte omnicanal, en la nube o autoalojada: conversaciones y mensajes de WhatsApp, e-mail, chat web y canales sociales, contactos, etiquetas, agentes, equipos, respuestas predefinidas e informes de soporte (primera respuesta, tiempos de resolución y de respuesta). Las respuestas, notas privadas y nuevas conversaciones están incluidas, pero desactivadas al instalar.
Configuración
La configuración lleva unos 2 minutos. Necesitas una cuenta de Chatwoot, en Chatwoot Cloud o autoalojada, y el access token del usuario con el que debe trabajar la IA.
- Inicia sesión en Chatwoot con ese usuario. Los agentes solo ven las conversaciones de las bandejas de las que son miembros y no pueden leer informes, así que para tener la visión completa usa un administrador.
- Haz clic en tu avatar, después en Profile Settings, y copia el Access Token del final de la página en
CHATWOOT_API_TOKEN. No caduca; puedes restablecerlo en la misma página. - Pon en
CHATWOOT_URLla dirección con la que abres Chatwoot:https://app.chatwoot.comen Chatwoot Cloud, o tu propio dominio, por ejemplohttps://chat.example.com, si lo alojas tú. Sin ruta, sin/app, sin/api. - Pon en
CHATWOOT_ACCOUNT_IDel número que aparece después de/app/accounts/en la barra de direcciones:https://app.chatwoot.com/app/accounts/3/dashboardsignifica 3. - Instala el conector y ejecuta
chatwoot_get_profile: muestra el usuario detrás del token, su rol y todas las cuentas a las que llega el token, con su id.
Token de cuenta, no Platform API: el token de una Platform App de un super admin (/platform/api) no sirve aquí. El conector usa la Application API de Chatwoot de una cuenta.
Autoalojado detrás de nginx: el token viaja en la cabecera api_access_token, y nginx descarta las cabeceras con guion bajo si no se configura underscores_in_headers on;. Se nota como un 401 en cada llamada aunque el token sea correcto. Un Chatwoot autoalojado que solo vive en una red privada no es accesible desde AnythingMCP Cloud; en ese caso usa un AnythingMCP autoalojado dentro de esa red.
Qué lee: la cuenta y el usuario detrás del token; tus bandejas (WhatsApp, e-mail, widget web, API, Instagram, Telegram y más) con sus miembros; agentes y administradores con su disponibilidad; equipos y sus miembros; etiquetas, respuestas predefinidas (canned responses) y definiciones de atributos personalizados; conversaciones con estado, prioridad, bandeja, etiquetas, contacto, agente asignado y equipo, como lista, como recuento o con filtros como creadas después de una fecha y asignadas a un agente; los mensajes de una conversación, incluidas notas privadas y adjuntos; contactos por nombre, e-mail, teléfono o identificador, con todas sus conversaciones en cualquier bandeja; y los informes de soporte: totales de un periodo junto al periodo anterior, una métrica a lo largo del tiempo, agentes, bandejas o equipos comparados y lo que está abierto y sin atender ahora mismo. Los secretos de canal de las bandejas y el access token del propio usuario se eliminan de las respuestas.
Horas y cifras: las horas de conversaciones y mensajes y los periodos de los informes son marcas de tiempo Unix en segundos (UTC), y la IA las convierte antes de darte una hora. La primera respuesta, el tiempo de resolución y el tiempo de respuesta de los informes están en segundos.
Pregunta antes de cada cambio: chatwoot_set_conversation_labels. Chatwoot sustituye la lista completa de etiquetas de una conversación, así que la IA lee primero las etiquetas actuales y las envía junto con la nueva (o sin la que hay que quitar). Las etiquetas tienen que existir ya en la cuenta. La IA te muestra la conversación y la nueva lista y espera tu sí.
Desactivadas al instalar: chatwoot_send_message (una respuesta, o una nota privada que solo ven los agentes) y chatwoot_create_conversation. Una respuesta o un primer mensaje llega al cliente al instante por WhatsApp, e-mail o chat, así que un administrador las activa a propósito. Incluso entonces la IA te muestra el texto y el destinatario y espera tu sí. En las bandejas de WhatsApp Cloud API, el texto libre solo llega a un contacto dentro de las 24 horas siguientes a su último mensaje; fuera de esa ventana Chatwoot necesita una plantilla aprobada, que este conector no envía.
Límites: las conversaciones llegan de 25 en 25 por página, los contactos de 15 en 15 y los mensajes de 20 en 20, así que la IA va pasando páginas; para una simple cifra cuenta en lugar de listar. Los informes y las estadísticas en vivo necesitan el token de un administrador.
Errores comunes: 401 significa un token incorrecto o restablecido, o nginx descartando la cabecera. Un 404 en todas las llamadas suele indicar un CHATWOOT_URL o un CHATWOOT_ACCOUNT_ID incorrecto; un 404 en una sola conversación indica un id que este usuario no puede ver. Los informes responden 401 o 403 a los agentes que no son administradores.
El conector no usa la Platform API, no envía plantillas de WhatsApp, no resuelve, reasigna ni borra conversaciones existentes y no edita ni borra contactos.
Requisitos previos: CHATWOOT_URL, CHATWOOT_API_TOKEN, CHATWOOT_ACCOUNT_ID
Instalar el conector localmente
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Abre http://localhost:3000/connectors/store, elige Chatwoot e introduce las variables listadas en los Requisitos previos.
Herramientas disponibles
| Tool | What it does |
|---|---|
chatwoot_get_profile | Get the user behind the access token: id, name, email, role, availability and every account the token can reach (accounts[].id and name) |
chatwoot_get_account | Get the Chatwoot account configured in CHATWOOT_ACCOUNT_ID: name, locale, domain, support e-mail, status, enabled features and custom… |
chatwoot_list_inboxes | List the inboxes (channels) of the account: id, name, channel type (WhatsApp, API, web widget, e-mail, Instagram, Telegram...), phone… |
chatwoot_list_inbox_agents | List the agents who are members of one inbox (id, name, email, role, availability) |
chatwoot_list_agents | List the agents and administrators of the account: id, name, email, role (agent or administrator), availability (online, busy, offline) and… |
chatwoot_list_teams | List the teams of the account (id, name, description, whether auto-assignment is on) |
chatwoot_list_team_members | List the agents in one team (id, name, email, role, availability) |
chatwoot_list_labels | List the labels defined in the account: id, title, description and color |
chatwoot_list_canned_responses | List the canned responses (saved replies) of the account: id, short code and content |
chatwoot_list_custom_attributes | List the custom attribute definitions of the account for conversations (attribute_model 0) or contacts (1): key, display name, type and… |
chatwoot_list_conversations | List conversations, 25 per page, newest activity first, with counts (mine, assigned, unassigned, all) |
chatwoot_count_conversations | Count conversations without listing them: mine_count, assigned_count, unassigned_count and all_count for a status, inbox, team or label |
chatwoot_filter_conversations | Filter conversations with Chatwoot's advanced filter, 25 per page: a list of conditions on status, assignee_id, inbox_id, team_id… |
chatwoot_get_conversation | Get one conversation by its id (the number shown in the Chatwoot URL): status, priority, inbox, labels, contact, assignee, team, custom and… |
chatwoot_list_messages | List the messages of a conversation, oldest first: the latest 20 by default, or 20 older than before. message_type 0 = incoming (from the… |
chatwoot_list_contacts | List contacts with an e-mail, phone number or identifier, 15 per page: id, name, e-mail, phone, identifier, custom and additional… |
chatwoot_search_contacts | Search contacts by name, e-mail, phone number or identifier (case-insensitive, partial), 15 per page. meta.has_more tells whether another… |
chatwoot_get_contact | Get one contact: name, e-mail, phone, identifier, custom and additional attributes, last activity and the inboxes the contact is reachable… |
chatwoot_list_contact_conversations | List the conversations of one contact across all inboxes, with status, labels, assignee and last message |
chatwoot_get_report_summary | Get the totals of a period for the account, an agent, an inbox, a label or a team: conversations, incoming and outgoing messages… |
chatwoot_get_report_timeseries | Get one metric over time as [{value, timestamp}] buckets, for the account, an agent, an inbox, a label or a team, grouped by hour, day… |
chatwoot_get_summary_by | Compare agents, inboxes or teams over a period, one row each: conversations, resolved and handled conversations, average resolution, first… |
chatwoot_get_live_conversation_stats | Right now: how many conversations are open, unattended (no reply yet) and unassigned for the whole account (type account), or open and… |
chatwoot_send_message | Send a reply in an existing conversation, or add a private note that only agents see (private true) |
chatwoot_set_conversation_labels | Set the labels of a conversation |
chatwoot_create_conversation | Start a new conversation with an existing contact in an inbox, optionally with a first message, status, assignee and team |
Ejemplos de prompts
- "¿Cuántas conversaciones abiertas están sin asignar ahora mismo, y qué agentes tienen chats sin atender?"
- "Lee la conversación 1284 y resúmeme qué quiere el cliente y qué le hemos prometido ya."
- "Busca el contacto [email protected] y lista todas sus conversaciones por WhatsApp y e-mail."
- "Compara a nuestros agentes en los últimos 30 días: conversaciones atendidas, tiempo de primera respuesta y tiempo de resolución."
- "Añade la etiqueta reembolso a la conversación 1284 sin quitar las demás. Enséñame antes la nueva lista."
Siguientes pasos
¿Te ha sido útil esta guía?
