WhatsApp Listener / MCP
MCP · para Claude y ChatGPT
Preguntale a tu IA qué se habla en tus grupos de WhatsApp.
El MCP conecta el WhatsApp Listener con Claude o con ChatGPT. Le preguntás con tus palabras y te contesta con los temas, las citas textuales y los tickets de tu empresa, sin que abras el tablero.
La dirección del conector
https://whatsapp-listening.gualda.ai/mcp
Se entra con la misma cuenta de Google que usás en el listener.
Qué es
Lo mismo que ves en el tablero, en una charla
MCP es la forma estándar en la que una IA como Claude o ChatGPT se conecta con otras herramientas. Con el MCP del WhatsApp Listener, tu IA puede leer el muro de temas, abrir un tema con sus citas, buscar en los mensajes de tus grupos y seguir tus tickets.
Sirve para lo que en el tablero lleva varios clics: un resumen del día por grupo, encontrar quién dijo algo y cuándo, ver qué quedó sin contestar o armar un informe para una reunión. La IA junta las piezas y vos leés el resultado, con la cita de quién lo dijo.
Ve exactamente lo que ves vos en la web: tus empresas, con tu rol. Nada más.
Cómo conectarlo
Una dirección y tu cuenta de Google
En todos los casos pegás la misma dirección, https://whatsapp-listening.gualda.ai/mcp, y entrás con Google. No hay claves que copiar.
Claude, en la web o en la app
- Abrí Configuración → Conectores.
- Elegí Agregar conector personalizado.
- Pegá la dirección del conector y guardalo.
- Claude abre el login: entrá con tu cuenta de Google y aceptá el permiso.
La primera vez te pide que confirmes que Claude puede usar el listener en tu nombre.
ChatGPT
- Abrí Configuración → Aplicaciones y conectores.
- En Configuración avanzada, activá el modo desarrollador.
- Creá un conector nuevo con la dirección del conector y autenticación OAuth.
- ChatGPT abre el mismo login con Google.
Los conectores propios dependen de tu plan de ChatGPT: si no ves la opción, tu plan no la incluye. Si algo no anda, avisanos por WhatsApp.
Claude Code
- En la terminal:
claude mcp add --transport http whatsapp-listener https://whatsapp-listening.gualda.ai/mcp - Dentro de Claude Code, escribí
/mcpy elegí el listener para hacer el login con Google.
Si no aparece ninguna herramienta, esa cuenta de Google todavía no tiene ninguna empresa en el listener. Si te invitaron y nunca entraste, entrá una vez a whatsapp-listening.gualda.ai con ese mail y volvé a conectar. Para empezar, preguntale algo simple como «¿qué temas hay sin respuesta esta semana?».
Las herramientas
Qué puede hacer tu IA con el listener
No hace falta saber sus nombres: le hablás como a una persona y ella elige cuál usar. Los dejamos al lado por si querés seguir lo que hace.
Para ubicarse
Lo primero que mira, antes de cualquier pregunta.
- Tus empresasempresas_ver
Las empresas a las que tenés acceso y tu rol en cada una. Si tenés más de una, la IA te pregunta de cuál hablás.
- Los gruposgrupos_ver
Los grupos que escucha tu empresa, con sus etiquetas y si se ordenan en temas.
Lo que se habla
El muro de temas y todo lo que hay detrás de cada uno.
- Buscar temastemas_buscar
El muro, del más reciente al más viejo. Filtra por urgentes, sin ticket, sin respuesta, por tono, por categoría, por etiqueta de grupo o desde una fecha.
- Ver un tematema_ver
Un tema entero: en qué grupos apareció, cada cita textual con su hora y su ticket, si tiene.
- Ver una incidenciaincidencia_ver
Lo que pasó en un solo grupo, con sus citas.
- Ver la conversaciónconversacion_ver
La charla completa de la que salió una cita, para leer el contexto antes de sacar conclusiones.
Los mensajes
Para ir directo a lo que se escribió, sin pasar por los temas.
- Leer un grupomensajes_ver
Los mensajes de un grupo en orden, de un día o de un rango de fechas.
- Buscar en los mensajesmensajes_buscar
Los mensajes que dicen una palabra, en todos los grupos o en uno.
Qué grupos se escuchan
Para sumar o soltar un grupo sin entrar a la web. Lo pide un admin de tu empresa, y queda a su nombre.
- Buscar un grupogrupos_buscar
Todos los grupos de las líneas de tu empresa, los que se escuchan y los que no, por parte del nombre.
- Escuchar un grupogrupo_escuchar
Lo mismo que tildarlo en «Grupos»: con quién lo pidió y la confirmación de que la gente del grupo sabe que se lee. Si hay dos con el mismo nombre, la IA te pregunta cuál.
- Dejar de escucharlogrupo_dejar_de_escuchar
Lo destilda. Lo que ya se guardó queda.
Los tickets
Lo que alguien decidió atender. Antes de abrir, cerrar o escalar uno, la IA te lo confirma.
- Ver los ticketstickets_ver · ticket_ver
Los abiertos, en curso y escalados (y, si lo pedís, también los cerrados), y el detalle de cada uno con lo que atiende.
- Abrir un ticketticket_crear
Desde una incidencia del muro, igual que el botón «Crear ticket» del tablero.
- Cambiar el estadoticket_estado
Abierto, asignado, resuelto o descartado, con una nota de qué se hizo.
- Escalarticket_escalar
Lo deja a cargo de quien está de guardia en tu empresa. Si no hay nadie de guardia, lo dice.
Hay además herramientas de administración que sólo ve quien opera la plataforma. Tu IA te muestra únicamente las que podés usar.
Recetas
Preguntas que funcionan bien
Escritas como se las dirías a alguien del equipo. Debajo, lo que hace la IA para contestarte.
-
El resumen del día
¿Qué se habló hoy en cada grupo? Decime qué quedó pendiente.
Lee los mensajes de hoy de cada grupo y los temas nuevos, y te arma, grupo por grupo, de qué se habló, qué se resolvió y qué quedó abierto. Un grupo sin mensajes aparece como «sin mensajes hoy».
-
Quién habló de algo
¿Quién habló de la factura esta semana y qué dijo?
Busca la palabra (y sus variantes) en los mensajes, abre la conversación de cada resultado para entender el contexto y te contesta con quién, cuándo, en qué grupo y la cita textual.
-
Lo que quedó sin respuesta
¿Qué preguntas quedaron sin respuesta en los últimos días?
Filtra el muro por temas sin respuesta, abre los que importan y te los ordena por antigüedad o gravedad, con quién preguntó y en qué grupo.
-
Seguir un ticket
¿Cómo va el ticket del portón? ¿Se volvió a hablar del tema?
Abre el ticket, lo que atiende y busca si el tema volvió a aparecer en los grupos después de abierto. Si se lo pedís, lo marca como resuelto con una nota o lo escala.
-
El informe de la semana
Armame el informe de la semana para la reunión del lunes.
Recorre los temas de los últimos 7 días, los agrupa por categoría y tono, destaca lo urgente y lo que quedó sin contestar, suma los tickets abiertos y cerrados, y cierra con lo que necesita una decisión.
-
Pasar de la charla al ticket
De los temas sin ticket de hoy, ¿cuál conviene atender? Abrile un ticket.
Revisa el muro, te propone cuál y por qué, y recién cuando le decís que sí abre el ticket desde la incidencia.
La skill para Claude
Que Claude sepa usarlo desde la primera pregunta
Una skill es un manual corto que Claude lee cuando hace falta. La del listener le explica qué es cada cosa (mensaje, incidencia, tema, ticket), qué herramienta usar para qué, estas recetas y los límites: que no manda nada a WhatsApp y que no inventa citas.
Bajar la skill (.zip)- Bajá el archivo
whatsapp-listener-mcp.zip. No hace falta descomprimirlo. - En Claude, en la web o en la app, abrí Configuración → Capacidades y buscá la sección Skills. Si no aparece, activá ahí mismo la ejecución de código, que las skills necesitan.
- Subí el zip con la opción para cargar una skill, y dejala activada.
- Conectá también el MCP (arriba): la skill explica cómo usarlo, pero los datos llegan por el conector.
En Claude Code: descomprimí el zip dentro de ~/.claude/skills/. Queda la carpeta whatsapp-listener-mcp con su SKILL.md.
Los límites
Lee, ordena y te cuenta. A WhatsApp no le manda nada.
El MCP hereda lo mismo que el listener: solo lectura sobre WhatsApp y un cliente no oficial.
- Solo lectura sobre WhatsApp.Ninguna herramienta escribe en un grupo ni a una persona. Si le pedís «contestale en el grupo», la IA te ofrece el texto para que lo mande alguien del equipo.
- Lo único que escribe son tus tickets y qué grupos se escuchan.Abrir, cambiar de estado o escalar un ticket queda en el listener, igual que los botones del tablero, y la IA te lo confirma antes. Escuchar o soltar un grupo, sólo si lo pide un admin de tu empresa. No sale nada hacia afuera.
- Solo lo que se escuchó.Ve los grupos que tu empresa eligió, desde que se empezaron a escuchar y dentro del plazo de retención (7, 30 o 90 días). Lo citado en un tema o en un ticket se conserva.
- Las citas salen del listener.Toda cita viene textual de una herramienta, con autor, grupo y fecha. Si la IA te muestra algo entre comillas que no podés encontrar en el tablero, pedile de dónde salió.
- Usa un cliente no oficial de WhatsApp.El listener se conecta como un dispositivo vinculado, con una librería no oficial, y va contra los términos de servicio de WhatsApp. El detalle está en «Antes de empezar».
Privacidad
Tu IA ve lo que ves vos, y nada más
- Entrás con tu cuenta de Google. Tu IA nunca ve tu contraseña: recibe un permiso que vale sólo para el listener.
- Ve las mismas empresas y con el mismo rol que en la web. Si preguntás por una empresa ajena, la respuesta dice «empresa inexistente», sin confirmar que existe.
- Las citas llegan como en el tablero. Por defecto el listener no guarda nombres ni teléfonos, así que tampoco llegan a la IA: cada persona es un código.
- Lo que la IA lee para contestarte (citas, mensajes, tickets) pasa a la conversación con Claude o con ChatGPT, y ahí rigen las condiciones de esa IA. Preguntá lo que necesitás y no más.
- Para cortar el acceso, quitá el conector en tu IA. Tu cuenta y los datos del listener siguen como estaban.
- El resto de las garantías del listener (qué se guarda, por cuánto tiempo, qué no se descarga) están en «Solo lectura y privacidad».
¿Todavía no usás el listener?
El MCP necesita una cuenta en el WhatsApp Listener. El acceso es por invitación: se abre WhatsApp con el mensaje armado.