ID de Usuário com Escopo de Negócio (BSUID) e Nome de Usuário do WhatsApp

ID de Usuário com Escopo de Negócio (BSUID) e Nome de Usuário do WhatsApp

Introdução

O Meta está introduzindo Nomes de Usuário de Negócio do WhatsApp como um recurso opcional que permite aos usuários do WhatsApp exibir um nome de usuário em vez de seu número de telefone ao enviar mensagens para negócios. Para suportar isso, o Meta introduziu BSUID (ID de Usuário com Escopo de Negócio) — um identificador único vinculado a cada relação negócio-usuário.

Quando um usuário adota um nome de usuário, seu nome de usuário será exibido no WhatsApp em vez de seu número de telefone. Isso significa que os negócios não podem mais assumir que o número de telefone de um usuário estará sempre disponível desde o início. Em vez disso, você os identificará pelo seu BSUID, que o Meta fornece automaticamente.

O WOZTELL adaptou a plataforma para suportar essa mudança. Agora você pode trabalhar com contatos usando BSUID, solicitar seu número de telefone quando necessário, e gerenciar suas informações conforme sua identidade evolui ao longo do tempo.

Como Funciona a Identidade de Contato no WOZTELL

Quando um contato envia uma mensagem para você, o WOZTELL recebe um ou mais identificadores do Meta. Aqui está a ordem de prioridade:

  • Número de Telefone — o identificador primário quando disponível
  • BSUID — identifica o contato quando o número de telefone não está disponível ainda
  • Nome de Usuário — informações adicionais exibidas quando o contato tem um configurado

Se um contato começar apenas com um BSUID e depois compartilhar seu número de telefone, o WOZTELL vincula ambos os identificadores e mantém a continuidade da conversa. O número de telefone se torna o identificador de prioridade a partir de então.

O Que Mudou em Cada Parte do WOZTELL

Caixa de Entrada

  • Os contatos sem número de telefone aparecem com seu BSUID exibido como seu ID Externo
  • O nome de usuário é exibido como informações adicionais quando disponível
  • Você pode pesquisar conversas por BSUID
  • Nota: A pesquisa na caixa de entrada não inclui Nome de Usuário — é apenas um atributo de exibição
  • Todas as informações de contato (BSUID, Nome de Usuário, número de telefone) são visíveis quando você abre os detalhes do contato
    BSUID na caixa de entrada Detalhes do contato com BSUID

Página de Contatos

  • Uma nova coluna Nome de Usuário exibe o Nome de Usuário de Negócio do WhatsApp do contato (vazio se não tiver um)
  • BSUID aparece como ID Externo quando não há número de telefone ou outro identificador aplicável
  • Você pode pesquisar e filtrar por BSUID e Nome de Usuário
  • Todas as informações estão disponíveis nos detalhes completos do contato
Coluna Nome de Usuário em Contatos

Importar Contatos

Você pode importar contatos usando estes tipos de ID Externo:

  • BSUID
  • Número de Telefone do WhatsApp
  • ID do Instagram
  • PSID do Facebook

Nota: O Nome de Usuário não pode ser usado como ID Externo para importar contatos.

Transmissão e Audiências

  • Uma coluna Nome de Usuário foi adicionada para exibir o Nome de Usuário de Negócio do WhatsApp de cada contato
  • BSUID é exibido como ID Externo quando não há número de telefone
  • Você pode pesquisar e filtrar por BSUID e Nome de Usuário
  • Em Audiências Estáticas, você pode selecionar contatos por BSUID ou Nome de Usuário
  • Audiências Dinâmicas não usam BSUID ou Nome de Usuário como critérios de segmentação — são identificadores individuais, não atributos para regras de audiência

Configuração do Canal: Nome de Usuário de Negócio

As configurações agora incluem acesso para solicitar e gerenciar o Nome de Usuário de Negócio do WhatsApp do seu canal. O WOZTELL o direciona ao ambiente do Meta onde ocorre o gerenciamento final do nome de usuário.

Você verá o status do seu nome de usuário:

  • Ainda não reivindicado

  • Aprovado e visível

  • Reservado mas não visível ainda

Solicitação de Número de Telefone: Por Quê e Quando

Uma vez que o WOZTELL pode trabalhar com contatos usando BSUID, o próximo passo é solicitar o número de telefone quando seu negócio precisar.

A Solicitação de Número de Telefone está disponível apenas para contatos que não têm um número de telefone no WOZTELL. Se o contato já tiver um número de telefone, a opção de solicitação não aparecerá.

Botão Solicitar Número de Telefone

Existem duas maneiras de solicitá-lo:

Opção 1: Mensagem Interativa (Nenhum Modelo Necessário)

Envie uma Mensagem Interativa Especial de Solicitação de Informações de Contato do WhatsApp diretamente para o contato.

Esta mensagem usa o componente específico REQUEST_CONTACT_INFO do WhatsApp e não requer um modelo. Use-a quando quiser solicitar um número de telefone rapidamente sem configurar modelos primeiro.

Mensagem Interativa Solicitação de Contato
Mensagem Interativa no WhatsApp

