🧭 Fundamentos

Identificador unico e publico (ex: @maria.silva) que substitui o numero de telefone como forma de te encontrar e iniciar conversas no WhatsApp.

Ate 2024, sua unica identidade no WhatsApp era o numero. Username muda a logica do app — entender isso e a base para tudo que vem depois.

Publico (todos podem ver), Unico (so uma pessoa pode ter), Mutavel (voce pode trocar), Separado do numero (telefone fica privado).

O numero continua sendo a CHAVE da sua conta (login, recuperacao). O username e a IDENTIDADE PUBLICA que voce mostra para os outros.

Para nao confundir: trocar o username e como trocar o handle do Twitter. Trocar o numero e mudar de SIM.

Numero = chave privada de conta. Username = identidade publica. Conviva — um nao substitui o outro tecnicamente, so visualmente.

WABetaInfo reportou indicios em meados de 2023, Meta confirmou desenvolvimento em 2024, primeira liberacao para beta testers em 2025.

Saber em que estagio o recurso esta evita usar telas antigas como referencia ou confiar em "tutoriais" defasados.

Rollout gradual, primeiro beta, depois Android/iOS por regiao. Sempre cheque a versao do seu app antes de tentar ativar.

Letras minusculas (a-z), numeros (0-9), pontos e underscore. Deve comecar com letra. Sem espacos, sem caracteres especiais, sem emojis.

Nomes invalidos so dao erro depois — testar o formato antes evita frustracao e melhora suas chances de pegar um nome bom.

Padrao similar ao do Instagram. Curto e memoravel ganha. Termos genericos provavelmente ja estarao em uso.

Freelancers, profissionais liberais, criadores, vendedores, recrutadores e qualquer pessoa que precise ser contactada sem expor o numero pessoal.

Ajuda a decidir se voce realmente precisa de um username ou se basta usar o WhatsApp Business com numero separado.

Privacidade ativa, marca pessoal, contato cross-platform (post de Insta com @ unica), separacao trabalho-pessoal.

Nao te deixa anonimo. Nao quebra a criptografia. Nao impede a Meta de saber quem voce e. Nao te livra de spam se voce publicar o username.

Privacidade real exige entender o que muda e o que continua igual — caso contrario voce sente uma "seguranca" que nao existe.

Username = camada de apresentacao. Conta, metadados e numero continuam atrelados a sua identidade real para Meta.

Business-Scoped User ID e um identificador opaco que a Meta gera para cada par (usuario, empresa) na Cloud API. Mesma pessoa, duas empresas = dois BSUIDs.

Empresas nao podem mais depender so do numero, porque com username o numero pode ficar oculto. BSUID e a chave estavel que substitui essa funcao.

Opaco (nao tem significado por si), por escopo (so vale para AQUELA empresa), estavel (nao muda entre conversas).

Antes, o WhatsApp ID (`wa_id`) era basicamente o numero do telefone (E.164). Com username liberado, esse modelo fura — usuarios podem nao querer expor o numero.

Codigo legado depende muito de `wa_id`. Saber a relacao entre `wa_id` e BSUID e essencial para migracao.

Cloud API esta evoluindo — webhook continua trazendo numero quando autorizado, mas BSUID e a chave duravel daqui pra frente.

No payload de webhook de mensagem recebida (`messages.contacts[].user_id` e campos correlatos) e ao enviar mensagens via Cloud API.

Sabendo onde o ID vive, voce projeta direito o banco de dados, indexa pela chave certa e nao precisa refazer tudo dali a um ano.

Modele um campo `bsuid` UNIQUE por (business_id, user). Use como chave estrangeira em conversas, atendimentos e historico.

No Messenger, ja existe o PSID (Page-Scoped User ID) — mesmo conceito: um ID estavel por (pagina, usuario). BSUID e a versao WhatsApp dessa logica.

Se voce ja trabalhou com Messenger Platform, BSUID e familiar. Mesmas garantias, mesmos cuidados de LGPD.

"Scoped" significa: ninguem fora daquela empresa consegue derivar quem e o usuario a partir do ID. E um trade-off privacidade vs portabilidade.

Cada BSUID e criado no primeiro contato entre usuario e empresa. Persiste enquanto o usuario tem conta e a empresa tem WABA ativa.

Sem entender o ciclo, voce arrisca apagar dados que ainda eram acessiveis ou manter dados orfaos.

Persistente entre conversas. Pode ser anulado/rotacionado em casos extremos. Trate-o como PII — politicas de retencao se aplicam.

BSUID e dado pessoal pseudonimizado: nao identifica a pessoa diretamente, mas combinado com mensagens permite reidentificacao.

Empresas precisam tratar BSUID como dado pessoal — registros de tratamento, base legal, direito a exclusao, etc.

Pseudonimizacao reduz risco, nao elimina. Direito a apagamento aplica. Documente o tratamento no ROPA.

Telegram tem username desde 2014. Signal lancou em 2024. iMessage usa email/Apple ID. WhatsApp era o ultimo grande mensageiro preso ao numero.

Saber o contexto explica o "porque" — nao foi bondade, foi pressao competitiva + interoperabilidade obrigada pelo DMA europeu.

DMA (UE) forca interoperabilidade. Signal mostrou que da pra ter privacidade real. WhatsApp tinha que se mover.

Signal: username opcional, numero ainda exigido. Telegram: username central, numero pode ser oculto. WhatsApp: numero ainda e a chave de login.

Cada app faz trade-offs diferentes. Entender ajuda a escolher para uso pessoal e a desenhar produtos B2B.

Identidade publica vs identidade de conta. Recuperacao via SMS vs via PIN. Spam vs descobribilidade.

Quem ja tinha seu numero, continua tendo. Username protege contra exposicao FUTURA, nao contra exposicoes passadas.

Para ajustar expectativa: privacidade e processo, nao botao. Username e uma camada — combinada com outras decisoes.

Forward secrecy de identidade nao existe. O que ja vazou, vazou. O que muda e o futuro.

Username protege contra desconhecidos casuais, scrapers de listas, spam por enumeracao de numeros. Nao protege contra Meta nem contra quem ja tem seu contato salvo.

Sem clareza do modelo de ameaca, voce subestima ou superestima a protecao — e em ambos os casos toma decisoes piores.

Adversario casual (publico geral) vs adversario direcionado vs estado-nacao. Username so reduz risco do primeiro.

Marcas vao competir por usernames bons (@nike, @netflix). Links `wa.me/usuario` substituirao `wa.me/5511...`. Campanhas vao mudar.

Antecipar para garantir o nome certo, padronizar canais e nao chegar atrasado.

Username squatting vai acontecer. Politica de disputa da Meta sera similar a do Instagram (trademark, etc.).

Username e a camada VISIVEL da nova identidade. BSUID e a camada INVISIVEL (tecnica). Juntos, separam identidade publica de chave de conta.

Antes de entrar nas trilhas de pratica (T2 e T3), voce precisa ter esses dois conceitos firmes — eles voltam o tempo todo.

Username (publico) ↔ BSUID (privado por empresa) ↔ Telefone (chave de conta). Tres camadas, papeis distintos.