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

Identificador público · Todos os usuários
Username

Um apelido escolhido pelo próprio usuário, como uma arroba. Disponível para qualquer conta do WhatsApp — pessoal, Business App ou Business Platform. Editável a qualquer momento, sem trocar de número.

Ex: @joao.motorista · Pode mudar amanhã para @joao.silva · Pode ser removido
Identificador técnico · Somente Business Platform
BSUID

Código único gerado pelo WhatsApp exclusivamente na API Business — quando um usuário conversa com uma empresa. Específico por empresa: o mesmo usuário tem BSUIDs diferentes em cada negócio que conversa. Permanece estável em trocas de username, aparelho e operadora. Pode mudar em situações relacionadas ao número telefônico.

Gerado só na conversa com a Apisul via API. O motorista nem sabe que existe.
Onde cada identificador existe
Username BSUID
WhatsApp pessoal
WhatsApp Business App
WhatsApp Business Platform (API) Apisul
O que isso significa na prática: o username é universal — qualquer motorista já pode ter um. O BSUID só existe no lado da Apisul, gerado automaticamente quando o usuário conversa com o Bino ou a Lia via API. O motorista não precisa fazer nada.
Hierarquia de identificadores recomendada
1
Identificador interno — chave primária nos nossos sistemas (ex: ID do motorista no ApisulLog)
2
BSUID — identificador técnico da API, único por usuário dentro da Apisul
3
Número de telefone — continua sendo usado quando disponível
4
Username — apenas referência de exibição para o atendimento humano, 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 pode acontecer na prática

Cada cenário abaixo representa uma situação real que motoristas, embarcadores e transportadoras podem gerar — e o que muda com ou sem o BSUID armazenado.

Cenário 1 — Número disponível (situação atual)
Motorista, embarcador ou transportadora · Mais comum hoje
A mensagem chega com o número de telefone normalmente. Bino e Lia identificam a pessoa, o histórico funciona, nenhuma ação necessária. Sem risco.
⚠️
Cenário 2 — Pessoa oculta o número
Qualquer usuário · Cresce conforme o WhatsApp expande o recurso
A mensagem chega sem telefone. Com BSUID armazenado: o sistema identifica pelo BSUID e continua normalmente. Sem BSUID: a pessoa entra como desconhecida — risco de cadastro duplicado e perda de histórico.
⚠️
Cenário 3 — Motorista troca de chip e cria conta nova
Motoristas · Muito comum na operação logística
Nova conta no WhatsApp = novo BSUID. O sistema não reconhece automaticamente — o motorista precisa ser revínculado manualmente ao cadastro existente. Sem esse processo, vira cadastro duplicado.
Cenário 4 — Motorista troca de chip mas mantém a conta
Motoristas · Quando migra o número dentro da mesma conta
A conta WhatsApp continua a mesma, só o número muda. O BSUID permanece igual. Com BSUID armazenado, o sistema continua identificando normalmente.
🔴
Cenário 5 — Número reutilizado pela operadora
Motoristas · Risco silencioso e difícil de detectar
Motorista cancela o número. A operadora atribui o mesmo número a outra pessoa. Essa nova pessoa cria um WhatsApp e manda mensagem para o Bino. Sem BSUID: o sistema pode confundir as duas pessoas — dados de um aparecem para outro. Com BSUID: são BSUIDs diferentes, o sistema distingue corretamente.
⚠️
Cenário 6 — Troca de contato em embarcador ou transportadora (Lia)
Clientes da Lia · Troca de funcionário ou celular corporativo
O contato da empresa muda de celular, troca de cargo ou é substituído por outro funcionário com número diferente. Sem BSUID, o histórico de atendimento fica vinculado ao número antigo e o novo contato começa do zero. Com BSUID, o histórico segue a conta WhatsApp.
🔴
Cenário 7 — BSP não entrega o BSUID (Twilio)
Risco técnico · Blocker para todos os demais cenários
Se a Twilio ainda não estiver entregando o campo bsuid nos webhooks, nenhuma adaptação interna resolve. Todos os cenários acima continuam dependendo exclusivamente do telefone até o BSP se adequar. Este cenário precisa ser confirmado antes de qualquer desenvolvimento.
Resumo dos cenários
Cenário Sem BSUID Com BSUID
Número disponível Sem risco Sem risco
Número oculto Não identificado Identificado
Troca de chip, conta nova Cadastro duplicado Revínculo manual
Troca de chip, mesma conta Sem risco Sem risco
Número reutilizado pela operadora Confunde pessoas Distingue corretamente
Troca de contato na empresa Perde histórico Preserva histórico
BSP não entrega BSUID Depende do telefone

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.