Opção 2: Mensagem de Modelo (Usando Modelos e Lista de Permissões)

Use modelos do WhatsApp que incluam o componente Solicitação de Informações de Contato. Isso lhe dá mais controle sobre o conteúdo da mensagem e a marca.

Criar Modelos com Solicitação de Informações de Contato

De Configurações, crie um novo modelo:

  • Escolha a categoria Utilidade ou Marketing
  • Inclua o componente especial Solicitação de Informações de Contato
  • Crie modelos em vários idiomas se necessário
  • Envie para aprovação do Meta
Criar Modelo com Solicitação de Informações de Contato

Uma vez aprovado, os modelos estão disponíveis para uso.

Nota: Os modelos com esses componentes especiais podem demorar um pouco mais para serem aprovados pelo Meta.

Lista de Permissões de Modelo: Controle Qual Seu Equipe Usa

A Lista de Permissões em Configurações funciona como uma lista de favoritos para modelos. Apenas os modelos na lista de permissões aparecem quando agentes enviam uma Solicitação de Número de Telefone.

Aqui está o fluxo de trabalho:

  1. Crie o modelo com o componente Solicitação de Informações de Contato
  2. Meta o aprova
  3. Adicione-o à Lista de Permissões em Configurações
  4. O modelo está disponível para que agentes o usem ao solicitar números de telefone
Configuração Lista de Permissões

Isso significa que ter um modelo com o componente Solicitação de Informações de Contato não o torna automaticamente disponível para agentes — você controla quais modelos aparecem através da Lista de Permissões.

Ao configurar a Lista de Permissões, o WOZTELL filtra e exibe apenas os modelos que contêm o componente Solicitação de Informações de Contato, facilitando encontrá-los e adicioná-los.

Como Enviar uma Solicitação de Número de Telefone

Da Caixa de Entrada:

Quando um contato sem número de telefone envia uma mensagem para você, pode iniciar uma Solicitação de Número de Telefone diretamente na conversa. Selecione entre os modelos na lista de permissões e envie.

A opção aparece apenas se o contato não tiver um número de telefone no WOZTELL.

Solicitar Número na Caixa de Entrada

Selecionar ModeloEnviar Solicitação

De Contatos:

Você também pode iniciar uma Solicitação de Número de Telefone do registro do contato na página Contatos. O WOZTELL o redirecionará para a Caixa de Entrada daquele contato onde pode selecionar e enviar um modelo na lista de permissões.

Iniciar Solicitação de ContatosEnviar de Contatos

Modelos Padrão

O WOZTELL fornece modelos padrão prontos para usar nestes idiomas:

  • Inglês
  • Chinês Mandarin
  • Chinês Tradicional
  • Francês
  • Espanhol
  • Português
  • Árabe

Para Solicitação de Informações de Contato: Os modelos padrão são criados para todos os canais novos e existentes, enviados ao Meta para aprovação, e adicionados automaticamente à Lista de Permissões após aprovação.

Lista de Modelos Padrão
Nota: A versão de Chinês Tradicional está atualmente experimentando problemas no lado do Meta e pode não funcionar como esperado.

O Que o Contato Decide no WhatsApp

Quando você envia uma Solicitação de Informações de Contato, o contato tem controle sobre o que compartilha. O WhatsApp pode oferecer a opção de compartilhar:

  • Número de Telefone
  • Nome de Usuário (se tiver um configurado)
Opções de Compartilhamento no WhatsApp

Você não pode forçar um contato a compartilhar seu número de telefone. Ele decide quais informações fornecer.

O Que Acontece Quando o Número de Telefone Chega

Quando um contato compartilha seu número de telefone através da Solicitação de Informações de Contato:

  • O WOZTELL recebe as informações em um formato estruturado
  • O número de telefone é adicionado à identidade do seu contato
  • O número de telefone se torna o identificador de prioridade — agora é usado em vez de BSUID
  • Se o contato existia anteriormente no WOZTELL identificado apenas por BSUID, ambos os identificadores são vinculados
  • A fusão automática ocorre quando aplicável, mantendo a continuidade do contato e conversa

A identidade de um contato pode evoluir assim:

Apenas BSUID → BSUID + Número de Telefone → Número de Telefone como identificador primário

O Nome de Usuário continua complementando as informações do contato quando disponível.

Importante: Como Solicitar Corretamente um Número de Telefone

Pedir a um contato para digitar seu número de telefone no chat não é o mesmo que uma Solicitação de Número de Telefone.

Um número de telefone recebido como uma mensagem de texto regular não pode ser associado corretamente à identidade do seu contato através desta funcionalidade.

Para obter e vincular corretamente o número de telefone, você deve usar:

  • Mensagem Interativa (componente Solicitação de Informações de Contato), ou
  • Mensagem de Modelo (modelo com componente Solicitação de Informações de Contato)

Isso garante que o número de telefone seja registrado corretamente e vinculado à sua identidade no WOZTELL.

A importação de contatos é um processo separado para adicionar contatos pré-existentes usando IDs Externos compatíveis.