Nomes de usuário e IDs de usuário com escopo de negócio do WhatsApp
Os nomes de usuário do WhatsApp são um recurso opcional de privacidade que oculta os números de telefone dos usuários quando eles enviam mensagens para empresas. A Braze lida com isso automaticamente. Para a maioria dos clientes, nada nas suas Campaigns ou Canvas precisa mudar.

A Meta está lançando os nomes de usuário do WhatsApp e os BSUIDs em fases. A Braze oferece suporte completo ao envio de mensagens por BSUID, então você poderá ver mais usuários identificados apenas por BSUID ao longo do tempo. Para ver as atualizações mais recentes da Meta, consulte IDs de usuário com escopo de negócio.
Quando os usuários do WhatsApp adotam um nome de usuário, o número de telefone deles deixa de ser compartilhado automaticamente com as empresas para as quais enviam mensagens. Em vez disso, o WhatsApp fornece às empresas um ID de usuário com escopo de negócio (BSUID), um identificador único específico para cada par de portfólio de negócios e usuário.
A Braze lida com os BSUIDs automaticamente. Os usuários que adotam um nome de usuário continuam aparecendo no seu espaço de trabalho da Braze, recebendo mensagens, disparando Canvas e gerando eventos. Alguns clientes podem precisar se preparar para a mudança.
ID de usuário com escopo de negócio (BSUID)
Um BSUID é um identificador único e persistente que o WhatsApp atribui para representar um usuário dentro do seu portfólio empresarial específico. Pense nele como um número de telefone alternativo para usuários que preferem manter o número de telefone privado.
Os BSUIDs têm três características principais:
| Característica | Descrição |
|---|---|
| Único | Dois usuários nunca compartilham o mesmo BSUID dentro do seu portfólio empresarial. |
| Com escopo de negócio | O mesmo usuário tem um BSUID diferente para cada empresa com a qual troca mensagens. Os BSUIDs não podem ser compartilhados nem comparados entre portfólios empresariais diferentes. |
| Disponível em webhooks | Os BSUIDs são incluídos em todas as mesmas cargas úteis de webhook que contêm o número de telefone do usuário. |
Mudanças nos tipos de usuários do WhatsApp
Existem dois tipos de usuários do WhatsApp:
| Tipo de usuário | Identificação no WhatsApp | O que a Braze recebe |
|---|---|---|
| Usuários sem nome de usuário | Número de telefone (sem alteração) | Número de telefone (sem alteração) |
| Usuários com nome de usuário | Nome de usuário (exibido), BSUID (backend) | BSUID, número de telefone para usuários que já têm uma conversa com a sua empresa |
A principal diferença é que um usuário que adota um nome de usuário só compartilha o número de telefone com a sua empresa se vocês já tiverem conversado antes ou se ele estiver na sua Agenda de Contatos do WhatsApp.
Como a Braze lida com BSUIDs
A Braze armazena BSUIDs como um alias de usuário com o rótulo whats_app_bsuid no perfil de usuário. Isso significa que os usuários que têm apenas um BSUID contam com perfis de usuário completos na Braze. Eles podem entrar em Canvas, receber mensagens, gerar eventos e ser atualizados pela API.
Enviar mensagens
Quando a Braze envia uma mensagem do WhatsApp, ela usa o número de telefone, se houver um disponível. Se o usuário tiver apenas um BSUID (como um usuário que envia a primeira mensagem para você depois de adotar um nome de usuário), a Braze faz o envio usando o BSUID. Você não precisa alterar seus modelos de mensagem, Campaigns ou etapas do Canvas.
Mensagens recebidas e gatilhos do Canvas
Quando um usuário com nome de usuário envia uma mensagem do WhatsApp para você, a Braze:
- Busca o usuário pelo BSUID ou pelo número de telefone (o que estiver disponível no webhook).
- Se nenhum usuário correspondente for encontrado, cria um novo perfil de usuário anônimo com o BSUID armazenado como alias de usuário.
- Dispara qualquer Canvas ou Campaign configurado para começar com uma mensagem recebida do WhatsApp.
Perfil de usuário
Você pode ver o BSUID de um usuário na seção WhatsApp do perfil de usuário dele na Braze.

Grupos de inscrições
O gerenciamento de grupos de inscrições funciona da mesma forma para usuários com BSUID e para qualquer usuário identificado por um alias de usuário. Você pode atualizar o status de inscrição de usuários com BSUID por meio de:
- O endpoint users/track usando
user_alias - A etapa do Canvas Atualização de Usuário (funciona automaticamente)
- Upload de CSV

