Volver al blog
Desarrolladores

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.

· 12 min
Cómo pedirle a Claude el resumen de la bandeja con las habilidades del conector de Waspy

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-bandejaseguimiento-de-leads
URIskill://waspy/resumen-diario-bandeja/SKILL.mdskill://waspy/seguimiento-de-leads/SKILL.md
Para quéAbiertas, sin leer y chats que esperan respuestaEtapa del embudo y a quién seguir
Herramientas que nombraget_inbox_summary y get_metrics con days 1list_funnel_stages y search_contacts
Qué no haceNo envía mensajes ni plantillasNo mueve la etapa ni anota si no se lo pediste
El 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:

  1. Llamar a get_inbox_summary y a get_metrics con days 1.
  2. Contar abiertas, sin leer y las que esperan respuesta.
  3. Nombrar hasta cinco chats, con canal y último mensaje. No inventar nombres ni teléfonos.
  4. No enviar mensajes ni plantillas. Si hace falta escribir, preguntar primero.
  5. 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.

  1. Llama a list_funnel_stages y después a search_contacts con la etapa o el nombre.
  2. Separa la clasificación automática (hot, warm, silent, cold) de la etapa manual. La etapa se cambia con move_contact_stage, no con esta habilidad.
  3. Propone el siguiente paso en una lista corta. No mueve la etapa ni escribe una nota si no se lo pediste.
  4. Escribirle a un cliente es aparte: confirmar texto y persona, y recién ahí send_message (ventana abierta) o send_template (plantilla aprobada).
  5. 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

LlamadaScope
skills/list, skills/get, resources/read, prompts/getNinguno: son el catálogo del servidor
get_inbox_summary, get_metricsconversations:read
list_funnel_stages, search_contactscontacts:read
move_contact_stagecontacts:write
send_message, send_templatemessages:write
Una API key sin scopes, en un usuario que no es de solo lectura, tiene acceso completo. Si la key tiene scopes, hace falta el de la tabla. En el plan Pro de ChatGPT el conector es solo lectura: puede listar las habilidades y leer la bandeja, y no anota, no mueve la etapa y no envía. En Business, Enterprise y Edu puede escribir, y el envío igual pide confirmación.

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.

Tu equipo atendiendo por WhatsApp en minutos

CRM facil pero potente. En 10 minutos tenes a tu equipo trabajando — no necesitas hablar con nadie.