Enviar Mensagem
Enviar localização geográfica
/send/locationConta no limite de envio da conexão. Ao passar do limite, a resposta é 429.
Autenticação: envie a chave da conexão no header token ou em Authorization: Bearer.
Envia uma localização geográfica para um contato ou grupo.
Recursos Específicos
- Coordenadas precisas (latitude e longitude obrigatórias)
- Nome do local para identificação
- Endereço completo para exibição detalhada
- Mapa interativo no WhatsApp para navegação
- Pin personalizado com nome do local
Campos Comuns
Este endpoint suporta todos os campos opcionais comuns documentados na tag "Enviar Mensagem", incluindo: delay, readchat, readmessages, replyid, mentions, forward, track_source, track_id, placeholders e envio para grupos.
Exemplo Básico
{
"number": "5511999999999",
"name": "Maracanã",
"address": "Av. Pres. Castelo Branco - Maracanã, Rio de Janeiro - RJ",
"latitude": -22.912982815767986,
"longitude": -43.23028153499254
}Corpo da requisição (JSON)
| Campo | Tipo | Descrição |
|---|---|---|
| number* | string | ID do chat para o qual a mensagem será enviada. Pode ser um número de telefone em formato internacional, um ID de grupo ( Exemplo: 5511999999999 |
| name | string | Nome do local Exemplo: MASP |
| address | string | Endereço do local Exemplo: Av. Paulista, 1578 - Bela Vista, São Paulo - SP |
| latitude* | number | Latitude (-90 a 90) Exemplo: -23.5616 |
| longitude* | number | Longitude (-180 a 180) Exemplo: -46.6562 |
| replyid | string | ID da mensagem para responder Exemplo: 3EB0538DA65A59F6D8A251 |
| mentions | string | Números para mencionar (separados por vírgula) Exemplo: 5511999999999,5511888888888 |
| readchat | boolean | Marca conversa como lida após envio Exemplo: true |
| readmessages | boolean | Marca últimas mensagens recebidas como lidas Exemplo: true |
| delay | integer | Atraso em milissegundos antes do envio, durante o atraso apacerá 'Digitando...' Exemplo: 1000 |
| forward | boolean | Marca a mensagem como encaminhada no WhatsApp Exemplo: true |
| track_source | string | Origem do rastreamento da mensagem Exemplo: chatwoot |
| track_id | string | ID para rastreamento da mensagem (aceita valores duplicados) Exemplo: msg_123456789 |
| async | boolean | Se true, envia a mensagem de forma assíncrona via fila interna Exemplo: false |
* obrigatório
Respostas
- 200Localização enviada com sucesso
- 400Requisição inválida
- 401Não autorizado
- 429Limite de requisições excedido
- 500Erro interno do servidor
Experimente
Atenção: a chamada é real. Ela roda na sua conexão e pode enviar mensagem de verdade. A chave fica só nesta tela e some ao sair dela; nunca é guardada.