O que está acontecendo

O WhatsApp está introduzindo dois novos identificadores de usuário — o username e o BSUID — que mudam a forma como contas são reconhecidas dentro da plataforma.

Hoje, o Bino e a Lia identificam cada pessoa pelo número de telefone. Com essa mudança, alguém pode trocar de número e continuar sendo a mesma conta no WhatsApp — o que nossos sistemas ainda não tratam.

O risco não é o WhatsApp parar de funcionar. O risco é perder o vínculo entre a pessoa e seu histórico no nosso sistema: viagens, atendimentos, perfil, tudo que foi acumulado até hoje.

Dois novos identificadores

Novo · Identificador público
Username

Um apelido escolhido pelo próprio usuário, como uma arroba. Público e editável a qualquer momento, sem precisar trocar de número.

Ex: @joao.motorista · Pode mudar amanhã para @joao.silva
Novo · Identificador interno
BSUID

Um código único gerado pelo WhatsApp para cada conta. Permanece estável em trocas de username e, na maioria dos casos, em trocas de aparelho e operadora. Pode mudar em determinadas situações relacionadas ao número telefônico.

É como um CPF da conta no WhatsApp — técnico, invisível ao usuário e mais estável que o número.
O que isso significa na prática: uma pessoa pode trocar de número de telefone e continuar com a mesma conta no WhatsApp. Hoje, nossos sistemas tratam número = pessoa. Com o BSUID, isso deixa de ser verdade.
Hierarquia de identificadores recomendada
1
Identificador interno — chave primária nos nossos sistemas (ex: ID do motorista no ApisulLog)
2
BSUID — identificador técnico do WhatsApp, mais estável que o número
3
Número de telefone — continua sendo usado quando disponível
4
Username — apenas como referência de exibição, nunca como chave de identificação
Lógica de reenvio de mensagens ativas Usar telefone quando disponível → usar BSUID quando o telefone estiver oculto → escalar para tratativa operacional manual quando nenhum identificador estiver disponível.

Assistente de motorista durante viagens

🚛
Bino — Suporte ao motorista via WhatsApp
Usado durante viagens em andamento
  • O Bino reconhece o motorista pelo número de WhatsApp. Se o número mudar ou o perfil passar a ter um novo BSUID, o sistema pode não localizar o histórico de viagens e ocorrências daquele usuário.
  • Fluxos em andamento — como checklist de evento, registro de ocorrência ou alerta de velocidade — podem ser interrompidos se a sessão estiver vinculada ao número e não ao BSUID.
  • Motoristas trocam de chip com frequência. Esse cenário já é real na operação logística e vai se tornar um risco latente de duplicidade de cadastro sem a adaptação.
  • A continuidade de jornada — viagem em andamento sendo retomada pelo WhatsApp — depende de identificar a pessoa, não só o dispositivo ou o número.

Assistente da operação

🤖
Lia — Automação e atendimento operacional
Usada por embarcadores, transportadoras e time interno
  • Se o CRM armazenar contatos apenas por número de telefone, usuários com BSUID diferente do número cadastrado vão entrar como novos contatos — gerando duplicidade e perda de histórico de atendimento.
  • Regras que dependem de saber "quem está falando" — perfil de embarcador, transportadora, analista — quebram quando o número muda e o sistema não reconhece mais a pessoa.
  • Disparos ativos de mensagens (notificações de status de carga, alertas de prazo) podem ir para números desatualizados se o BSUID não for considerado como referência de destinatário.

O que pode dar errado

⚠️
Risco principal

Perder o vínculo entre a pessoa e seu histórico no sistema. Não é uma falha do WhatsApp — é uma fragilidade na forma como identificamos usuários hoje. O sistema vai achar que são pessoas diferentes.

Alto · Operação
Duplicidade de cadastro

Mesma pessoa, dois registros diferentes. Histórico fragmentado, atendimento sem contexto, dados inconsistentes.

Alto · Motorista
Quebra de jornada em andamento

Viagem em curso não reconhecida após troca de chip. Motorista sem suporte e fluxo interrompido.

Médio · Automação
Notificações enviadas errado

Disparos ativos para números desatualizados. Mensagem importante não chega ao destinatário real.

Médio · Dados
Indicadores distorcidos

Relatórios baseados em contatos duplicados ou perdidos afetam métricas de atendimento e viagem.

Pontos de atenção internos

A Apisul não fala direto com a Meta

A comunicação entre o Bino, a Lia e o WhatsApp passa por camadas intermediárias — o provedor oficial (BSP) e, possivelmente, um HUB de integração. No caso da Lia, a Twilio já atua como BSP.

🔗
Por que isso importa
Se o HUB ou BSP não entregar o BSUID, nenhuma adaptação interna resolve
  • O BSP (ex: Twilio) é responsável por receber os eventos da Meta, processar mensagens e entregar os identificadores via webhook para os nossos sistemas.
  • Se existir um HUB intermediário entre o BSP e o Bino/Lia, ele também precisa estar adaptado — caso contrário, o BSUID pode chegar até o HUB e nunca ser entregue aos nossos sistemas.
  • A Twilio já publicou documentação e comunicados sobre a adoção do BSUID. Segundo a Twilio, o telefone poderá não ser disponibilizado e o BSUID pode se tornar o principal identificador. Os sistemas devem adaptar suas integrações.
Checklist: perguntas para Twilio e demais fornecedores
O BSUID já está disponível nas APIs do fornecedor?
O campo BSUID é enviado nos webhooks de entrada?
O número de telefone pode vir vazio? A partir de quando?
É possível enviar mensagens ativas usando o BSUID como destinatário?
Existe cronograma oficial de homologação e adequação?
Existem alterações contratuais ou técnicas previstas que impactam a integração atual?

O que fazer agora

1
Mapeamento técnico

Levantar todos os pontos no código do Bino e da Lia onde o número de telefone é usado como identificador. Resultado esperado: lista de dependências com nível de criticidade.

2
Acionar Twilio e demais fornecedores

Usar a checklist da seção anterior para questionar a Twilio (BSP da Lia) e qualquer HUB intermediário sobre disponibilidade do BSUID, cronograma e impacto contratual. Sem essa confirmação, as adaptações internas podem ser ineficazes.

3
Verificação na API

Confirmar com o time de tecnologia se a versão atual da WhatsApp Business API expõe o campo BSUID. Documentar a versão e o contrato de dados hoje.

4
Decisão de arquitetura

Definir se o BSUID será adotado como chave primária ou complementar, e qual a estratégia de migração dos cadastros existentes.

5
Alinhamento com operações e atendimento

As equipes de campo e suporte precisam entender o risco de cadastros duplicados e como acionar o time técnico quando isso ocorrer.

6
Monitoramento pós-mudança

Criar alerta ou dashboard para identificar usuários sem BSUID registrado e detectar duplicações após a mudança entrar em vigor.

Conclusão e recomendação

A mudança no WhatsApp não vai derrubar o Bino ou a Lia. Mas se a Apisul não adaptar a forma de identificar usuários, qualquer troca de número vai quebrar o histórico, a continuidade do atendimento e a integridade dos dados operacionais.

🎯
Ação recomendada

Iniciar o mapeamento técnico e a decisão de arquitetura de forma coordenada entre produto, tecnologia e operações, garantindo que a mudança não chegue à produção sem o time preparado.