Volver al blog
Desarrolladores

Cómo citar un chat de WhatsApp con search y fetch del conector de Waspy

search devuelve id, título y url. fetch trae el texto. No existe GET /api/v2/search. Un JSON-RPC válido responde HTTP 200, también si la herramienta marca isError.

· 13 min
Cómo citar un chat de WhatsApp con search y fetch del conector de Waspy

Respuesta corta: para que Claude, ChatGPT, Cursor, Codex o Grok citen un chat de esta cuenta, primero llaman a la herramienta search y después a fetch con el id que devolvió search. Las dos viven en POST https://api.waspytech.com/mcp, método JSON-RPC tools/call. No hay GET /api/v2/search. search devuelve id, title y url. fetch devuelve el texto. Ninguna manda un WhatsApp.

La guía del conector está en conectar el MCP. Cómo se enchufa cada cliente está en Claude, ChatGPT y Cursor. Las dos habilidades de resumen no reemplazan a este par: están en habilidades del conector. 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é devuelve cada una

searchfetch
Argumentoquery (obligatorio)id con la forma contact: o conversation:
TopeHasta 10 contactos y 10 chats, y después se corta en 20Un documento. El chat trae los últimos 30 mensajes
Cuerpo{ "results": [{ "id", "title", "url" }] }{ "id", "title", "text", "url", "metadata" }
Qué no haceNo busca adentro del historialNo envía mensajes ni notas
El initialize del servidor le dice al cliente: para investigación, usá search y después fetch con el id que devolvió search. La misma frase está en la guía.

search_contacts es otra herramienta. Esa sí acepta limit (tope 50) y devuelve la ficha. El mapa de contactos por REST está en contactos por API. search es el par de investigación: id, título y url para citar.

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": "search",
      "arguments": { "query": "Laura" }
    }
  }'

Si el pedido trae id, el HTTP de un JSON-RPC válido es 200. result.structuredContent.results trae los ítems. result.content[0].text es el mismo JSON en texto.

La url de un contacto es {panel}/contacts?contact={uuid}. La de un chat es {panel}/inbox/{uuid}. En producción el panel es https://waspytech.com. Esa url es para abrir la ficha, no un enlace público: pide login.

Sin query, o con solo espacios, la herramienta responde con isError: true y el texto Falta query.. El HTTP sigue en 200. La consulta se recorta a 200 caracteres. Los comodines % y _ se escapan: no amplían el match.

El orden es el último mensaje, de más reciente a más viejo. Primero van los contactos, después los chats. Un grupo no entra: solo conversaciones individuales.

Si la conexión no tiene contacts:read ni conversations:read, el texto es Esta conexión no tiene permiso de lectura.. Con solo uno de los dos, vuelve el tipo que ese permiso deja ver. Una clave sin scopes, en un usuario que no es de solo lectura, tiene acceso completo. Un usuario de solo lectura no escribe, pero estas dos herramientas son de lectura.

Llamar a fetch

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": "fetch",
      "arguments": { "id": "conversation:UUID" }
    }
  }'

Reemplazá UUID por el id que devolvió search, sin inventarlo. Si el id no tiene la forma contact: o conversation:, el texto es Id inválido. Usá el id que devolvió search.. Si ese uuid no está en la cuenta, o esa persona no puede verlo, el texto es No encuentro ese resultado en esta cuenta. y el teléfono del otro no viene en el cuerpo.

Un contacto trae, en text, las líneas que existan: nombre, teléfono, email, etiquetas, etapa y clasificación (hot, warm, silent, cold). metadata trae kind: "contact", temperature y funnelStage. Hace falta contacts:read.

Un chat pide los dos permisos conversations:read y messages:read. Si falta uno, el texto es Para leer una conversación hacen falta los permisos conversations:read y messages:read.. text junta hasta 30 mensajes, del más viejo de ese recorte al más nuevo, con el formato Cliente (fecha ISO): … o Equipo (fecha ISO): …. Una foto sin epígrafe queda como [image]. Cada texto se corta en 2.000 caracteres. metadata trae kind, channel, status y windowOpen (true si la ventana de servicio todavía no venció).

El mismo POST desde Apps Script

n8n, Make y Zapier no tienen un nodo de Waspy. El nodo MCP Client de n8n usa el endpoint https://api.waspytech.com/mcp, transporte Streamable HTTP, y el header Authorization: Bearer wspy_.... El mismo JSON entra en un UrlFetchApp:

function buscarEnWaspy(consulta) {
  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'
    },
    payload: JSON.stringify({
      jsonrpc: '2.0',
      id: 1,
      method: 'tools/call',
      params: { name: 'search', arguments: { query: consulta } }
    }),
    muteHttpExceptions: true
  });
  return res.getContentText();
}

Esa función no manda un WhatsApp. Si el paso siguiente tiene que citar el chat, el segundo tools/call usa name: "fetch" y el id de results. Un Accept que sea solo text/event-stream vuelve como evento SSE. Con application/json (o los dos) el cuerpo es JSON.

Errores de HTTP, aparte de isError

SeñalHTTPQué significa
Sin token401{ "error": "unauthorized" }
Token que no existe401{ "error": "invalid_token" }
Cuenta bloqueada por pago402JSON-RPC -32002. Si la suscripción quedó impaga, el mensaje es No se registró el pago. Regularizalo para volver a usar el panel.
Más de 120 llamadas por minuto429{ "error": "rate_limited" }
GET /mcp405Este servidor MCP responde por POST. No mantiene una sesión abierta.
Un lote de más de 10 no es un 429: el HTTP sigue en 200, el código es -32600 y el texto es El lote supera el máximo de 10 llamadas.. Esa llamada solo consume 1 del cupo.

Qué pedirle al asistente

Una pregunta que cierra bien: «buscá a Laura y citá el último mensaje, con la url del panel. No le escribas.» Si results viene vacío, no hay que completar el teléfono de memoria. Si hace falta contestarle, eso es otro paso: send_message con la ventana abierta, o send_template con una plantilla aprobada, y una persona confirma el texto. El precio de ese mensaje está en cuánto cuesta la API.

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.