1. O que é o BSUID?
O BSUID (Business-Scoped User ID) é um identificador criado pelo WhatsApp (Meta) para identificar um contato de forma única no contexto de uma empresa.
Ele é usado internamente pelo Wide Chat para o gerenciamento e envio de mensagens.
O BSUID está vinculado ao Gerenciador de Negócios (Business Manager) ao qual o canal de WhatsApp pertence. Por isso, um mesmo contato pode ter BSUIDs diferentes quando interage com canais de Gerenciadores de Negócios diferentes. Se diferentes números de WhatsApp estiverem vinculados ao mesmo Gerenciador de Negócios, o BSUID daquele contato será o mesmo.
Importante: essa mudança faz parte de uma atualização da Meta e não altera a forma como o atendimento acontece no Wide Chat.
2. Por que alguns contatos não têm número de telefone?
Todos os contatos possuem um BSUID, que funciona como identificador único do contato. No entanto, o número de telefone nem sempre é disponibilizado pela Meta.
O BSUID passa a ser usado internamente como identificador no lugar do telefone principalmente quando:
- o contato é novo e não possui número de telefone disponível; ou
- o contato chegou por meio de um Username e optou por ocultar o número de telefone.
Quando o número de telefone está disponível, ele continua sendo exibido normalmente. A diferença entre os contatos está na disponibilidade do telefone e na forma como o contato foi identificado, e não na existência ou não de um BSUID.
3. Cada cliente terá um único BSUID?
Não necessariamente. O BSUID está vinculado ao Gerenciador de Negócios (Business Manager) ao qual o canal de WhatsApp pertence.
- Se dois números de WhatsApp estiverem no mesmo Gerenciador de Negócios, o cliente terá o mesmo BSUID ao entrar em contato pelos dois números.
- Se os números estiverem em Gerenciadores de Negócios diferentes, o mesmo cliente poderá ter BSUIDs diferentes.
4. Todo contato do WhatsApp terá um BSUID?
Sim. A Meta gera automaticamente um BSUID para cada combinação entre contato e empresa. Esse identificador é enviado nas informações recebidas pela integração, independentemente de o usuário possuir ou não um Username.
5. O que é o Username?
O Username é um identificador público do WhatsApp no formato @nomedeusuario. Ele permite que uma pessoa seja encontrada e identificada no WhatsApp sem precisar compartilhar o número de telefone.
Atualmente, no Wide Chat, o Username e o BSUID não são usados pelo agente para adicionar ou cadastrar contatos manualmente. Quando um usuário entra em contato com a empresa pelo WhatsApp, a Meta envia automaticamente as informações de identificação disponíveis, incluindo o Username e o BSUID, e o Wide Chat atribui esses dados ao contato.
Importante: o Username e o BSUID têm funções diferentes. O Username é um identificador público, enquanto o BSUID é usado pela Meta para identificar o contato dentro do contexto da empresa.
6. O que muda para quem usa o Wide Chat?
A rotina de atendimento no Wide Chat não muda.
O telefone do contato continua sendo usado e exibido sempre que estiver disponível. Porém, com as novas regras de identificação da Meta, alguns contatos podem não ter o número de telefone disponibilizado.
Nesses casos, o BSUID é usado internamente para identificar o contato, mas não é exibido como substituto do telefone nas telas de atendimento, relatórios ou exportações.
7. Vou continuar tendo acesso ao número do cliente?
Sempre que o número do contato estiver disponível, ele continuará sendo exibido normalmente no Wide Chat.
Em alguns casos, devido às novas regras de identificação da Meta, o número de telefone pode não ser disponibilizado. Nessa situação, o campo poderá ficar vazio.
A ausência do número não impede o atendimento. O cliente pode iniciar ou continuar uma conversa normalmente e será atendido, desde que não exista alguma integração, fluxo ou automação que dependa da validação do número.
Se a sua operação usa processos que dependem dessa informação, verifique como eles se comportam quando o número não estiver disponível. Veja mais detalhes na próxima pergunta.
8. Minha integração usa o número de telefone como identificador único. O que devo fazer?
Com a adoção do BSUID, podem existir situações em que o número de telefone não esteja disponível. Nesses casos, nos Webhooks, o campo platform_id poderá receber o BSUID em vez do número de telefone.
Por isso, a integração deve estar preparada para tratar os dois formatos, evitando falhas no fluxo. Se a automação usa o valor de platform_id para alguma operação, verifique se ela aceita tanto o número de telefone quanto o BSUID.
Para envios feitos pela API do Wide Chat, o BSUID pode ser usado no endpoint /send, inclusive quando o número de telefone não estiver disponível.
9. O telefone do contato deixa de ser salvo?
Não. Mesmo com o uso do BSUID, o telefone continua sendo armazenado na base sempre que for disponibilizado pelo WhatsApp.
O BSUID apenas passa a ser o identificador usado internamente na comunicação com a Meta.
10. Existem casos em que o contato não terá telefone?
Sim. A Meta está disponibilizando recursos que permitem que alguns usuários conversem com empresas no WhatsApp sem compartilhar o número de telefone.
Nesses casos, o contato pode realmente não ter telefone disponível, mas continua podendo ser atendido normalmente. Se necessário, o telefone pode ser informado depois, por meio de fluxos de automação ou manualmente.
11. A variável {{PLATFORM_ID}} mudou de comportamento?
A variável {{PLATFORM_ID}} continua sendo usada para identificar o contato, mas seu comportamento pode variar de acordo com o contexto em que a informação é recebida.
- Nos Webhooks: o campo
platform_idnunca virá vazio. Ele sempre terá um valor, que poderá ser o número de telefone ou o BSUID do contato. - Nos demais contextos em que a variável representa o telefone do contato: o número continua sendo retornado sempre que estiver disponível. Caso o telefone não esteja disponível, o comportamento depende do contexto em que a informação está sendo usada.
12. Foi criada alguma variável para acessar o BSUID ou o Username do contato?
Não. Nesta versão não foram criadas novas variáveis para expor:
- o BSUID;
- o Username do WhatsApp.
Essas informações são usadas apenas para controle interno do Wide Chat.
13. Preciso alterar meus fluxos ou automações?
Na maioria dos casos, não. Porém, automações que usam informações recebidas por Webhooks devem considerar o novo comportamento do campo platform_id.
Nos Webhooks, o campo platform_id sempre terá um valor: o número de telefone ou o BSUID. Por isso, a automação não deve assumir que esse campo conterá sempre um número de telefone.
Para envios feitos pela API do Wide Chat, o BSUID pode ser usado no endpoint /send, inclusive quando o número de telefone não estiver disponível.
14. Preciso alterar minhas integrações?
Na maioria dos casos, não. As integrações continuam funcionando normalmente.
Se a sua integração usa diretamente as respostas das APIs do Wide Chat, observe que o BSUID pode aparecer nos retornos técnicos, pois faz parte da identificação usada pela Meta.
Nos Webhooks, o campo platform_id pode receber o número de telefone ou o BSUID, dependendo da disponibilidade do telefone. Para envios pela API, o BSUID pode ser usado no endpoint /send, inclusive quando o número de telefone não estiver disponível.
15. O BSUID será exibido nas telas do Wide Chat?
Não. O BSUID não é exibido em:
- tela de atendimento;
- lista de conversas;
- relatórios;
- exportações.
O objetivo é manter uma experiência semelhante à atual, exibindo sempre as informações mais úteis para a operação.
16. O atendimento ao cliente muda?
Não. A forma de atender, enviar mensagens e acompanhar conversas continua a mesma. A alteração está relacionada apenas à forma como o Wide Chat identifica os contatos internamente.
17. O que acontece se um cliente passar a ter um Username?
O Wide Chat faz automaticamente o gerenciamento dessa informação. O telefone continua preservado na base sempre que estiver disponível, sem necessidade de nenhuma ação do usuário.
18. Se o cliente alterar o Username, o BSUID muda?
Não. O cliente pode alterar o Username quantas vezes quiser, sem que isso altere o BSUID dentro da mesma empresa.
Já uma troca do número de telefone pode gerar um novo BSUID.
Este artigo foi útil?
Que bom!
Obrigado pelo seu feedback
Desculpe! Não conseguimos ajudar você
Obrigado pelo seu feedback
Feedback enviado
Agradecemos seu esforço e tentaremos corrigir o artigo