Skip to main content

Reivindicando o nome de usuário

O nome de usuário é o @nome público da sua linha oficial de WhatsApp Business. Ele é um novo jeito para os clientes entrarem em contato com você sem precisar do seu número de telefone — o número continua sendo exibido no perfil normalmente. Este guia mostra como reivindicar o nome de usuário diretamente no Gerenciador do WhatsApp, usando a conta de administrador do seu portfólio empresarial (Business Manager) na Meta.
A mesma operação pode ser feita pela API da Positus, incluindo consulta, alteração, exclusão e sugestões de username. Veja Username da linha oficial.

Pré-requisitos

  • Acesso à conta do Facebook com um usuário administrador da BM (portfólio empresarial no Meta).
  • O número de WhatsApp Business API já ativo dentro da conta de WhatsApp (WABA).

Passo a passo

1

Acessar o portfólio empresarial

Entre no Facebook com o usuário administrador da BM (portfólio empresarial no Meta).
2

Abrir o menu Contas de WhatsApp

Acesse o menu CONTAS DE WHATSAPP por este link: business.facebook.com/latest/settings/whatsapp_account
3

Abrir o Gerenciador do WhatsApp

Clique na conta de WhatsApp onde está o número e depois em GERENCIADOR DO WHATSAPP.

Botão Gerenciador do WhatsApp na tela da conta de WhatsApp

4

Criar o nome de usuário

Clique no número desejado, abra a aba PERFIL e, em Nome de usuário, clique em CRIAR.

Aba Perfil do número com a opção Criar em Nome de usuário

5

Preencher e salvar

Preencha o nome desejado e clique em SALVAR. A Meta também exibe sugestões de nomes disponíveis.

Janela de criação do nome de usuário com sugestões e botão Salvar

Observações importantes

  • Cada número pode ter apenas um nome de usuário.
  • Não é possível ter mais de um número com o mesmo nome de usuário.

Formato do nome de usuário

Os nomes de usuário comerciais devem seguir o formato abaixo:
  • Podem conter apenas letras do alfabeto inglês (a-z), dígitos (0-9), ponto (.) e caractere de sublinhado (_);
  • Caracteres que não são letras do alfabeto inglês (como ñ, é, ü) não são compatíveis e causarão falhas na solicitação;
  • Devem ter entre 3 e 35 caracteres;
  • Devem conter pelo menos uma letra do alfabeto inglês (a-z, A-Z);
  • Não podem começar nem terminar com ponto, nem ter dois pontos consecutivos (..);
  • Não podem começar com www;
  • Não podem terminar com um domínio (por exemplo .com, .org, .net, .int, .edu, .gov, .mil, .us, .in, .html e assim por diante);
  • A diferença entre maiúsculas e minúsculas é ignorada ao comparar nomes de usuário.

Depois de salvar

A propagação do nome de usuário é assíncrona. A Meta pode primeiro reservar (reserved) o nome e só depois promovê-lo para aprovado (approved), quando ele passa a ficar visível aos clientes no WhatsApp.
A Positus notifica o seu webhook a cada mudança de status do nome de usuário — inclusive quando a alteração é feita pelo Gerenciador do WhatsApp, como neste guia. O evento é o business_username_update; veja Atualização de username da linha.

Problemas comuns

A lista completa de códigos de erro retornados pela Meta está em Username da linha oficial — Tratamento de erros.