🎯 Para que serve esta função?
WhatsApp permite que os usuários ocultarem seu número telefônico através do uso de nomes de usuário por motivos de privacidade. Quando isso ocorre, o Atom identifica o cliente através de um código único interno chamado BSUID.
Não se preocupe! A conversa não será perdida. Você poderá continuar chatando, enviando templates e gerenciando o cliente normalmente a partir da Caixa de Entrada. Esta funcionalidade permite que você solicite formalmente seu contato através de uma mensagem interativa para atualizar sua base de dados automaticamente.
📋 Requisitos Prévios
Antes de começar a configurar o fluxo de solicitação, certifique-se de atender aos seguintes requisitos no seu ambiente:
Você tem um papel de Administrador na plataforma (necessário apenas para a Fase 1 de criação de templates).
Sua conta de WhatsApp Business está ativa e aprovada para enviar templates nas categorias de Utility ou Marketing.
⚙️ Fase 1: Criar o template de solicitação (Administradores)
Vá ao módulo de Configurações > Templates para habilitar a ferramenta a partir de sua conta.
Crie um novo template (deve pertencer à categoria Utility ou Marketing) ou edite o template genérico predefinido.
Dirija-se à seção de botões e escolha a opção: "Solicitar informação do contato".
Envie o template para revisão do Meta.
⚠️ Importante: Apenas um único botão deste tipo é permitido por template e não é possível combiná-lo com outros botões interativos. Além disso, não deve ser incluído cabeçalho nem rodapé para garantir a validação correta pelo Meta.
💬 Fase 2: Solicitar o contato a partir da Caixa de Entrada (Assessores)
Se você atender a um cliente que tem seu número oculto (BSUID), visualizará um aviso indicando "Contato não compartilhado" na parte superior do chat ou no painel de informações à direita. Clique no botão Solicitar.
O comportamento do botão se adaptará de forma inteligente de acordo com o estado da janela de atendimento:
Cenário A: Se a janela de conversa está ATIVA
Ao pressionar "Solicitar", o painel de templates não será mais aberto. Em seu lugar, aparecerá um modal de confirmação simples.
Você pode editar o texto padrão do corpo da mensagem dentro do modal antes de enviá-lo (o botão e o cabeçalho são fixos e não podem ser modificados).
Ao confirmar, uma mensagem interativa será enviada imediatamente com o botão "Solicitar contato" diretamente no chat, sem consumir templates.
💡 Dica: Esta mensagem direta não tem limite de reenviios. Você pode enviá-la quantas vezes precisar enquanto o cliente não compartilhar seu número. Se o envio falhasse, o sistema exibirá um aviso flutuante (snackbar) para que você possa tentar novamente.
Cenário B: Se a janela de conversa está EXPIRADA
Ao pressionar "Solicitar", o painel tradicional de templates será aberto.
O sistema filtrará e exibirá apenas os templates de solicitação de contato que já foram aprovados previamente (Fase 1).
Selecione o template desejado e envie-o para reabrir a janela de atendimento.
💡 Dica: O sistema avalia o estado da janela no instante exato do clique. Se você fechou o aviso por acidente, simplesmente dirija-se ao cabeçalho do chat e clique diretamente sobre o status "Contato não compartilhado" para disparar a ação novamente.
📥 Fase 3: O cliente compartilha seu contato (Salvamento automático)
Uma vez que você envia a solicitação, a plataforma cuida do resto:
Quando o cliente clicar no botão da solicitação e aceitar compartilhar seu número, você receberá um cartão de contato visual no chat.
O sistema lerá esse cartão e o número será salvo automaticamente no perfil do cliente no Atom.
O aviso de "Contato não compartilhado" desaparecerá imediatamente e a opção de solicitar deixará de ser exibida.
🚨 Regras de Ouro (Considerações-chave)
Para evitar bloqueios operacionais, tenha em mente as seguintes normativas ao lidar com clientes sob o esquema BSUID:
Regra Operativa | Detalhe do Comportamento |
A operação não é interrompida | Se o cliente decidir não compartilhar seu número, você pode continuar atendendo-o e gerenciar seu perfil sem problemas através de seu código BSUID. |
Chamadas desabilitadas | As ferramentas de voz (chamadas por WhatsApp ou telefonia SIP) estarão estritamente desabilitadas para esse chat até que um número telefônico válido seja salvo. |
Edição manual bloqueada | O número de WhatsApp não pode ser editado manualmente. Esta é uma regra do Meta; a única forma de atualizá-lo é através do salvamento automático do cartão de contato. |
Visualização do perfil | Enquanto o número não for fornecido, o chat manterá o rótulo de "Contato não compartilhado" e usará seu identificador interno. |
⚠️ Solução de problemas (Troubleshooting)
Não estou vendo o template de "Solicitação de informação de contato" ao ter a janela expirada:
Se ao clicar em "Solicitar" a lista de templates aparecer completamente vazia, é provável que o template não tenha sido sincronizado corretamente no Business Manager do Meta de sua empresa. Entre em contato com nosso time de Suporte Técnico para confirmar que a geração do template foi concluída com sucesso.
Compreender como funciona o modelo de privacidade BSUID lhe oferece total flexibilidade operacional. Ao aproveitar a lógica dinâmica da janela de conversa para solicitar o contato, você garante que sua base de dados se mantenha atualizada e pronta para escalar sem gerar atrito na experiência de seus clientes. ✅