Como enviar localização no WhatsApp pelo Notifish

Quem tem endereço físico conhece a cena: o cliente pergunta onde fica, alguém digita a rua, o número e o complemento, e mesmo assim a pessoa liga dez minutos depois dizendo que está perdida. Endereço em texto é frágil — depende de quem digita, de quem lê e da interpretação de quem dirige.

A localização do WhatsApp elimina esse ruído. Em vez de um texto para interpretar, o cliente recebe um ponto no mapa que abre a rota com um toque. O que faltava era fazer isso em escala: mandar o mesmo ponto para uma lista inteira de clientes ou para dezenas de grupos, sem repetir o processo manualmente.

Neste guia você vai aprender a enviar localização no WhatsApp pelo Notifish — pelo painel ou pela API — com agendamento e envio para contatos ou grupos.

O que você consegue fazer

O envio de localização compartilha um ponto no mapa que, do lado de quem recebe, chega como uma localização nativa do WhatsApp. Cada localização é composta por:

• Latitude e longitude — as coordenadas exatas do ponto
• Título (opcional) — o nome do local que aparece no cartão, como “Nossa loja”

Um toque no cartão e o aplicativo de mapas do celular abre a rota. Nada de copiar endereço, nada de dúvida sobre o número.

Antes de começar: os pré-requisitos

Você precisa de uma instância de WhatsApp conectada — e de um detalhe que vale conferir antes de montar qualquer coisa: o envio de localização está disponível apenas nas instâncias do provedor mais novo (WAHA). Se a sua instância ainda estiver no provedor anterior, confirme a disponibilidade com o suporte antes de programar a campanha.

Como obter as coordenadas no Google Maps

Essa é a parte que costuma travar quem usa o recurso pela primeira vez, e a solução é simples. No Google Maps, clique com o botão direito sobre o ponto desejado (no celular, toque e segure). As coordenadas de latitude e longitude aparecem no topo do menu, prontas para copiar.

Vale posicionar o ponto com cuidado: coloque-o exatamente na entrada do estabelecimento, e não no meio do quarteirão. É essa precisão que faz o cliente parar na porta certa.

Enviando pelo painel: o passo a passo

No Notifish, a localização é um tipo de mensagem dentro de uma campanha — ou seja, ela aproveita tudo o que a campanha já oferece: seleção de destinatários, agendamento e relatório.

1. Crie ou abra uma campanha (para contatos ou para grupos) e vá em adicionar mensagem.
2. Em Tipo de conteúdo, marque a opção Localização.
3. Preencha os campos:
   • Latitude — por exemplo, -25.4284
   • Longitude — por exemplo, -49.2733
   • Título do local (opcional) — por exemplo, “Nossa loja”
4. Defina a data de envio e salve.

A localização é disparada junto com a campanha, na data agendada, para todos os contatos ou grupos selecionados.

Sobre edição: enquanto a mensagem não foi enviada, você pode alterá-la normalmente — corrigir uma coordenada, ajustar o título, mudar a data. Depois de enviada, ela não pode mais ser editada, apenas excluída. Por isso, antes de salvar, vale colar as coordenadas no Google Maps uma última vez e confirmar que o pino cai onde deveria.

Enviando pela API

Para quem quer disparar localizações a partir de um sistema próprio — um e-commerce enviando o ponto de retirada, um sistema de eventos mandando o local no dia anterior, uma logística compartilhando o endereço da entrega — há um endpoint dedicado, com autenticação via Bearer Token:

POST /api/v2/{instance_uuid}/whatsapp/send-location          # para contato
POST /api/v2/{instance_uuid}/whatsapp/send-location/groups   # para grupo

O corpo da requisição é enxuto:

{
  "recipient_phone": "5511999999999",
  "latitude": -25.4284,
  "longitude": -49.2733,
  "title": "Nossa loja"
}

• recipient_phone — número com DDI (para grupo, use o endpoint /groups com o id do grupo)
• latitude — valor entre -90 e 90
• longitude — valor entre -180 e 180
• title — nome do local (opcional)

O envio é assíncrono: a API confirma o recebimento na hora e a localização sai em seguida. A documentação completa está em /api/documentation.

Por que usar o envio de localização

O cliente chega sem se perder. Um toque abre a rota no aplicativo de mapas. Sem digitar endereço, sem confusão de número e complemento, sem aquela ligação pedindo referência.

Ideal para comércio, eventos e entregas. Loja física, ponto de retirada, local do evento, endereço da entrega — em todos esses casos, o ponto exato vale mais do que um texto que a pessoa precisa interpretar no trânsito.

Escala e agendamento. A mesma localização vai para toda a campanha de uma vez, na data que você escolher. É especialmente útil em dois momentos: avisar uma mudança de endereço para a base inteira e divulgar um ponto novo — situações em que mandar mensagem por mensagem seria inviável.

Perguntas frequentes

Preciso do endereço ou das coordenadas?

Das coordenadas (latitude e longitude). Você as obtém no Google Maps clicando com o botão direito sobre o ponto.

O título é obrigatório?

Não. Apenas latitude e longitude são obrigatórios — o título é o nome que aparece no cartão da localização.

A localização abre no mapa de quem recebe?

Sim. Ela chega como uma localização nativa do WhatsApp, que abre no aplicativo de mapas com um toque.

Funciona em grupo?

Sim, funciona tanto para contatos quanto para grupos.

Consigo editar depois de enviada?

Enquanto não foi enviada, sim. Depois de enviada, resta apenas excluir.

Conclusão

Enviar localização é um daqueles recursos pequenos que resolvem um problema desproporcionalmente grande: a diferença entre o cliente chegar e o cliente desistir muitas vezes está em quão fácil foi encontrar o lugar. Trocar o endereço em texto por um ponto no mapa elimina a interpretação — e, pelo Notifish, isso deixa de ser uma mensagem manual para virar parte de uma campanha, com agendamento e envio para toda a base de uma vez.

Se for usar pela primeira vez, faça o básico direito: pegue as coordenadas no Google Maps com o pino na entrada do estabelecimento, dê um título claro ao local e envie um teste para o seu próprio número antes de disparar para todo mundo.