Send Messages
Request Location
Sends a message with a button that asks for the user's location. The share location button is added automatically.
POST
https://api.zapzapapi.com/api/v1/{instanceId}/send/location-buttonAuthentication with the x-api-key and x-api-secret headers.
Parameters
| Name | Type | In | Required | Description |
|---|---|---|---|---|
number | text | body | Yes | Number (with country code) |
text | textarea | body | Yes | Message text |
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-button" \
-H "x-api-key: YOUR_API_KEY" \
-H "x-api-secret: YOUR_API_SECRET" \
-H "Content-Type: application/json" \
-d '{"number":"5511999999999","text":"Compartilhe sua localização para entregarmos seu pedido:"}'Node.js
const res = await fetch("https://api.zapzapapi.com/api/v1/{instanceId}/send/location-button", {
method: "POST",
headers: {
"x-api-key": "YOUR_API_KEY",
"x-api-secret": "YOUR_API_SECRET",
"Content-Type": "application/json",
},
body: JSON.stringify({
"number": "5511999999999",
"text": "Compartilhe sua localização para entregarmos seu pedido:"
}),
});
console.log(await res.json());Python
import requests
res = requests.post(
"https://api.zapzapapi.com/api/v1/{instanceId}/send/location-button",
headers={"x-api-key": "YOUR_API_KEY", "x-api-secret": "YOUR_API_SECRET"},
json={"number":"5511999999999","text":"Compartilhe sua localização para entregarmos seu pedido:"},
)
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.