Pular para o conteúdo principal
POST
Enviar localização
Envia uma localização para um cliente com a janela de 24 horas aberta. O cliente vê o ponto no mapa e pode abrir o local no aplicativo de mapas do celular.
O destinatário pode ser informado pelo número de telefone (to) ou pelo ID do usuário (recipient). Se os dois forem enviados, vale o to; para enviar pelo ID do usuário, deixe o to em branco. Veja a diferença em Destinatário.

Coordenadas

location.latitude e location.longitude são obrigatórios e usam graus decimais, como -23.561414 e -46.655881. No Brasil, os dois valores são negativos. location.name e location.address são opcionais e ajudam o cliente a identificar o local.
Para pegar as coordenadas de um endereço, abra o Google Maps, clique com o botão direito no local e clique nos números que aparecem no topo do menu. Eles são copiados no formato latitude, longitude.
No Testar, a localização já vem preenchida com o MASP, na Avenida Paulista. Troque pelas coordenadas do seu local. Veja mais detalhes na documentação de mensagens de localização da Meta.

Autorizações

Authorization
string
header
obrigatório

Token gerado no painel da Datafy ao criar o canal. Formato: sk_live_xxx.

Parâmetros de caminho

phone_number_id
string
obrigatório

ID do número que envia a mensagem. Descubra com GET /me.

Corpo

application/json
messaging_product
enum<string>
padrão:whatsapp
obrigatório

Sempre whatsapp.

Opções disponíveis:
whatsapp
Exemplo:

"whatsapp"

to
string
obrigatório

Número do destinatário com código do país e DDD, como 5511999999999. Tem prioridade sobre recipient: para enviar pelo ID do usuário, deixe em branco.

Exemplo:

"5511999999999"

type
enum<string>
padrão:location
obrigatório

Sempre location.

Opções disponíveis:
location
Exemplo:

"location"

location
object
obrigatório

Ponto no mapa enviado ao cliente.

recipient_type
enum<string>
padrão:individual

Sempre individual.

Opções disponíveis:
individual
Exemplo:

"individual"

recipient
string

ID do usuário no WhatsApp (BSUID), recebido nos webhooks em from_user_id e contacts[].user_id, como BR.13491208655302741918. Usado quando to não é informado.

context
object

Responde citando uma mensagem anterior da conversa.

Resposta

Envio aceito pela Meta. Não confirma a entrega.