O endpoint subscription/status/set não é compatível com user_alias. Use o endpoint users/track para atualizar o status de inscrição de usuários que têm apenas um BSUID.
Currents e dados de eventos
Todos os eventos de Currents do WhatsApp (envio, entrega, leitura, falha, recebimento de mensagem, interrupção, nova tentativa) incluem um campo de BSUID. Para usuários que têm um número de telefone e um BSUID, os dois campos são incluídos. Para usuários que têm apenas um BSUID, só o campo de BSUID é incluído (o campo de número de telefone fica vazio).
Como se preparar para a mudança
Para a maioria dos clientes, não é necessária nenhuma ação. A Braze gerencia automaticamente o roteamento de BSUIDs, a criação de usuários e o rastreamento de eventos. No entanto, recomendamos ativar a Contact Book do WhatsApp e vincular portfólios empresariais caso você use várias contas do WhatsApp Business (WABAs).
Se você espera receber usuários que fornecem apenas um BSUID, também pode solicitar as informações de contato deles. Assim, você pode armazenar um número de telefone no perfil e mesclar duplicatas quando necessário.
Ativar a Contact Book do WhatsApp
A Contact Book é um recurso da Meta que registra os números de telefone dos usuários com quem você já conversou. Quando um usuário adota um nome de usuário, o número de telefone dele continua visível para sua empresa se ele estiver na sua Contact Book. Isso significa que a Braze pode continuar identificando usuários pelo número de telefone mesmo depois que eles ativam um nome de usuário.
Para ativar a Contact Book:
- Acesse Meta Business Suite > Business settings > Business info.
- Confirme que o recurso Contact Book está ativado.

O recurso Contact Book vem ativado por padrão, mas recomendamos confirmar isso nas configurações do Meta Business. Se a Contact Book estiver desativada, os usuários que adotarem nomes de usuário aparecerão como novos usuários apenas com BSUID, mesmo que você já tenha enviado mensagens para eles.
Vincule portfólios empresariais se você usa várias WABAs
Os BSUIDs têm como escopo um único portfólio empresarial. Se sua organização gerencia WABAs de vários portfólios empresariais no mesmo espaço de trabalho da Braze, o mesmo usuário terá um BSUID diferente para cada portfólio. Isso pode resultar em perfis de usuário duplicados na Braze.
Para evitar isso, entre em contato com seu ponto de contato na Meta para verificar se sua empresa está elegível para vincular portfólios. Para mais detalhes, consulte Vincular portfólios empresariais e BSUIDs principais.
Se todas as suas WABAs estiverem no mesmo portfólio empresarial, nenhuma ação é necessária.
Vincular portfólios empresariais e BSUIDs pai
Se a sua organização opera várias contas do WhatsApp Business (WABAs) em diferentes portfólios empresariais, você pode pedir ao seu contato na Meta para verificar se a sua empresa é elegível para vincular esses portfólios. A elegibilidade é determinada pela Meta e está disponível para empresas gerenciadas.
Comportamento de portfólios vinculados
Quando os seus portfólios empresariais estão vinculados, o WhatsApp inclui um BSUID pai em todos os webhooks de mensagem, junto com o BSUID regular. O BSUID pai é atribuído a uma nova propriedade parent_user_id na carga útil do webhook.
Os BSUIDs pai têm as mesmas propriedades dos BSUIDs regulares, mas são compartilhados entre todos os números de telefone comerciais do seu conjunto de portfólios vinculados. Assim, o mesmo usuário tem um único identificador consistente, independentemente da WABA para a qual envia mensagens. Isso evita o risco de perfis de usuário duplicados.
Um BSUID pai inclui ENT entre o código do país e o identificador alfanumérico. Por exemplo:
US.ENT.11815799212886844830
Um BSUID regular não inclui ENT.
Como a Braze usa os BSUIDs pai
Quando um webhook contém tanto um BSUID regular quanto um BSUID pai, a Braze usa o BSUID pai como identificador principal. Assim, um usuário que envia mensagens para várias WABAs nos seus portfólios vinculados é sempre associado ao mesmo perfil de usuário na Braze.
Se não houver um BSUID pai (por exemplo, porque seus portfólios não estão vinculados ou o usuário está enviando mensagens para uma WABA não vinculada), a Braze usa o BSUID regular. Os BSUIDs regulares continuam funcionando normalmente em todos os casos.

