WhatsApp

O que é um link click-to-chat do WhatsApp e como criar um?

Um link click-to-chat do WhatsApp abre uma conversa com o seu número; crie-o com https://wa.me/ seguido dos dígitos do seu número internacional.

Um visitante do site pode iniciar uma conversa de suporte sem antes salvar o seu número. O link fornece o destino. Ele também pode sugerir a primeira mensagem para o visitante enviar.

WhatsApp abre uma conversa com o número no link. Nenhuma mensagem é enviada automaticamente.

Qualquer texto preenchido aparece no compositor, onde a pessoa pode editá-lo. Considere uma consulta como recebida somente depois que ela enviar a mensagem.

Use um destino no qual sua equipe de suporte possa receber mensagens. Um link apontando para o número errado abre a conversa errada mesmo quando a URL é válida.

Coloque o número internacional completo após https://wa.me/, usando dígitos sem o sinal de mais, parênteses ou hífens.

O formato de link do WhatsApp usa o código do país como parte do número. Converta o número para o formato internacional antes de remover a formatação.

Adicione ?text=urlencodedtext quando quiser preencher uma mensagem. Substitua urlencodedtext pelo seu texto codificado, incluindo espaços codificados.

O formato de mensagem preenchida insere esse valor no campo de texto do chat. Ele não autoriza nem envia o texto em nome da pessoa.

Um link usando https://wa.me/?text=urlencodedtext não tem número de destinatário. É um formulário de compartilhamento, então use o formato com número quando o destino precisa ser o seu negócio.

Use um link curto quando precisar alterar a mensagem preenchida após publicar o link.

O serviço de links curtos da Meta armazena esse texto separadamente da URL. Seu formato https://wa.me/message/<code> usa um código no lugar do número.

Você pode gerenciar QR codes e seus links curtos pelo WhatsApp Business Management API ou pelo Business Manager. Editar a mensagem armazenada não exige substituir um link impresso.

A Meta limita mensagens preenchidas a 140 caracteres. Mantenha a consulta sugerida dentro desse limite antes de criar o código.

Um número de telefone comercial pode ter no máximo 2.000 QR codes e links curtos combinados. Reutilize links adequados em vez de criar um para cada visita.

Excluir um código torna seu link inutilizável. Verifique onde ele está publicado antes de retirar um que os clientes ainda possam escanear.

Um botão de URL de template pode abrir outro chat do WhatsApp?

Não. A Meta rejeita botões de URL de template que direcionam de volta para o WhatsApp.

Bird verifica wa.me e whatsapp.com, incluindo subdomínios como api.whatsapp.com e chat.whatsapp.com, antes do envio. Alternar entre esses hosts não contorna a restrição.

Use um destino fora do WhatsApp para esse botão de template. Para opções dentro de uma conversa, use o tipo de mensagem interativa aplicável.

Mantenha a validação do botão de template separada da criação do link. Uma URL click-to-chat válida ainda pode ser inadequada para um botão de template.

O que minha integração deve fazer depois que o cliente enviar?

Receba a mensagem de entrada. Trate a conversa dentro da janela de atendimento ao cliente.

A mensagem do cliente inicia a janela de 24 horas para respostas em formato livre. Abrir o link sozinho não comprova que uma mensagem foi enviada.

Mantenha qualquer permissão de marketing separada do toque no link. Uma pessoa fazendo uma pergunta de suporte não concordou, por isso, com mensagens promocionais posteriores.

Antes de comprar um número de destino para o fluxo de configuração do Bird, execute a verificação prévia de número do WhatsApp. Um link formatado corretamente não garante que WhatsApp aceite o número de destino.

Em resumo

  1. Abrir o chat não envia nada.

    Uma mensagem preenchida permanece no compositor até a pessoa enviá-la. Registre uma consulta a partir da mensagem recebida.

  2. Use os dígitos do número internacional.

    Coloque o código do país e o número após wa.me/. Omita o sinal de mais, parênteses e hífens.

  3. Codifique o texto opcional da mensagem.

    O parâmetro text fornece a mensagem inicial do compositor. Codifique o valor antes de adicioná-lo ao link.

  4. Escolha um link curto para texto editável.

    A Meta armazena a mensagem preenchida de um link curto separadamente. Você pode alterar esse texto sem substituir o link publicado.

Construa na mesma rede.

Uma chave de API de teste é sua imediatamente. A produção é desbloqueada quando adicionar um método de pagamento e verificar um remetente.

Comece com um canal.
Adicione os outros quando estiver pronto.

Uma chave API de teste é sua imediatamente. A produção é desbloqueada quando você adiciona um método de pagamento e verifica um remetente.

Usa Claude Code, Cursor ou Codex? Copie um prompt de configuração e o seu agente instala o Bird CLI e as skills por si. Escolha o seu:

Cursor