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 empresa (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 empresa | 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 estã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á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 e número de telefone para usuários que já têm uma conversa com 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 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 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. Não é preciso fazer nenhuma alteração nos 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:
- Procura 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:
- Endpoint users/track usando
user_alias - 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, mensagem recebida, interrupção, nova tentativa) incluem um campo de BSUID. Para usuários que têm número de telefone e BSUID, os dois campos são incluídos. Para usuários que têm 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 cuida automaticamente do roteamento de BSUID, da criação de usuários e do rastreamento de eventos. No entanto, recomendamos ativar o Contact Book do WhatsApp. Se você usa várias contas do WhatsApp Business (WABAs), também recomendamos vincular os portfólios empresariais.
Ativar o Contact Book do WhatsApp
O 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 no seu Contact Book. Assim, a Braze continua identificando usuários pelo número de telefone mesmo depois que eles ativam um nome de usuário.
Para ativar o 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 o Contact Book 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.
Vincular portfólios empresariais se você usa várias WABAs
Os BSUIDs são limitados a 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 gerar 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 empresariais e BSUIDs principais para mais detalhes.
Se todas as suas WABAs estiverem no mesmo portfólio empresarial, nenhuma ação é necessária.
Vincular portfólios empresariais e BSUIDs principais
Se a sua organização opera várias contas do WhatsApp Business (WABAs) em diferentes portfólios empresariais, você pode pedir ao seu ponto de 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 seus portfólios empresariais estão vinculados, o WhatsApp inclui um BSUID principal em todos os webhooks de mensagens, junto com o BSUID regular. O BSUID principal é atribuído a uma nova propriedade parent_user_id na carga útil do webhook.
Os BSUIDs principais têm as mesmas propriedades que os 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 principal 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 principais
Quando um webhook contém um BSUID regular e um BSUID principal, a Braze usa o BSUID principal como identificador primário. Isso permite que um usuário que envia mensagens para várias WABAs nos seus portfólios vinculados seja associado de forma consistente ao mesmo perfil de usuário na Braze.
Se não houver um BSUID principal (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 ponto de 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 principais são complementares, não substitutos.
| Cenário | Identificador usado pela Braze |
|---|---|
| Um único portfólio empresarial | BSUID regular |
| Vários portfólios vinculados | BSUID principal (preferencial). Se não houver um BSUID principal, 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
Meus Campaigns e Canvas existentes vão parar de funcionar?
Não. Os Campaigns e Canvas existentes continuam funcionando normalmente. Os usuários que não adotarem um nome de usuário não são afetados. Para usuários que adotarem um nome de usuário e já tiverem 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 Contact Book do WhatsApp estiver ativado e você tiver conversado com o usuário (ou enviado uma mensagem a ele) nos últimos 30 dias, o número de telefone dele continua aparecendo nas cargas úteis do webhook junto com o BSUID. A Braze associa esse usuário ao 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. Então, ela associa o usuário a um perfil 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. Depois disso, 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.
Posso direcionar usuários com BSUID em Segments?
Usuários com BSUID são perfis de usuário completos na Braze. Portanto, 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 pelo número de telefone, a Meta obtém o país a partir do código do país do número. 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 preço se comporta 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 fornecido pela Meta, e a Braze repassa essa informação sem modificações. Você não precisa fazer nada diferente, mas saiba que, ao enviar mensagens para usuários que têm 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 User Update.
Meus pipelines de dados do Currents vão parar de funcionar?
Os eventos do Currents para WhatsApp incluem um campo bsuid junto com o 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 seus pipelines downstream tiverem requisitos rígidos para o campo de número de telefone, confirme se 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, entre em contato com seu ponto de contato na Meta para verificar a elegibilidade para vincular portfólios. Com os portfólios vinculados, a Meta fornece um BSUID principal compartilhado entre todos eles, e a Braze o usa para identificar 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, os usuários que adotarem nomes de usuário vão aparecer como novos usuários apenas com BSUID, mesmo que você já tenha enviado mensagens para eles antes.
Recursos adicionais