A Meta gerencia o processo de vinculação de portfólios empresariais. Para começar, entre em contato com o seu contato na Meta. Você ainda pode enviar mensagens aos usuários usando o BSUID regular deles, mesmo que seus portfólios estejam vinculados. Os BSUIDs pai são complementares, não substitutos.
| Cenário | Identificador usado pela Braze |
|---|---|
| Portfólio empresarial único | BSUID regular |
| Vários portfólios vinculados | BSUID pai (preferencial). Se não existir um BSUID pai, usa o BSUID regular |
| Vários portfólios não vinculados | BSUID regular (pode resultar em perfis de usuário duplicados por portfólio) |
Perguntas frequentes
Minhas Campaigns e Canvas existentes deixam de funcionar?
Não. As Campaigns e os Canvas existentes continuam funcionando normalmente. Usuários que não adotam um nome de usuário não são afetados. Para usuários que adotam um nome de usuário e já têm um histórico de conversas com sua empresa, a Braze continua usando o número de telefone como identificador principal.
O que acontece com um usuário que adota um nome de usuário, mas já enviou mensagens para minha empresa?
Se o seu WhatsApp Contact Book estiver ativado e você tiver conversado com o usuário (ou enviado uma mensagem para ele) nos últimos 30 dias, o número de telefone continua aparecendo nas cargas úteis do webhook junto com o BSUID. A Braze associa o usuário ao perfil de usuário existente, e nenhum perfil duplicado é criado.
E se um usuário adotar um nome de usuário e nunca tiver conversado com minha empresa?
A Braze recebe o BSUID do usuário no webhook de entrada. Então, ela associa o usuário a um perfil de usuário existente (se você já tiver armazenado o BSUID dele) ou cria um novo perfil de usuário anônimo com o BSUID armazenado como alias de usuário. Esse usuário pode entrar em Canvas, receber mensagens de saída e ser identificado ou mesclado com outros perfis usando as ferramentas padrão de resolução de identidade da Braze.
Para obter um número de telefone desses usuários que têm apenas BSUID, consulte Solicitar informações de contato de usuários do WhatsApp com apenas BSUID.
Posso direcionar usuários com BSUID em Segments?
Usuários com BSUID são perfis de usuário completos na Braze, então você pode direcioná-los com os filtros de público padrão (como “recebeu uma mensagem do WhatsApp” ou participação em grupo de inscrições). No entanto, não é possível segmentar especificamente por valores de BSUID (como “BSUID existe” ou “BSUID é igual a X”).
Como funciona o preço do WhatsApp para usuários com BSUID?
O preço das conversas no WhatsApp é determinado pelo país do usuário. Para usuários identificados por número de telefone, a Meta obtém o país a partir do código de país do número. Para usuários identificados por BSUID, o país vem codificado diretamente no próprio BSUID. Por exemplo, um BSUID que começa com US representa um usuário nos Estados Unidos.
Isso significa que o preço é calculado da mesma forma, seja o usuário identificado por número de telefone ou por BSUID. O país usado para calcular as taxas de conversa é determinado pelo identificador que a Meta fornece, e a Braze repassa essa informação sem alterações. Você não precisa fazer nada de diferente. Só tenha em mente que, ao enviar mensagens para usuários com apenas BSUID, o preço por país da Meta se baseia no país codificado no BSUID do usuário, e não em um número de telefone.
Como faço referência a um usuário com BSUID em chamadas de API?
Use o parâmetro user_alias com alias_label: "whats_app_bsuid" e alias_name definido como o valor do BSUID do usuário. Por exemplo:
{
"user_alias": {
"alias_label": "whats_app_bsuid",
"alias_name": "DDC91135R"
}
}
Isso funciona com users/track, users/identify, upload de CSV e a etapa do canva Atualização de Usuário.
Meus pipelines de dados do Currents deixam de funcionar?
Os eventos do Currents para WhatsApp incluem um campo bsuid junto ao campo de número de telefone existente. Para usuários que têm apenas BSUID, o campo de número de telefone fica vazio. Se os seus pipelines downstream tiverem requisitos rígidos para o campo de número de telefone, confirme que eles conseguem lidar com um valor nulo ou vazio.
Tenho várias WABAs em diferentes portfólios empresariais. O mesmo usuário aparece como dois perfis diferentes na Braze?
Sem portfólios vinculados, sim. O mesmo usuário do WhatsApp tem um BSUID diferente para cada portfólio empresarial, e a Braze cria perfis separados para cada um.
Para resolver isso, fale com seu contato na Meta para verificar se você é elegível para vincular portfólios. Com os portfólios vinculados, a Meta fornece um BSUID principal compartilhado entre todos eles, e a Braze usa esse identificador para reconhecer o usuário de forma consistente em todas as suas WABAs. Para saber mais, consulte Vincular portfólios empresariais e BSUIDs principais.
Posso desativar o Contact Book?
Recomendamos fortemente manter o Contact Book ativado. Se ele for desativado, todos os registros históricos de números de telefone dos seus usuários serão perdidos. Assim, usuários que adotarem nomes de usuário passarão a aparecer como novos usuários com apenas BSUID, mesmo que você já tenha enviado mensagens para eles.
Recursos adicionais
