Cómo pedirle a Claude el resumen de la bandeja con las habilidades del conector de Waspy
El conector tiene dos habilidades: resumen-diario-bandeja y seguimiento-de-leads. Se leen con skills/list. Le dicen al asistente qué herramienta llamar. Ninguna manda un WhatsApp sola.
Respuesta corta: el conector de Waspy publica dos habilidades, no un contestador. Se llaman resumen-diario-bandeja y seguimiento-de-leads. Las listás con el método JSON-RPC skills/list en https://api.waspytech.com/mcp. Cada una es un markdown que le indica al asistente qué herramientas llamar. Ninguna manda un WhatsApp. Si hace falta escribirle a alguien, el texto de la habilidad pide un sí y, recién después, send_message o send_template.
Cómo se conecta Claude, Cursor, ChatGPT, Codex o Grok está en el conector. La guía publicada está en conectar el MCP. La clave de API está en Scale (US$150 por mes) y Enterprise. Los planes están en Planes y el módulo, en la API.
Qué es una habilidad, y qué no
Una habilidad no es un endpoint REST. No hay POST /api/v2/skills. Tampoco es un cron que a las 9 te arma el resumen solo. Es un recurso que el asistente puede leer cuando le pedís «cómo está la bandeja» o «a quién hacer seguimiento».
resumen-diario-bandeja | seguimiento-de-leads | |
|---|---|---|
| URI | skill://waspy/resumen-diario-bandeja/SKILL.md | skill://waspy/seguimiento-de-leads/SKILL.md |
| Para qué | Abiertas, sin leer y chats que esperan respuesta | Etapa del embudo y a quién seguir |
| Herramientas que nombra | get_inbox_summary y get_metrics con days 1 | list_funnel_stages y search_contacts |
| Qué no hace | No envía mensajes ni plantillas | No mueve la etapa ni anota si no se lo pediste |
initialize anuncia la extensión io.modelcontextprotocol/skills. Sin eso, un cliente viejo puede no pedir skills/list. Las mismas dos piezas también aparecen en resources/list y en prompts/list.
Listarlas
curl -sS -X POST https://api.waspytech.com/mcp \
-H "Authorization: Bearer $WASPY_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "skills/list",
"params": {}
}'
Si el pedido trae id, el HTTP de un JSON-RPC válido es 200. result.skills trae, para cada una, uri, frontmatter (name y description) y resources: la misma URI y un digest que empieza con sha256:. Ese digest es el hash del markdown. Si cambia el texto de la habilidad, cambia el hash.
Sin token, el POST responde 401 unauthorized. Con un token que no existe, 401 invalid_token. Si pasás de 120 llamadas por minuto, responde 429 con { "error": "rate_limited" }. Un lote cuenta cada ítem. Un lote de más de 10 no es un 429: el HTTP sigue en 200, el cuerpo trae el código -32600 y el texto El lote supera el máximo de 10 llamadas., y esa llamada solo consume 1 del cupo.
Leer el texto
curl -sS -X POST https://api.waspytech.com/mcp \
-H "Authorization: Bearer $WASPY_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 2,
"method": "skills/get",
"params": { "uri": "skill://waspy/resumen-diario-bandeja/SKILL.md" }
}'
prompts/get pide el nombre, no la URI: { "name": "resumen-diario-bandeja" }. Devuelve el markdown como mensaje de usuario. resources/read usa la misma URI y devuelve contents[0].text.
Si la URI no es una de las dos, skills/get y prompts/get responden, en el cuerpo, error.code -32002 y error.message No encuentro esa habilidad. resources/read dice No encuentro ese recurso. El HTTP sigue siendo 200. No se crea una habilidad con un POST: el catálogo es el del servidor.
Qué hace el resumen
Cuando pedís cómo está la bandeja, la habilidad le indica al asistente este orden:
- Llamar a
get_inbox_summaryy aget_metricscondays1. - Contar abiertas, sin leer y las que esperan respuesta.
- Nombrar hasta cinco chats, con canal y último mensaje. No inventar nombres ni teléfonos.
- No enviar mensajes ni plantillas. Si hace falta escribir, preguntar primero.
- Si una herramienta dice que falta un permiso o que la cuenta está bloqueada por pago, repetir ese texto. No completar los datos de memoria.
get_inbox_summary no lleva argumentos y pide conversations:read. Devuelve openConversations, unreadConversations y hasta 10 waitingReply: chats abiertos cuyo último mensaje es del cliente.
get_metrics pide el mismo scope. Sin days, usa 7. El tope es 31: un 40 se recorta a 31. Con days: 1 devuelve days, messagesIn, messagesOut, openConversations, contactsByTemperature y contactsByStage de las últimas 24 horas. Esos conteos no son la factura de Meta. El precio de los mensajes está en cuánto cuesta la API.
Qué hace el seguimiento
La otra habilidad sirve cuando preguntás a quién hacer seguimiento o qué contactos están en una etapa.
- Llama a
list_funnel_stagesy después asearch_contactscon la etapa o el nombre. - Separa la clasificación automática (
hot,warm,silent,cold) de la etapa manual. La etapa se cambia conmove_contact_stage, no con esta habilidad. - Propone el siguiente paso en una lista corta. No mueve la etapa ni escribe una nota si no se lo pediste.
- Escribirle a un cliente es aparte: confirmar texto y persona, y recién ahí
send_message(ventana abierta) osend_template(plantilla aprobada). - No usa datos de otra cuenta. Si un id no aparece, no existe en esta cuenta.
search_contacts no tiene un campo stage. Busca por nombre, teléfono, email, el texto de las etiquetas y funnelStage. Una consulta ganado puede coincidir con la etapa y también con un nombre que contenga esa palabra. El tope de limit es 50; si no lo mandás, son 20. La consulta se corta a 200 caracteres. Cómo se mueve la etapa, sin pisar el resto de las etiquetas, está en mover la etapa.
Permisos
| Llamada | Scope |
|---|---|
skills/list, skills/get, resources/read, prompts/get | Ninguno: son el catálogo del servidor |
get_inbox_summary, get_metrics | conversations:read |
list_funnel_stages, search_contacts | contacts:read |
move_contact_stage | contacts:write |
send_message, send_template | messages:write |
Si la cuenta está bloqueada, /mcp responde 402 antes de la herramienta, con código JSON-RPC -32002. Un motivo es la suscripción impaga: el mensaje es No se registró el pago. Regularizalo para volver a usar el panel. Hay otros textos, según el motivo del bloqueo. La habilidad le pide al asistente que los repita tal cual.
Diez días de prueba, sin tarjeta, en el registro.
