LinkedIn
Instagram
Telegrama
Gmail
Perspectivas
Google Agenda
Participe da comunidade do Slack Índice
O Link
Criar um Link
Além do Link
Links de Clique para Bate-papo do WhatsApp
API de link do WhatsApp: Como fazer wa.me e api.whatsapp.com Links Realmente Funcionam
Um link do WhatsApp é uma URL, e não uma API. Este guia fornece exatamente wa.me e api.whatsapp.com/send formatos, o text parâmetro, um gerador gratuito e o ponto onde o link termina e uma integração real precisa começar.
Teste gratuito de 7 dias, sem necessidade de cartão de crédito
Apenas uma URL
Sem autenticação, sem código
Olá! Eu tenho uma dúvida sobre o seu produto.
Abre o chat. Um ser humano ainda precisa pressionar enviar.
Definição
O que é uma API de link do WhatsApp?
Não existe uma API de links do WhatsApp.
https://wa.me/<number> e https://api.whatsapp.com/send?phone=<number> são URLs de clique para conversar: ao clicar em uma, abre-se uma conversa no WhatsApp. Elas exigem sem autenticação, sem conta de desenvolvedor e sem código. As APIs do WhatsApp são uma camada separada e começam exatamente onde o link termina.Critério
Um link do WhatsApp
A API do WhatsApp
Formatar
LinkUma URL que você pode colar em qualquer lugar
APIUm endpoint HTTP autenticado
Configuração
LinkNenhum. Funciona instantaneamente
APIVinculação de contas, uma chave de API, uma biblioteca cliente
O que acontece ao clicar / ligar
LinkAbre um chat e pode pré-preencher um campo de texto
APIEnvia, recebe e lista mensagens programaticamente
Quem atua
LinkUm humano aperta enviar
APISeu software age em nome da conta vinculada
Formatar
Qual é o formato exato do link wa.me?
O formato documentado é
https://wa.me/<number>, onde <number> é um número de telefone completo no formato internacional. A Central de Ajuda do WhatsApp afirma que você deve omitir quaisquer zeros, colchetes ou hífens.Usar: https://wa.me/1XXXXXXXXXX
Não use: https://wa.me/+001-(XXX)XXXXXXX O que guardar
Código do país mais o número de assinante, apenas dígitos. Sem o zero à frente
+. O que remover
Zeros à esquerda, espaços, hífens, parênteses. Nenhum deles pertence ao caminho.
Comparação
Qual é a diferença entre wa.me e api.whatsapp.com/send?
Ambos abrem a mesma conversa.
wa.me/ a forma curta está documentada na Central de Ajuda do WhatsApp, com o número no caminho. api.whatsapp.com/send?phone= o formato longo, ainda em uso generalizado, que carrega o número como um parâmetro de consulta.Anatomia de uma URL, segmento por segmento
https://wa.me/1XXXXXXXXXXOi
https://api.whatsapp.com/enviar?phone=1XXXXXXXXXXOlá
Anfitrião
Caminho fixo
O número
A mensagem
Critério
wa.me
api.whatsapp.com/send
Onde o número vive
wa.meNo caminho da URL
api.whatsapp.comNa
telefone parâmetro de consultaDocumentado na Central de Ajuda do WhatsApp
wa.meSim, este formato exato
api.whatsapp.comNão encontramos na página de ajuda atual
Comportamento observado
wa.meAbre o chat
api.whatsapp.comAbre o mesmo chat
Uma lacuna na documentação, não uma descontinuação. Não conseguimos encontrar uma página oficial e atual do WhatsApp ou da Meta que documente
api.whatsapp.com/send. Isso não significa que parou de funcionar: hoje, ambos os formatos redirecionam para a mesma conversa. Significa que a Central de Ajuda do próprio WhatsApp cobre apenas wa.me. Construa novos links no formato documentado.O parâmetro de texto
Como você adiciona uma mensagem predefinida a um link do WhatsApp?
Anexar
?text= seguido pela mensagem codificada em URL: https://wa.me/<number>?text=<urlencodedtext>. O texto cai no campo de entrada do chat, preenchido e editável.https://wa.me/1XXXXXXXXXX?text=Estouinteressadonoseucarroque está àvenda// sem número: abre um seletor de contatos em vez dissohttps://wa.me/?text=I'minquiringabouttheapartmentlisting Sem um número, o WhatsApp abre a lista de contatos do remetente em vez de um chat específico. O
Codificação, os determinados mapeamentos text ainda preenche automaticamente assim que um contato é selecionado. Personagem
Espaço
Nova linha
&
#
Codificado como
%20
%0A
%26
%23
Também vale a pena saber:
Construa o link no código + codifica para %2B. Para todo o mais, emojis incluídos, não construa a tabela você mesmo: chame encodeURIComponent() em JavaScript ou urllib.parse.quote() em Python. // JavaScriptconst number = "1XXXXXXXXXX";
const text = "Hi! I have a question.";
const link = `https://wa.me/${number}?text=${encodeURIComponent(text)}`;# Pythonfrom urllib.parse import quote
number, text = "1XXXXXXXXXX", "Olá! Eu tenho uma dúvida."
link = f"https://wa.me/{number}?text={quote(text)}"Ferramenta gratuita
Gerar seu link do WhatsApp
Insira um número e uma mensagem. Obtenha a wa.me o link api.whatsapp.com equivalente, o texto codificado, um trecho HTML e o botão oficial, tudo de uma vez.
Executa inteiramente no seu navegador. Nenhum número é enviado para um servidor.
Número internacional completo. Sem +, sem 0, sem espaços ou hífens.
Opcional. É inserido no campo de texto do chat, ainda editável pelo remetente.
link do wa.me
https://wa.me/15550123456?text=Hi!%20I%20have%20a%20question%20about%20your%20product.
equivalente ao api.whatsapp.com
https://api.whatsapp.com/send?phone=15550123456&text=Hi!%20I%20have%20a%20question%20about%20your%20product.
parâmetro de texto, codificado
Oi!Itenhoumadúvidasobreo seuproduto.
Trecho de HTML, pronto para colar
<a href="https://wa.me/15550123456?text=Hi!%20I%20have%20a%20question%20about%20your%20product." target="_blank" rel="noopener" aria-label="Conversar no WhatsApp">Conversar no WhatsApp</a>
Botão oficial "Conversar no WhatsApp"
Conversar no WhatsApp <a href="https://wa.me/15550123456?text=Hi!%20I%20have%20a%20question%20about%20your%20product." target="_blank" rel="noopener"><img src="whatsapp-icon.svg" alt=""> Conversar no WhatsApp</a>
Este link abre um chat. Ele não envia a mensagem, e seu produto não verá a resposta.
Um link do WhatsApp envia a mensagem?
Não. Um link de clique para conversar abre a conversa e preenche previamente o campo de texto. Nada é enviado até que a pessoa com o telefone pressione enviar.
A parte honesta
O que um link do WhatsApp não pode fazer?
Um link de clique para chat é sem estado. Seu produto nunca fica sabendo se o link foi clicado, se a mensagem foi enviada ou se o destinatário respondeu.
Onde o link para
Link clicado
Chat abre
Mensagem preenchida
Envio manual
Linkparadasaqui
Resposta recebida
Histórico da conversa
Evento de webhook
Atribuição por usuário
Sem confirmação de entrega ou leitura
Nenhuma resposta foi encaminhada de volta para sua aplicação
Sem histórico de conversas
Sem anexos
Sem gatilho no lado do servidor. É preciso um humano e um clique
Sem atribuição por usuário em um produto multilocatário
Falha silenciosa se o número não tiver uma conta do WhatsApp ativa
Comportamento diferente entre desktop, WhatsApp Web e celular
Sem criação ou gerenciamento de grupos. Um link abre apenas um bate-papo individual, veja o API de Grupo do WhatsApp limites para qualquer coisa relacionada a grupos
Um link não pode registrar cliques, respostas ou histórico. Uma API pode. Construir uma integração real com o WhatsApp
Cole o link
Como você faz para trazer a resposta de volta para o seu aplicativo?
Você precisa de uma API que mantenha uma sessão do WhatsApp. Existem duas rotas: Cloud API da Meta, o que requer uma conta comercial verificada, ou um API de conta conectada como o Unipile, onde o usuário final vincula sua própria conta do WhatsApp em nome do usuário autenticado, por código QR ou código de pareamento.
API do Meta CloudEmpresa verificada
Requer uma conta verificada do WhatsApp Business
Cobrado por mensagem desde 1º de julho de 2025, consulte o Preços da API do WhatsApp Business detalhamento
A janela de atendimento ao cliente de 24 horas ainda existe, ela determina o que é gratuito, não o que é cobrado
Criado para notificações em modelos em escala
Conta conectada, UnipileSem verificação
Cada usuário final vincula sua própria conta do WhatsApp, em nome do usuário autenticado
Por código QR ou código de pareamento, sem verificação do Meta Business
Lê e envia da caixa de entrada vinculada real, incluindo respostas
Mesmo padrão de connect, send, list, listen do LinkedIn, Instagram, Telegram, Gmail, Outlook e IMAP
// 1. Vincular a conta, em nome do usuário autenticado
const { qrCodeString } = await cliente.conta.conectarWhatsapp();// 2. Envie uma mensagem assim que vinculado
POST /api/v1/chats/{chat_id}/messages{ "texto": "Olá! O seu pedido foi enviado." }// 3. Receber respostas por meio de um webhook, sem polling{ "evento": "mensagem_recebida", "chat_id": "chat_182...", "mensagem": "Isso ainda está disponível?"}Para o guia completo de envio, payloads e tratamento de webhooks, consulte como enviar mensagens do WhatsApp via API. Referência do endpoint: developer.unipile.com/docs/whatsapp.
Decisão
Link, Cloud API ou conta conectada: qual deles você precisa?
Use um link quando um humano iniciar a conversa a partir de uma página que você controla. Use a API Cloud quando uma empresa verificada enviar notificações em modelo em escala. Use uma API de conta conectada quando seu produto precisar ler e enviar da caixa de entrada do WhatsApp do próprio usuário.
Critério
Link
API do Meta Cloud
Conta conectada
Quem inicia
LinkUm ser humano, de uma página que você controla
API de nuvemSua empresa envia primeiro, com modelo
Conta conectadaQualquer um dos lados, a partir da caixa de entrada vinculada
Autenticação necessária
LinkNenhum
API de nuvemConta comercial do Meta verificada
Conta conectadaCódigo QR ou código de pareamento, sem verificação comercial
Custo
LinkGrátis
API de nuvemPor mensagem, desde 1 de julho de 2025
Conta conectadaPreço do plano Unipile, não cobrado por mensagem
Recebe respostas
LinkNão
API de nuvemSim, via webhook
Conta conectadaSim, via webhook
Histórico da conversa
LinkNão
API de nuvemSim
Conta conectadaSim
Produtos multilocatários
LinkQuebras, um número fixo no código
API de nuvemNecessita de roteamento personalizado por número comercial
Conta conectadaNativo, uma conta vinculada por usuário final
Tempo de configuração
LinkMinutos
API de nuvemDe dias para semanas, Verificação de empresa
Conta conectadaMinutos para horas
Só preciso de um link
Use o gerador acima. Sem conta, sem configuração.
Enviando notificações baseadas em modelos
Veja o Integração com a API do WhatsApp Cloud guia.
Lendo e enviando por usuário
Comece com o guia completo da API do WhatsApp.
A maioria dos produtos supera o link em uma semana. Comece onde você realmente vai terminar. Comece a construir
Implementação
Como você insere um link do WhatsApp em um produto?
Gere o link no lado do servidor, por usuário, e nunca fixe um número de telefone em um produto multi-tenant. O link é apenas uma âncora, portanto ele pertence à sua camada de template, não à sua camada de API.
<a href="https://wa.me/{{ user.whatsapp_number }}?text={{ prefilled_text | url_encode }}"
alvo="_blank" rel="noopener"
aria-label="Conversar no WhatsApp"Conversar no WhatsAppa>Botão oficial
O WhatsApp publica um selo pronto "Conversar no WhatsApp", verde e branco, em alguns tamanhos fixos, destinado a ser usado sem modificações.
Conversar no WhatsApp Código QR
Qualquer gerador de código QR que aceite um URL transforma um
wa.me linkar em um código escaneável para impressão, embalagem ou sinalização física. Móvel Abre o aplicativo do WhatsApp diretamente, com o chat e o texto pré-preenchidos prontos.
Computador, aplicativo instalado Abre o aplicativo para desktop do WhatsApp em vez do navegador.
Computador, sem aplicativo Abre o WhatsApp Web no navegador e solicita um login por QR Code se a sessão ainda não estiver ativa.
Por que o link quebra em produtos multi-tenant: um único número fixo no código não consegue diferenciar seus clientes. Gere o link a partir do registro específico do usuário ou do espaço de trabalho a cada vez, para que ele carregue o número exato que aquele usuário realmente possui, e não um número colado uma única vez em um modelo.
Solução de problemas
Por que meu link do WhatsApp não está funcionando?
As duas causas mais comuns são um número de telefone que não está no formato internacional padrão e um
text parâmetro que não foi codificado para URL.CausaNúmero de telefone fora do formato internacional padrão
ConsertarUse o número internacional completo, apenas com dígitos: não
+, sem espaços iniciais 0, sem espaços, traços ou colchetes.CausaO parâmetro de texto não estava codificado em URL
ConsertarEncaminhe a mensagem
encodeURIComponent() em JavaScript ou urllib.parse.quote() em Python antes de adicioná-lo.CausaO número não possui uma conta ativa no WhatsApp
ConsertarO link ainda abre, mas o chat falha silenciosamente. Verifique primeiro se o número está realmente registrado no WhatsApp.
CausaAberto no navegador interno de um aplicativo de terceiros
ConsertarOs navegadores integrados de aplicativos de redes sociais ou plataformas de anúncios às vezes bloqueiam ou lidam mal com o redirecionamento. Abra o link no navegador do sistema.
CausaUm rastreador de pré-visualização de link reescreveu a URL
ConsertarAlguns sites envolvem links de saída em seus próprios redirecionamentos, o que pode remover a string de consulta. Teste o link bruto
wa.me URL diretamente.API do Link do WhatsApp - Perguntas Frequentes
Tudo o que os desenvolvedores perguntam sobre wa.me, api.whatsapp.com, o parâmetro text e onde o link para.
Não existe uma única API de links do WhatsApp. wa.me e api.whatsapp.com/send são URLs de clique para conversar: abrir uma delas inicia uma conversa no WhatsApp, sem necessidade de autenticação, conta de desenvolvedor ou código. As próprias APIs do WhatsApp são uma camada separada que começa exatamente onde o link termina, assim que a pessoa precisa responder.
O formato documentado é https://wa.me/<number>, onde <number> é o número de telefone completo em formato internacional. A Central de Ajuda do WhatsApp instrui a omitir quaisquer zeros à esquerda, colchetes, espaços ou traços, por exemplo https://wa.me/1XXXXXXXXXX.
Ambos abrem a mesma conversa. wa.me/ a forma curta está documentada na Central de Ajuda do WhatsApp, com o número no caminho do URL. api.whatsapp.com/send?phone= é o formato longo, ainda amplamente utilizado, que carrega o número como um parâmetro de consulta.
Não. Um link de clique para conversar abre a conversa e pode preencher previamente o campo de texto, mas nada é enviado até que a pessoa com o telefone em mãos pressione enviar.
Sim. Adicionar ?text= seguido por uma mensagem codificada em URL, por exemplo https://wa.me/1XXXXXXXXXX?text=Hi%2C%20I%20have%20a%20question. O texto cai no campo de entrada do chat, preenchido e ainda editável antes do envio. Experimente no gerador acima.
As duas causas mais comuns são um número de telefone que não está no formato internacional padrão e um text parâmetro que não foi codificado para URL. Verifique também se o número possui uma conta ativa do WhatsApp e se o link não foi aberto no navegador interno de um aplicativo de terceiros.
Não. A wa.me ou api.whatsapp.com/send o link não exige conta comercial, verificação nem acesso à API. A Plataforma do WhatsApp Business, ou Cloud API, é um produto verificado separado para empresas que precisam enviar notificações em modelo (template) em larga escala ou receber respostas programaticamente. Veja a guia completo da API do WhatsApp.
Um link em si não pode relatar respostas de volta para o seu aplicativo, ele é sem estado. Para ler e enviar de uma caixa de entrada real, você precisa de uma API que mantenha uma sessão do WhatsApp: seja a Cloud API da Meta com uma conta comercial verificada, ou uma API de conta conectada, como a Unipile, onde cada usuário final vincula sua própria conta do WhatsApp em nome do usuário autenticado, por código QR ou código de pareamento. Veja como enviar mensagens do WhatsApp via API.
Ainda não tem certeza se precisa de um link ou de uma API? Nossa equipe pode ajudar você a decidir.
BR 
EN 
FR 
ES 
DE 
IT 
NL 
PL 
TR