Nomes de usuário e IDs de usuário com escopo de negócio do WhatsApp
Nomes de usuário do WhatsApp são um recurso opcional de privacidade que oculta os números de telefone dos usuários ao enviar mensagens para empresas. A Braze lida com isso automaticamente; para a maioria dos clientes, nada nas suas Campaigns ou Canvas precisa mudar.
Quando os usuários do WhatsApp adotam um nome de usuário, seu número de telefone 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 empresarial (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 optam por manter seu número de telefone privado.
Os BSUIDs têm três características principais:
| Característica | Descrição |
|---|---|
| Único | Dois usuários não compartilham o mesmo BSUID dentro do seu portfólio empresarial. |
| Com escopo empresarial | O mesmo usuário tem um BSUID diferente para cada empresa com a qual troca mensagens. Os BSUIDs não podem ser compartilhados ou 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. |
Alterações nos tipos de usuário 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 existente com sua empresa |
A diferença principal é que um usuário que adota um nome de usuário compartilha seu número de telefone com sua empresa apenas se você já teve uma conversa anterior com ele ou se ele aparece no seu Catálogo 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 usuários apenas com BSUID têm perfis de usuário completos na Braze e podem entrar em Canvas, receber mensagens, gerar eventos e ser atualizados pela API.
Envio de mensagens
Quando a Braze envia uma mensagem do WhatsApp, ela usa o número de telefone, se disponível. Se o usuário tiver apenas um BSUID (como um usuário que envia uma mensagem para você pela primeira vez após adotar um nome de usuário), a Braze envia usando o BSUID. Nenhuma alteração nos seus modelos de mensagem, Campaigns ou etapas do Canvas é necessária.
Mensagens recebidas e disparadores de Canvas
Quando um usuário com nome de usuário envia uma mensagem recebida do WhatsApp, a Braze:
- Busca o usuário por BSUID ou 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 iniciar ao receber uma mensagem do WhatsApp.
Perfil de usuário
Você pode ver o BSUID de um usuário no perfil de usuário da Braze, na seção do WhatsApp.
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 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 User Update (funciona automaticamente)
- Upload de CSV
O endpoint subscription/status/set não oferece suporte a user_alias. Use o endpoint users/track para atualizar o estado de inscrição de usuários que possuem apenas BSUID.
Currents e dados de eventos
Todos os eventos do Currents para WhatsApp (envio, entrega, leitura, falha, recebimento, interrupção, nova tentativa) incluem um campo de BSUID. Para usuários que possuem tanto um número de telefone quanto um BSUID, ambos os campos são incluídos. Para usuários que possuem apenas um BSUID, somente 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, nenhuma ação é necessária. A Braze lida automaticamente com o roteamento de BSUID, a criação de usuários e o rastreamento de eventos. No entanto, recomendamos ativar o Catálogo de Contatos do WhatsApp e vincular portfólios de negócios se você utiliza múltiplas Contas do WhatsApp Business (WABAs).
Ativar o Catálogo de Contatos do WhatsApp
O Catálogo de Contatos é um recurso da Meta que registra números de telefone de usuários com quem você já conversou. Quando um usuário adota um nome de usuário, seu número de telefone permanece visível para sua empresa se ele aparecer no seu Catálogo de Contatos. Isso significa que a Braze pode continuar identificando usuários pelo número de telefone mesmo após eles ativarem um nome de usuário.
Para ativar o Catálogo de Contatos:
- Acesse Meta Business Suite > Configurações do negócio > Informações do negócio.
- Confirme que o recurso de Catálogo de Contatos está ativado.
O recurso de Catálogo de Contatos está ativado por padrão, mas recomendamos confirmar isso nas configurações do Meta Business. Se o Catálogo de Contatos estiver desativado, 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 anteriormente.
Vincular portfólios de negócios se você utiliza múltiplas WABAs
Os BSUIDs são atribuídos a um único portfólio de negócios. Se sua organização gerencia WABAs de múltiplos portfólios de negócios dentro do 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 é elegível para vincular portfólios. Consulte Vincular portfólios de negócios e BSUIDs pai para mais detalhes.
Se todas as suas WABAs estiverem dentro do mesmo portfólio de negócios, nenhuma ação é necessária.
Vincular portfólios de negócios e BSUIDs pai
Se a sua organização opera várias contas WhatsApp Business (WABAs) em diferentes portfólios de negócios, você pode pedir ao seu ponto de contato na Meta para verificar se o seu negócio é elegível para vincular esses portfólios. A elegibilidade é determinada pela Meta e está disponível para negócios gerenciados.
Comportamento de portfólios vinculados
Quando seus portfólios de negócios 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 possuem as mesmas propriedades dos BSUIDs regulares, mas são compartilhados entre todos os números de telefone comerciais dentro do seu conjunto de portfólios vinculados. Isso significa que o mesmo usuário tem um único identificador consistente, independentemente da WABA pela qual ele envia mensagens, evitando 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 BSUIDs pai
Quando um webhook contém tanto um BSUID regular quanto um BSUID pai, a Braze usa o BSUID pai como identificador principal. Isso permite que um usuário que envia mensagens por várias WABAs nos seus portfólios vinculados seja consistentemente associado ao mesmo perfil de usuário na Braze.
Se nenhum BSUID pai estiver presente (por exemplo, porque seus portfólios não estão vinculados ou o usuário está enviando mensagem 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 de negócios. Para começar, entre em contato com seu ponto de contato na Meta. Você ainda pode enviar mensagens aos usuários usando o BSUID regular, mesmo que seus portfólios estejam vinculados; os BSUIDs pai são complementares, não uma substituição.
| Cenário | Identificador usado pela Braze |
|---|---|
| Portfólio de negócios único | BSUID regular |
| Múltiplos portfólios vinculados | BSUID pai (preferido). Se não existir um BSUID pai, usa o BSUID regular |
| Múltiplos 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 param de funcionar?
Não. Campaigns e Canvas existentes continuam funcionando. Usuários que não adotam um nome de usuário não são afetados de forma alguma. 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 sua Lista de Contatos do WhatsApp estiver ativada e você tiver tido uma conversa anterior com o usuário (ou tiver enviado uma mensagem para ele) nos últimos 30 dias, o número de telefone dele continua aparecendo nas cargas úteis de webhook junto com o BSUID. A Braze faz a correspondência com o perfil de usuário existente. Nenhum perfil duplicado é criado.
E se um usuário adotar um nome de usuário e não tiver nenhuma conversa anterior com minha empresa?
A Braze recebe o BSUID do usuário no webhook de entrada e faz a correspondência com um perfil de usuário existente (caso você tenha armazenado o BSUID anteriormente) ou cria um novo perfil de usuário anônimo com o BSUID armazenado como alias de usuário. Esse usuário pode então 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.
Posso segmentar usuários com BSUID em Segments?
Usuários com BSUID são perfis de usuário completos na Braze, então você pode segmentá-los por meio de filtros de público padrão (como “recebeu uma mensagem do WhatsApp” ou pertencimento a grupo de inscrições). No entanto, segmentar especificamente por valores de BSUID (como “BSUID existe” ou “BSUID é igual a X”) não é suportado.
Como funciona a precificação do WhatsApp para usuários com BSUID?
A precificação de conversas do WhatsApp é determinada pelo país do usuário. Para usuários identificados por número de telefone, a Meta determina o país a partir do código de país do número de telefone. Para usuários identificados por BSUID, o país é 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 comportamento de precificação é consistente independentemente de o usuário ser identificado por número de telefone ou 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 modificações. Você não precisa fazer nada de diferente, mas esteja ciente de que, ao enviar mensagens para usuários apenas com BSUID, a precificação baseada em país da Meta é calculada com base no país codificado no BSUID do usuário, e não em um número de telefone.
Como faço para referenciar 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 com 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 de Atualização de Usuário do Canvas.
Meus pipelines de dados do Currents param de funcionar?
Os eventos do Currents para WhatsApp incluem um campo bsuid ao lado do campo de número de telefone existente. Para usuários que possuem apenas um BSUID, o campo de número de telefone fica vazio. Se 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 múltiplos WABAs em diferentes portfólios de negócios. 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 por portfólio de negócios, e a Braze cria perfis separados para cada um.
Para resolver isso, entre em contato com seu ponto de contato na Meta para verificar a elegibilidade para vinculação de portfólios. Quando vinculados, a Meta fornece um BSUID pai compartilhado entre todos os portfólios, e a Braze usa esse identificador para identificar o usuário de forma consistente em todos os seus WABAs. Consulte Vincular portfólios de negócios e BSUIDs pai para mais detalhes.
Posso desativar a Lista de Contatos?
Recomendamos fortemente manter a Lista de Contatos ativada. Se a Lista de Contatos for desativada, todos os registros históricos de números de telefone dos seus usuários serão perdidos. Usuários que adotarem nomes de usuário passarão a aparecer como novos usuários apenas com BSUID, mesmo que você já tenha enviado mensagens para eles anteriormente.