Enviar Mensajes

Enviar Ubicación

Envía una ubicación geográfica con pin en el mapa. El destinatario puede abrirla directamente en Google Maps o Apple Maps.

POSThttps://api.zapzapapi.com/api/v1/{instanceId}/send/location

Autenticación con los encabezados x-api-key y x-api-secret.

Parámetros

NombreTipoDóndeObligatorioDescripción
numbertextcuerpoSíNúmero (con código de país)
latitudenumbercuerpoSíLatitud
longitudenumbercuerpoSíLongitud
nametextcuerpoNoNombre del lugar
addresstextcuerpoNoDirección
delaynumbercuerpoNoDelay (ms)
digitandoselectcuerpoNoMuestra un indicador automático de "escribiendo..." proporcional al tamaño del mensaje antes de enviarlo. Activado por defecto (humaniza y reduce el riesgo de bloqueo). Envía false para desactivarlo y responder más rápido. La respuesta sigue siendo síncrona.

Ejemplo de solicitud

curl

curl -X POST "https://api.zapzapapi.com/api/v1/{instanceId}/send/location" \
  -H "x-api-key: TU_API_KEY" \
  -H "x-api-secret: TU_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"number":"5511999999999","latitude":-23.5505,"longitude":-46.6333}'

Node.js

const res = await fetch("https://api.zapzapapi.com/api/v1/{instanceId}/send/location", {
  method: "POST",
  headers: {
    "x-api-key": "TU_API_KEY",
    "x-api-secret": "TU_API_SECRET",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "number": "5511999999999",
    "latitude": -23.5505,
    "longitude": -46.6333
  }),
});
console.log(await res.json());

Python

import requests

res = requests.post(
    "https://api.zapzapapi.com/api/v1/{instanceId}/send/location",
    headers={"x-api-key": "TU_API_KEY", "x-api-secret": "TU_API_SECRET"},
    json={"number":"5511999999999","latitude":-23.5505,"longitude":-46.6333},
)
print(res.json())

Ejemplo de respuesta

JSON

{
  "messageId": "ABCDEF123456",
  "status": "sent"
}

Los valores son ilustrativos; los campos siguen el formato real de la respuesta.

Ver la referencia completa

Consigue tus claves de API

Crea tu cuenta, conecta un número en minutos y empieza a usar la API. R$15 por número activo/mes, con un crédito de bienvenida al crear la cuenta, sujeto a la campaña vigente.