Configuração: Integrações, cartão de ações do site · Endereço: /integracoes · Menu: Conta → Integrações
O handoff é a passagem da conversa do site para o WhatsApp. O agente mostra o botão Continuar no WhatsApp; o visitante toca e cai numa conversa já iniciada com a sua equipe.
Configurar
No cartão de ações do site, três campos governam o handoff:
Números de destino
Um número por linha, no formato internacional (+55…). Os leads são distribuídos entre eles em rodízio quando o lead ainda não tem vendedor.
São aceitos até 20 números, e números repetidos são recusados com "Há números repetidos na lista". A mensagem pré-preenchida vai até 300 caracteres.
+5511999990001
+5511999990002
Mensagem pré-preenchida
O texto que já vem escrito na conversa do WhatsApp. O padrão é:
Oi! Vim do site e quero continuar por aqui. (cód. {codigo})
Dois marcadores podem ser usados:
| Marcador | Vira |
|---|---|
{codigo} |
O código de atendimento desta conversa. |
{nome_agente} |
O nome do agente configurado no site. |
Nada do visitante entra neste texto — nem nome, nem e-mail, nem telefone. O motivo é direto: essa URL é aberta pelo navegador do visitante e vai parar no histórico do aparelho, no WhatsApp Web e em qualquer captura de tela. É superfície pública, não banco de dados.
Se você apagar o {codigo} da mensagem, o código é acrescentado ao fim mesmo assim — sem ele o atendimento perderia o vínculo com a conversa do site.
O código de atendimento
O código tem o formato DL-XXXXXXXX: o prefixo DL- seguido de 8 símbolos.
Três características deliberadas:
- É opaco. Não carrega nenhum dado do visitante — só serve para casar as duas conversas.
- É legível em voz alta. O alfabeto exclui as letras
I,L,OeU, que se confundem com números ao serem ditadas ou digitadas. - É difícil de adivinhar. São 8 símbolos de um alfabeto de 32 — mais de um trilhão de combinações. Ele é a única credencial de um link público, e por isso precisa desse tamanho.
Os códigos valem por 7 dias.
Como o número de destino é escolhido
A ordem de precedência é sempre a mesma:
- O vendedor decidido pelo roteamento, se ele tiver WhatsApp cadastrado.
- O vendedor que já é dono do lead, se houver.
- Um dos números do site, escolhido em rodízio circular.
Um número mal formado (sem DDD, sem 9 no celular, sem código de país num número estrangeiro) simplesmente sai do rodízio — os demais continuam atendendo. É melhor um número a menos do que um botão que não abre conversa nenhuma.
Uma conversa que já tem código não gira o rodízio de novo: o número que vale é o do código que o visitante já recebeu, mesmo que a roleta agora aponte para outro. Isso evita que o visitante seja mandado a um número diferente a cada mensagem.
O redirecionador /r/wa/
O botão do widget não aponta direto para o WhatsApp: ele passa pelo endereço /r/wa/<código> do Data Lead. Esse desvio existe por um motivo — é ele que registra o clique como conversão.
O que acontece nesse instante:
- O clique é marcado uma única vez, mesmo com toques repetidos.
- O evento Handoff no WhatsApp entra na linha do tempo da conversa, registrando de onde veio o número.
- O visitante é redirecionado ao
wa.mecom o texto pré-preenchido.
O link não exige login algum — o código é a única credencial. Por isso a rota é conservadora: tem freio contra tentativas em série, não guarda cache e responde exatamente a mesma página para um código inexistente e para um expirado:
Link indisponível — Este link não está mais ativo. Volte ao site e converse de novo com o agente.
O que o vendedor recebe
No WhatsApp, o vendedor recebe uma mensagem do próprio visitante com o texto configurado e o código. Por exemplo:
Oi! Vim do site e quero continuar por aqui. (cód. DL-7K2M4XQ9)
Todo o contexto — quem é, o que perguntou, o que já informou — está no painel. Com o código em mãos, o time encontra a conversa em Conversas e o registro em Leads.
Iniciar o handoff pelo painel
Você não precisa esperar o visitante clicar:
- No detalhe da conversa, o bloco WhatsApp tem o botão Abrir WhatsApp: ele gera o atendimento, abre o
wa.menuma nova aba e mostra o código, com um link para copiar. - Na tela Leads, o ícone de WhatsApp na coluna Ações faz o mesmo por lead.
Nesses casos o link abre o WhatsApp diretamente, sem passar pelo redirecionador: o clique e a conversão continuam sendo do visitante, não seus.
Quando o agente usa o WhatsApp
O handoff acontece nas situações previstas no playbook:
- a ação Levar para o WhatsApp em "Quando qualifica" ou "Quando não qualifica";
- o visitante pedir para falar com uma pessoa;
- o agendamento de reunião não dar certo (sem horários livres, ou o visitante não escolher nenhum) — o agente degrada para o WhatsApp em vez de deixar a conversa travada.
Sem nenhum número configurado, o agente não mostra botão quebrado: ele pede o telefone do visitante e diz que alguém entra em contato.
Veja também
Precisa de ajuda?
Fale com o suporte da Data Stone pelo canal combinado no seu contrato.
Ao relatar um problema de handoff, informe o código de atendimento (DL-…) do caso.