NODAPI

Enviar Mensagem

Solicitar localização do usuário

POST/send/location-button
  • Conta 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.

Este endpoint envia uma mensagem com um botão que solicita a localização do usuário. Quando o usuário clica no botão, o WhatsApp abre a interface para compartilhar a localização atual.

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.

Estrutura do Payload

{
  "number": "5511999999999",
  "text": "Por favor, compartilhe sua localização",
  "delay": 0,
  "readchat": true
}

Exemplo de Uso

{
  "number": "5511999999999",
  "text": "Para continuar o atendimento, clique no botão abaixo e compartilhe sua localização"
}

> Nota: O botão de localização é adicionado automaticamente à mensagem

Corpo da requisição (JSON)

CampoTipoDescriçã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 (@g.us), um ID de usuário (com @s.whatsapp.net ou @lid).

Exemplo: 5511999999999

text*string

Texto da mensagem que será exibida

Exemplo: Por favor, compartilhe sua localização

delayinteger

Atraso em milissegundos antes do envio

Exemplo: 0

readchatboolean

Se deve marcar a conversa como lida após envio

Exemplo: true

readmessagesboolean

Marca últimas mensagens recebidas como lidas

Exemplo: true

replyidstring

ID da mensagem para responder

Exemplo: 3EB0538DA65A59F6D8A251

mentionsstring

Números para mencionar (separados por vírgula)

Exemplo: 5511999999999,5511888888888

asyncboolean

Se true, envia a mensagem de forma assíncrona via fila interna

Exemplo: false

track_sourcestring

Origem do rastreamento da mensagem

Exemplo: chatwoot

track_idstring

ID para rastreamento da mensagem (aceita valores duplicados)

Exemplo: msg_123456789

* obrigatório

Respostas

  • 200Localização enviada com sucesso
  • 400Requisição inválida
  • 401Não autorizado
  • 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.

Cole a chave gerada no painel.