Send Messages
Send Location
Sends a geographic location with a map pin. The recipient can open it directly in Google Maps or Apple Maps.
POST
https://api.zapzapapi.com/api/v1/{instanceId}/send/locationAuthentication with the x-api-key and x-api-secret headers.
Parameters
| Name | Type | In | Required | Description |
|---|---|---|---|---|
number | text | body | Yes | Number (with country code) |
latitude | number | body | Yes | Latitude |
longitude | number | body | Yes | Longitude |
name | text | body | No | Place name |
address | text | body | No | Address |
delay | number | body | No | Delay (ms) |
digitando | select | body | No | Shows an automatic "typing..." indicator, proportional to the message length, before sending. On by default (humanizes and reduces block risk). Send false to turn it off and reply faster. The response remains synchronous. |
Request example
curl
curl -X POST "https://api.zapzapapi.com/api/v1/{instanceId}/send/location" \
-H "x-api-key: YOUR_API_KEY" \
-H "x-api-secret: YOUR_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": "YOUR_API_KEY",
"x-api-secret": "YOUR_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": "YOUR_API_KEY", "x-api-secret": "YOUR_API_SECRET"},
json={"number":"5511999999999","latitude":-23.5505,"longitude":-46.6333},
)
print(res.json())Response example
JSON
{
"messageId": "ABCDEF123456",
"status": "sent"
}Values are illustrative; the fields follow the real response format.
Other endpoints in this category
Get your API keys
Create your account, connect a number in minutes and start using the API. R$15 per active number/month, with a welcome credit when you create the account, subject to the current campaign.