Enviar mensajes
Enviar y pedir ubicación
Envía un punto en el mapa o pide al contacto que comparta su ubicación en WhatsApp.
Dos tareas de ubicación, ambas solo en WhatsApp: enviar un punto en el mapa y pedir la ubicación del contacto. Los campos comunes a todos los tipos (to, reply_to, typing, delay_ms, ventana de 24 h) están en Campos comunes.
Enviar una ubicación
Sección titulada «Enviar una ubicación»Usa type: "location" en POST /v1/messages.
| Campo | Regla |
|---|---|
location.latitude |
Número de -90 a 90 |
location.longitude |
Número de -180 a 180 |
location.name |
Opcional, hasta 256 caracteres |
location.address |
Opcional, hasta 512 caracteres |
curl -X POST https://api.messajo.com/v1/messages \ -H "Authorization: Bearer $MESSAJO_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "connection_id": "con_123", "to": "5511999990000", "type": "location", "location": { "latitude": -23.5614, "longitude": -46.6559, "name": "Tienda Paulista", "address": "Av. Paulista, 1000, São Paulo" }}'import { Messajo } from "@messajo/sdk";
const messajo = new Messajo({ apiKey: process.env.MESSAJO_API_KEY! });
const message = await messajo.messages.send({ connection_id: "con_123", to: "5511999990000", type: "location", location: { latitude: -23.5614, longitude: -46.6559, name: "Tienda Paulista", address: "Av. Paulista, 1000, São Paulo", },});console.log(message.id, message.status);Ajustes del nodo HTTP Request de n8n
- Método:
POST - URL:
https://api.messajo.com/v1/messages - Autenticación: Generic Credential Type, luego Header Auth. Nombre:
Authorization; Valor:Bearer mj_... - Encabezados: activa Send Headers y añade
Idempotency-Key(un valor único por ítem) - Cuerpo: activa Send Body; Body Content Type: JSON; Specify Body: Using JSON
{ "connection_id": "con_123", "to": "5511999990000", "type": "location", "location": { "latitude": -23.5614, "longitude": -46.6559, "name": "Tienda Paulista", "address": "Av. Paulista, 1000, São Paulo" }}Sustituye mj_... por tu clave de API.
La respuesta es 201 con id (msg_…), status: "queued" y conversation_id. El estado final llega por webhook.
Pedir la ubicación del contacto
Sección titulada «Pedir la ubicación del contacto»Usa type: "interactive" con interactive.type: "location_request_message". El contacto ve el texto y un botón para compartir su ubicación. body.text tiene hasta 1024 caracteres y action.name es siempre send_location.
curl -X POST https://api.messajo.com/v1/messages \ -H "Authorization: Bearer $MESSAJO_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "connection_id": "con_123", "to": "5511999990000", "type": "interactive", "interactive": { "type": "location_request_message", "body": { "text": "¿A dónde enviamos tu pedido?" }, "action": { "name": "send_location" } }}'await messajo.messages.send({ connection_id: "con_123", to: "5511999990000", type: "interactive", interactive: { type: "location_request_message", body: { text: "¿A dónde enviamos tu pedido?" }, action: { name: "send_location" }, },});Ajustes del nodo HTTP Request de n8n
- Método:
POST - URL:
https://api.messajo.com/v1/messages - Autenticación: Generic Credential Type, luego Header Auth. Nombre:
Authorization; Valor:Bearer mj_... - Encabezados: activa Send Headers y añade
Idempotency-Key(un valor único por ítem) - Cuerpo: activa Send Body; Body Content Type: JSON; Specify Body: Using JSON
{ "connection_id": "con_123", "to": "5511999990000", "type": "interactive", "interactive": { "type": "location_request_message", "body": { "text": "¿A dónde enviamos tu pedido?" }, "action": { "name": "send_location" } }}Sustituye mj_... por tu clave de API.
Recibir la respuesta
Sección titulada «Recibir la respuesta»Cuando el contacto comparte su ubicación, llega un evento message.received con content.type: "location":
{ "type": "location", "latitude": -23.5614, "longitude": -46.6559, "name": null, "address": null, "url": null}name, address y url vienen null cuando el contacto no los informa. Si ignora la solicitud, no llega nada.
Instagram y Messenger
Sección titulada «Instagram y Messenger»No aceptan location ni interactive: devuelven 422 type_not_supported_by_channel.
Errores
Sección titulada «Errores»| Código | Estado | Cuándo |
|---|---|---|
outside_service_window |
422 | Mensaje libre fuera de la ventana de 24 h |
validation_failed |
400 | Latitud o longitud fuera de rango, o texto por encima del límite |
type_not_supported_by_channel |
422 | Instagram o Messenger |