--- title: "Localização no WhatsApp pela API: enviar e pedir" description: "Como enviar localização, pedir a localização do cliente com botão nativo e compartilhar localização em tempo real pela API não oficial do WhatsApp." url: "https://api-wa.me/blog/localizacao-whatsapp-api-enviar-pedir-tempo-real" language: "pt-BR" og:type: "article" og:site_name: "WAME API" --- [Início](https://api-wa.me/)/[Blog da API do WhatsApp](https://api-wa.me/blog)/Localização no WhatsApp pela API: enviar, pedir e compartilhar em tempo real Raphael Serafim· Publicado em 28 de setembro de 2026· 8 min de leitura Compartilhar # Localização no WhatsApp pela API: enviar, pedir e compartilhar em tempo real Como enviar localização, pedir a localização do cliente com botão nativo e compartilhar localização em tempo real pela API não oficial do WhatsApp. Copiar para LLM[Ver como Markdown](https://api-wa.me/blog/localizacao-whatsapp-api-enviar-pedir-tempo-real.md) **Pela API não oficial do WhatsApp você resolve localização em três direções: envia um pin com `POST /{key}/message/location`, pede a posição do cliente com um botão nativo em `POST /{key}/message/location-request` e compartilha localização ao vivo com `POST /{key}/message/live-location`. É o que transforma "me manda o endereço certinho?" em um toque — para delivery, visita técnica, retirada em loja e qualquer operação que depende de onde as pessoas estão.** Endereço digitado à mão é fonte clássica de erro: número trocado, bairro errado, "é a casa do portão azul". Coordenadas não erram. Neste guia você vê os três endpoints, um fluxo completo de entrega e os cuidados para usar localização sem invadir ninguém. > A camada não oficial da WAME é independente e não é afiliada, endossada ou suportada pelo WhatsApp ou pela Meta. O uso é de responsabilidade de quem envia. ## Os três jeitos de usar localização | O que você quer | Endpoint | Quem compartilha | | --- | --- | --- | | Mostrar onde fica a loja, o evento, o ponto de retirada | `POST /message/location` | Você | | Saber exatamente onde o cliente está | `POST /message/location-request` | O cliente, com um toque | | Deixar o cliente acompanhar quem está a caminho | `POST /message/live-location` | Você, em tempo real | Todos seguem o mesmo padrão da API: `POST` para `https://us.api-wa.me/{key}/...`, `Content-Type: application/json` e o destinatário em `to` (telefone com DDI, grupo terminado em `@g.us` ou LID). ## Enviar uma localização fixa É o pin clássico: o cliente vê um mapa, o nome do lugar e o endereço, e toca para abrir no app de mapas. bash Copiar ``` curl -X POST "https://us.api-wa.me/SUA_KEY/message/location" \ -H "Content-Type: application/json" \ -d '{ "to": "5511999999999", "location": { "latitude": -23.5874, "longitude": -46.6576, "name": "Loja Vila Mariana", "address": "Rua Domingos de Morais, 1000 - Vila Mariana, São Paulo - SP" } }' ``` Só `latitude` e `longitude` são obrigatórios, mas preencha `name` e `address`: é o que o cliente lê antes de abrir o mapa, e evita a pergunta "é aquela loja da esquina?". Onde isso aparece no dia a dia: - **Resposta automática a "onde vocês ficam?"** — o bot detecta a pergunta e responde com o pin, não com um texto de endereço. - **Confirmação de agendamento** — "Seu horário é amanhã às 14h, aqui" + localização da clínica. - **Ponto de retirada** — pedido pronto, pin do balcão de retirada. - **Eventos** — combine com [convite de evento pela API](https://api-wa.me/blog/convite-evento-whatsapp-api) para mandar data e lugar juntos. Se você tem várias unidades, a mesma chamada resolve "qual a loja mais perto?": pergunte o bairro ou peça a localização (próxima seção), calcule a unidade mais próxima e envie o pin dela. ## Pedir a localização do cliente com um botão Este é o recurso que mais economiza atendimento. Em vez de pedir o endereço por texto, você envia um pedido nativo: o cliente vê sua mensagem com um botão para compartilhar a localização e só precisa tocar. bash Copiar ``` curl -X POST "https://us.api-wa.me/SUA_KEY/message/location-request" \ -H "Content-Type: application/json" \ -d '{ "to": "5511999999999", "text": "Para calcular o frete certinho, toque no botão e compartilhe sua localização 📍" }' ``` O `text` é obrigatório e deve dizer **por que** você está pedindo. Pedido de localização sem contexto assusta; com motivo claro ("calcular o frete", "mandar o técnico certo"), é serviço. Um detalhe que vale para qualquer mensagem interativa: se a conversa ainda está fria — o cliente nunca falou com o número —, abra com um texto antes do pedido. No fluxo normal de delivery isso nem aparece, porque é o cliente que chama primeiro. O porquê está em [como aquecer um número](https://api-wa.me/blog/aquecer-numero-whatsapp-api-nao-oficial). ## Receber a localização no webhook Quando o cliente compartilha, a posição chega no mesmo webhook das mensagens, no envelope `meta`, como uma mensagem de tipo localização com as coordenadas. Os nomes exatos dos campos estão na [documentação](https://api-wa.me/docs); o importante é isolar a leitura numa função, como fizemos no [bot do zero](https://api-wa.me/blog/criar-bot-whatsapp-api-nao-oficial): javascript Copiar ``` function extrairLocalizacao(body) { const msg = body?.entry?.[0]?.changes?.[0]?.value?.messages?.[0]; if (!msg || msg.type !== 'location') return null; // Ajuste os campos conforme o formato descrito em /docs. const loc = msg.location; return { de: msg.from, lat: loc?.latitude, lng: loc?.longitude, messageId: msg.id, }; } ``` Com a coordenada em mãos, o resto é lógica sua: javascript Copiar ``` // Distância em km entre dois pontos (fórmula de haversine) function distanciaKm(a, b) { const R = 6371; const rad = (g) => (g * Math.PI) / 180; const dLat = rad(b.lat - a.lat); const dLng = rad(b.lng - a.lng); const h = Math.sin(dLat / 2) ** 2 + Math.cos(rad(a.lat)) * Math.cos(rad(b.lat)) * Math.sin(dLng / 2) ** 2; return 2 * R * Math.asin(Math.sqrt(h)); } const LOJA = { lat: -23.5874, lng: -46.6576 }; const km = distanciaKm(LOJA, { lat: loc.lat, lng: loc.lng }); const frete = km <= 3 ? 'grátis' : `R$ ${(km * 1.5).toFixed(2)}`; // sua regra ``` A distância em linha reta é uma aproximação; se o frete precisa da distância de rota, passe as coordenadas para o serviço de mapas que você já usa. O ganho continua o mesmo: nada de endereço digitado errado. ## Compartilhar localização em tempo real A localização ao vivo é o "acompanhe seu pedido" dentro do WhatsApp. Você envia uma posição que o app do cliente mostra como localização em tempo real: bash Copiar ``` curl -X POST "https://us.api-wa.me/SUA_KEY/message/live-location" \ -H "Content-Type: application/json" \ -d '{ "to": "5511999999999", "latitude": -23.5505, "longitude": -46.6333, "caption": "Seu pedido saiu! O entregador está a caminho 🛵" }' ``` Casos em que ela vale a pena: - **Entrega** — o cliente para de mandar "já saiu?" a cada cinco minutos. - **Visita técnica** — "o técnico está a 10 minutos" com o mapa junto evita cliente fora de casa. - **Transporte e traslado** — motorista chegando ao ponto de encontro. Cuidado de privacidade: a localização ao vivo é de quem está se deslocando — o entregador, o técnico. Combine isso com a equipe, deixe claro quando o compartilhamento começa e termina, e não use para monitorar funcionário fora do serviço. ## Um fluxo completo de delivery Juntando as peças, um atendimento de delivery fica assim: 1. **Cliente chama** — "quero pedir". 2. **Bot responde e pede a localização** com `location-request`, explicando que é para o frete. 3. **Webhook recebe as coordenadas**; o sistema calcula distância, frete e unidade mais próxima. 4. **Bot confirma** o pedido com valor e prazo (texto ou botões — a conversa já está quente). 5. **Pedido sai**: `live-location` com a legenda "saiu para entrega". 6. **Entregue**: mensagem de confirmação e, se fizer sentido, uma [pesquisa de satisfação](https://api-wa.me/blog/pesquisa-satisfacao-enquete-whatsapp-api). Tudo isso acontece numa conversa que **o cliente iniciou**. É o uso mais seguro possível da API não oficial: o volume acompanha os pedidos reais, as mensagens são esperadas e ninguém denuncia a pizzaria que avisou que a pizza saiu. É por isso que, nesse tipo de operação, a taxa de bloqueio é muito baixa para quem usa do jeito certo. Os fundamentos estão em [o que derruba um número](https://api-wa.me/blog/api-whatsapp-nao-oficial-bane-o-que-derruba-numero). ## Boas práticas com localização - **Sempre explique o motivo** ao pedir a localização. Pedido sem contexto parece golpe. - **Não guarde mais do que precisa.** Coordenada de entrega é dado pessoal; guarde vinculada ao pedido, pelo tempo necessário, e siga a sua política de privacidade. O contrato com cliente e a LGPD estão em [API de WhatsApp e LGPD](https://api-wa.me/blog/whatsapp-api-lgpd-contrato-cliente). - **Tenha fallback em texto.** Nem todo cliente compartilha — aceite o endereço digitado e siga o fluxo. - **Nada de pedido em massa.** Mandar pedido de localização para uma lista de quem não está comprando nada é abordagem não solicitada. A WAME não apoia esse uso, e ele derruba número rápido. - **Grupos também recebem pin.** Para um evento ou uma turma, mandar a localização no grupo (`to` com `@g.us`) economiza dezenas de "onde é?". ## Conclusão Localização é um daqueles recursos pequenos que resolvem um problema grande: endereço errado, cliente perguntando onde fica, entrega sem visibilidade. Com a API não oficial da WAME você envia o pin da loja com `message/location`, pede a posição do cliente com um toque via `message/location-request` e deixa ele acompanhar a entrega com `message/live-location` — tudo no mesmo padrão de chamada, dentro da conversa que o próprio cliente abriu. Os campos completos estão na [documentação](https://api-wa.me/docs), e o panorama dos recursos da camada não oficial está em [API do WhatsApp não oficial: vantagens](https://api-wa.me/blog/api-whatsapp-nao-oficial-vantagens). ### Pronto para automatizar seu WhatsApp? Crie sua conta gratuita e comece a enviar mensagens pela API em minutos. [Começar grátis](https://portal.api-wa.me/sign-up) ## Perguntas frequentes Como enviar uma localização pelo WhatsApp via API?+ Faça POST /{key}/message/location com o destinatário em to e um objeto location com latitude, longitude e, opcionalmente, name e address. O cliente recebe o pin no mapa, com o nome do lugar e o endereço, e abre direto no app de mapas. Dá para pedir a localização do cliente pela API?+ Sim. O endpoint POST /{key}/message/location-request envia um pedido nativo de localização com um texto seu. O cliente toca no botão e compartilha a posição, que chega no seu webhook como mensagem do tipo localização. A API envia localização em tempo real?+ Sim. POST /{key}/message/live-location compartilha uma localização ao vivo com latitude, longitude e uma legenda opcional. É útil em entregas e visitas técnicas, para o cliente acompanhar quem está a caminho. Onde chega a localização que o cliente compartilhou?+ No mesmo webhook de mensagens, como uma mensagem de tipo localização, com as coordenadas. O formato exato dos campos está na documentação da API em /docs. A partir daí você calcula frete, distância ou atribui a entrega ao entregador mais próximo. Pedir localização do cliente é seguro para o número?+ Sim, quando faz parte de um atendimento que o cliente iniciou ou de um pedido em andamento. Pedir localização para listas frias é abordagem não solicitada, é denunciada e não é um uso que a WAME apoia. ## Continue lendo [### Agente de voz no WhatsApp: latência, interrupção (barge-in) e silêncio Como deixar um agente de voz no WhatsApp natural: latência, streaming, detecção de fala, interrupção (barge-in), silêncio e eco, com exemplos em Node.js.](https://api-wa.me/blog/agente-voz-whatsapp-latencia-interrupcao)[### Anti-detecção na API não oficial do WhatsApp: como a WAME protege seu número Como funciona a camada de anti-detecção da API não oficial da WAME: identidade de dispositivo, tempo humano, ritmo de envio, reconexão e monitor de saúde.](https://api-wa.me/blog/anti-deteccao-api-whatsapp-nao-oficial)[### API do WhatsApp em C# (.NET): enviar mensagens e receber webhook Tutorial de API do WhatsApp em C# e .NET: HttpClient tipado, envio de texto, imagem e lista, webhook em ASP.NET Core com fila em background e tratamento de 429.](https://api-wa.me/blog/api-whatsapp-csharp-dotnet) [Voltar ao blog](https://api-wa.me/blog) ## Structured data ```json { "@context": "https://schema.org", "@type": "WebSite", "name": "WAME API", "alternateName": "API Oficial e Não Oficial de WhatsApp, Instagram, Messenger e Telegram", "url": "https://api-wa.me", "inLanguage": "pt-BR", "publisher": { "@id": "https://api-wa.me/#organization", "@type": "Organization", "name": "WAME API", "url": "https://api-wa.me" } } { "@context": "https://schema.org", "@type": "Organization", "@id": "https://api-wa.me/#organization", "name": "WAME API", "alternateName": [ "WAME", "Wame API", "wame.api.br", "api-wa.me" ], "url": "https://api-wa.me", "logo": { "@type": "ImageObject", "url": "https://api-wa.me/images/web-app-manifest-512x512.png", "width": 512, "height": 512 }, "disambiguatingDescription": "WAME API é uma empresa brasileira de software, fundada em 2017 e parceira oficial da Meta (Meta Business Partner), que fornece APIs de WhatsApp, Instagram Direct e Messenger. Não tem relação com o wa.me, que é o encurtador de links operado pela WhatsApp LLC.", "identifier": { "@type": "PropertyValue", "propertyID": "INPI-BR", "name": "Pedido de registro de marca (INPI, classe NCL 42)", "value": "944724159" }, "foundingDate": "2017", "slogan": "Parceira Oficial da Meta — WhatsApp, Instagram, Messenger e Telegram numa instância só. Desde 2017.", "description": "Plataforma brasileira e Parceira Oficial da Meta (Meta Business Partner) para as APIs oficiais de WhatsApp (Cloud API), Instagram Direct e Messenger — os três numa única instância, com os mesmos endpoints e um único formato de webhook. Também oferece a API não oficial via QR Code e o Telegram, na mesma plataforma. No mercado desde 2017, com mais de 50 mil instâncias criadas, 99,9% de uptime e suporte humano 24/7 em português. SDKs oficiais para Node.js/TypeScript e PHP.", "knowsAbout": [ "WhatsApp Cloud API oficial (Meta)", "API oficial de Instagram (Direct)", "API oficial de Messenger", "API multicanal Meta", "Meta Business Partner", "WhatsApp API", "API não oficial de WhatsApp", "automação de WhatsApp", "números virtuais", "webhooks" ], "sameAs": [ "https://github.com/wame-api", "https://www.linkedin.com/company/wameapi", "https://www.instagram.com/wame.api/", "https://www.youtube.com/@wameapi" ], "contactPoint": { "@type": "ContactPoint", "contactType": "customer support", "url": "https://api-wa.me/contact", "availableLanguage": [ "Portuguese" ] } } { "@context": "https://schema.org", "@type": "BlogPosting", "headline": "Localização no WhatsApp pela API: enviar, pedir e compartilhar em tempo real", "description": "Como enviar localização, pedir a localização do cliente com botão nativo e compartilhar localização em tempo real pela API não oficial do WhatsApp.", "image": "https://api-wa.me/blog/localizacao-whatsapp-api-enviar-pedir-tempo-real/opengraph-image", "datePublished": "2026-09-28", "dateModified": "2026-09-28", "author": { "@type": "Person", "name": "Raphael Serafim", "url": "https://github.com/raphaelvserafim", "sameAs": [ "https://github.com/raphaelvserafim" ] }, "publisher": { "@type": "Organization", "name": "api-wa.me", "logo": { "@type": "ImageObject", "url": "https://api-wa.me/images/screenshot.png" } }, "mainEntityOfPage": { "@type": "WebPage", "@id": "https://api-wa.me/blog/localizacao-whatsapp-api-enviar-pedir-tempo-real" }, "keywords": "api whatsapp não oficial, api não oficial whatsapp, enviar localização whatsapp api, pedir localização whatsapp, localização em tempo real whatsapp api, whatsapp api location, whatsapp entrega localização", "inLanguage": "pt-BR" } { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://api-wa.me" }, { "@type": "ListItem", "position": 2, "name": "Blog da API do WhatsApp", "item": "https://api-wa.me/blog" }, { "@type": "ListItem", "position": 3, "name": "Localização no WhatsApp pela API: enviar, pedir e compartilhar em tempo real", "item": "https://api-wa.me/blog/localizacao-whatsapp-api-enviar-pedir-tempo-real" } ] } { "@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Como enviar uma localização pelo WhatsApp via API?", "acceptedAnswer": { "@type": "Answer", "text": "Faça POST /{key}/message/location com o destinatário em to e um objeto location com latitude, longitude e, opcionalmente, name e address. O cliente recebe o pin no mapa, com o nome do lugar e o endereço, e abre direto no app de mapas." } }, { "@type": "Question", "name": "Dá para pedir a localização do cliente pela API?", "acceptedAnswer": { "@type": "Answer", "text": "Sim. O endpoint POST /{key}/message/location-request envia um pedido nativo de localização com um texto seu. O cliente toca no botão e compartilha a posição, que chega no seu webhook como mensagem do tipo localização." } }, { "@type": "Question", "name": "A API envia localização em tempo real?", "acceptedAnswer": { "@type": "Answer", "text": "Sim. POST /{key}/message/live-location compartilha uma localização ao vivo com latitude, longitude e uma legenda opcional. É útil em entregas e visitas técnicas, para o cliente acompanhar quem está a caminho." } }, { "@type": "Question", "name": "Onde chega a localização que o cliente compartilhou?", "acceptedAnswer": { "@type": "Answer", "text": "No mesmo webhook de mensagens, como uma mensagem de tipo localização, com as coordenadas. O formato exato dos campos está na documentação da API em /docs. A partir daí você calcula frete, distância ou atribui a entrega ao entregador mais próximo." } }, { "@type": "Question", "name": "Pedir localização do cliente é seguro para o número?", "acceptedAnswer": { "@type": "Answer", "text": "Sim, quando faz parte de um atendimento que o cliente iniciou ou de um pedido em andamento. Pedir localização para listas frias é abordagem não solicitada, é denunciada e não é um uso que a WAME apoia." } } ] } ```