Cómo ver la cuenta conectada: get_profile y la tarjeta de contacto de Waspy
get_profile dice qué cuenta está conectada. search_contacts devuelve la ficha y, en ChatGPT, una tarjeta. No existe GET /api/v2/profile. Ninguna de las dos le escribe al cliente.
Respuesta corta: para saber qué cuenta de Waspy está detrás del conector, el cliente llama a get_profile. Para listar contactos con ficha, llama a search_contacts. Las dos viven en POST https://api.waspytech.com/mcp, método JSON-RPC tools/call. No hay GET /api/v2/profile. search_contacts puede mostrar una tarjeta en un cliente que renderice ui://waspy/contact-card.html. Ninguna de las dos manda un WhatsApp.
La guía del conector está en conectar el MCP. El par de investigación (search y fetch, que cita y no abre esta tarjeta) está en citar un chat. El alta de cada cliente está en Claude, ChatGPT y Cursor.
get_profile
No pide argumentos ni un scope extra. Una clave sin permisos y una conexión de solo lectura pueden llamarla.
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": "tools/call",
"params": { "name": "get_profile", "arguments": {} }
}'
Si el pedido trae id, el HTTP de un JSON-RPC válido es 200. result.structuredContent y el texto de result.content[0] traen el mismo objeto. Los campos vacíos no se mandan.
| Campo | OAuth (ChatGPT, Claude, Codex) | Clave wspy_ |
|---|---|---|
id | oauth: | apikey: |
name | Nombre de la persona | Nombre de la clave |
email | El de esa persona | No viene |
nickname | Nombre de la cuenta de Waspy | Nombre de la cuenta de Waspy |
id de OAuth no cambia cuando el access token se renueva (dura 1 hora). El refresh dura 30 días y se rota en cada uso: el id sigue siendo el del usuario. Crear otra clave sí cambia el id, porque es el id de esa fila. Un argumento tenantId se ignora: la cuenta sale del token.
Sin Authorization, el HTTP es 401. Con la cuenta bloqueada, 402 y el código JSON-RPC -32002. Pasado el cupo del minuto, 429. Un JSON-RPC inválido sigue en HTTP 200, con error.code -32600. Un pedido sin id (una notificación) responde 202 y cuerpo vacío: no trae el perfil.
La clave wspy_ está en Scale (US$150 por mes) y Enterprise. Starter y Growth no la incluyen. ChatGPT y Claude entran por OAuth con el usuario de la cuenta, sin pegar esa clave. Los planes están en Planes.
search_contacts y la tarjeta
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": "tools/call",
"params": {
"name": "search_contacts",
"arguments": { "query": "Laura", "limit": 20 }
}
}'
Hace falta contacts:read. Si la conexión tiene scopes y no incluye ese, el texto es Esta conexión no tiene el permiso contacts:read. y isError es true. El HTTP sigue en 200. Una clave sin lista de scopes, en un usuario que no es de solo lectura, tiene acceso completo.
| Argumento | Qué hace |
|---|---|
query | Nombre, teléfono, email, el texto de las etiquetas o la etapa. Se recorta a 200 caracteres. % y _ no amplían el match. Vacío lista los más recientes |
limit | Entero de 1 a 50. Si falta, es 0 o no es un número, son 20 |
lastMessageAt, de más reciente a más viejo. No entran contactos borrados. Cada ítem trae id, name, phoneNumber, email, tags, funnelStage, temperature y lastMessageAt.
La herramienta declara la tarjeta ui://waspy/contact-card.html. ChatGPT puede mostrarla. Claude, Cursor, Codex y Grok igual reciben el JSON si no dibujan esa tarjeta. El HTML muestra nombre, teléfono o email, y las etiquetas. No muestra funnelStage, temperature ni lastMessageAt, aunque vengan en el JSON. Si la lista está vacía, el texto de la tarjeta es No hay contactos para mostrar. La tarjeta no pide recursos de afuera: connect_domains y resource_domains están vacíos.
resources/list publica esa uri con el nombre Tarjeta de contacto. resources/read con params.uri igual a ui://waspy/contact-card.html devuelve el HTML. Una uri que no existe responde HTTP 200 con error.code -32002 y el texto No encuentro ese recurso.
Quién ve qué contactos
Una clave, el owner, un admin o un super admin no llevan un filtro extra: ven los contactos de la cuenta. Aunque la clave esté limitada a un número, search_contacts no recorta por ese número.
Un usuario que no es de esos roles solo ve contactos asociados a los números a los que tiene acceso. Si no tiene ningún número, la lista vuelve vacía.
search_conversations es la otra tarjeta, ui://waspy/conversation-card.html. Pide conversations:read. El HTML muestra el nombre, el canal, la leyenda ventana abierta si windowOpen es true, y la vista previa. No muestra el teléfono, aunque el JSON traiga contactPhone. Ahí sí: si la clave tiene números permitidos, el listado se queda en esos números. Un grupo no entra.
windowOpen es true solo si serviceWindowExpiresAt todavía no pasó. La regla de las 24 horas está en la ventana. Leer la ficha por REST, con otro contrato, está en contactos por API.
Apps Script, sin escribirle al cliente
n8n usa el nodo MCP Client contra https://api.waspytech.com/mcp. El mismo JSON entra en UrlFetchApp. Esta llamada no manda un mensaje.
function perfilWaspy() {
var clave = PropertiesService.getScriptProperties().getProperty('WASPY_API_KEY');
var res = UrlFetchApp.fetch('https://api.waspytech.com/mcp', {
method: 'post',
contentType: 'application/json',
headers: {
Authorization: 'Bearer ' + clave,
Accept: 'application/json, text/event-stream'
},
muteHttpExceptions: true,
payload: JSON.stringify({
jsonrpc: '2.0',
id: 1,
method: 'tools/call',
params: { name: 'get_profile', arguments: {} }
})
});
Logger.log(res.getResponseCode() + ' ' + res.getContentText());
}
send_message y send_template son otras herramientas. Le escriben a un cliente y el conector pide que una persona confirme. En el plan Pro de ChatGPT el conector es solo lectura: get_profile y search_contacts entran, el envío no. Cómo se resume la bandeja sin citar un chat está en las habilidades.
La referencia pública está en docs.waspytech.com. Diez días sin tarjeta, en el registro.
