Volver al blog
Desarrolladores

Cómo leer la ubicación que manda un cliente por la API de Waspy

La latitud y la longitud quedan en content de un mensaje type location. GET /api/v2/messages/:id las devuelve. No se puede mandar type location. El MCP muestra [location].

· 12 min
Cómo leer la ubicación que manda un cliente por la API de Waspy

Respuesta corta: cuando el cliente manda un pin, Waspy guarda el objeto location de Meta en content y el mensaje queda con type: "location". Lo leés con GET https://api.waspytech.com/api/v2/messages/{id} y el scope messages:read. No existe un envío type: "location". El enum de POST /api/v2/messages no lo incluye: la API responde 400 VALIDATION_ERROR y no sale ningún WhatsApp. El conector MCP tampoco devuelve la latitud: el texto queda [location].

La referencia del webhook de Meta, leída el 18 de noviembre de 2026, está en location messages. La referencia de Waspy está en mensajes y en conversaciones.

Qué copia el servidor

En el procesador del webhook, el caso location asigna content al objeto waMessage.location, sin rearmar los campos. La referencia de Meta documenta estos:

CampoQué es
latitudeGrados decimales
longitudeGrados decimales
nameNombre del lugar, si Meta lo manda
addressDirección, si Meta la manda
urlURL, en general de un local. Si no viene, no está
Waspy no agrega una clave que Meta no haya mandado. Un pin suelto en el mapa puede traer solo latitud y longitud. Un local puede traer también name y address.

En la bandeja, el preview usa name. Si no hay nombre, usa address. Si no hay ninguno, muestra “📍 Ubicación”. Ese texto es de la lista de chats. No reemplaza el objeto de la API.

Cómo leerlo

GET /api/v2/messages/{id} pide messages:read. La clave va en Authorization: Bearer wspy_....

curl -sS "https://api.waspytech.com/api/v2/messages/MSG_UUID" \
  -H "Authorization: Bearer wspy_..."

El data.type es location y data.content es ese objeto. data.direction es inbound. mediaId y mediaKey quedan vacíos: no hay archivo que bajar. El paso de las fotos está en descargar media.

El mismo mensaje aparece en el listado, del más viejo al más nuevo. El default de limit es 50 y el máximo es 100. El cursor de meta, cuando hasMore es verdadero, apunta al más viejo de la página para pedir los anteriores.

curl -sS "https://api.waspytech.com/api/v2/conversations/CONV_UUID/messages?limit=50" \
  -H "Authorization: Bearer wspy_..."

Ese handler también llama a requireScope con messages:read. La guía de scopes y la referencia de conversaciones dicen conversations:read. El código no pide ese scope en esta ruta. Una clave creada solo con lo que dice la guía recibe 403. Pedí los dos. Una clave sin scopes tiene acceso completo.

El webhook message.received manda el mensaje ya serializado, más contact con id, name y phoneNumber. content es el mismo objeto. No hay un segundo evento cuando “el mapa está listo”: no hay mapa que bajar.

Qué no se puede mandar

POST /api/v2/messages valida type contra este enum: text, image, video, audio, document, template, interactive, reaction. location no está. El error de validación se contesta antes de encolar un envío. El manejador, si el error trae validation, responde:

{
  "error": { "code": "VALIDATION_ERROR", "message": "...", "status": 400 },
  "meta": { "requestId": "..." }
}

El message es el del validador. No lo reescribo acá. El helper INVALID_MESSAGE_TYPE existe en el servidor y su texto ni siquiera nombra reaction, pero un body con type: "location" no llega a ese helper.

reaction sí está en el enum. Cómo usarla está en reaccionar a un mensaje.

Para contestarle al cliente, un texto, con la ventana abierta y el scope messages:write:

curl -sS -X POST "https://api.waspytech.com/api/v2/messages" \
  -H "Authorization: Bearer wspy_..." \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumberId": "PHONE_UUID",
    "to": "+5493415551234",
    "type": "text",
    "text": { "body": "Recibí el pin. Si está dentro de Rosario, el moto sale mañana." }
  }'

Si la ventana está cerrada, la respuesta es 403 SERVICE_WINDOW_EXPIRED. Ahí hace falta una plantilla, no un pin. La regla está en las 24 horas.

Con latitude y longitude que ya leíste, el link del mapa lo armás en tu sistema (https://www.google.com/maps?q=LAT,LNG). Waspy no tiene un endpoint de mapas.

Claude, Cursor, Codex y el MCP

get_conversation_messages pide el scope messages:read. Si la clave tiene scopes, el ejecutor pide además conversations:read. Cada mensaje vuelve con text. Para una ubicación, esa función no lee latitude ni name: el texto es [location].

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_conversation_messages",
    "arguments": { "conversationId": "CONV_UUID" }
  }
}

Eso se manda con POST https://api.waspytech.com/mcp. Sirve para saber que entró una ubicación. Las coordenadas se leen con el GET de arriba. Cómo se conecta el conector está en Claude, ChatGPT y Cursor y en la guía. send_message manda texto, no un pin, y solo dentro de la ventana.

Qué se cobra

Lo que el cliente manda no se cobra. El pin abre la ventana de 24 horas. Tu texto, si se entrega, es un mensaje de servicio: 1.000 por número y por mes desde el 1 de octubre de 2026 y, desde el 1.001, alrededor de ARS 37,68 (~US$0,026) en Argentina. La fuente es la rate card.

Una moto de Rosario que copia el pin al repartidor usa ese GET. No hace falta un segundo mensaje de marketing. La API está en Scale (US$150 por mes) y Enterprise. Diez días sin tarjeta, en el registro. La referencia pública está en la API y en enviar mensajes.

Tu equipo atendiendo por WhatsApp en minutos

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