> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Reservar o seu nome de utilizador WhatsApp Business no WhatsApp Manager
> Reclame o seu @handle para a WhatsApp Business Platform antes que outra pessoa o faça: pré-requisitos, os passos no WhatsApp Manager, regras de nome de utilizador, códigos de erro e o que muda quando os clientes ocultam os seus números de telefone.
O WhatsApp está a introduzir **nomes de utilizador**. Em vez de um número de telefone, a sua empresa passa a ter um handle como `@amarca` que os clientes podem escrever no WhatsApp para iniciar uma conversa. As reservas de nomes de utilizador comerciais abriram a **29 de junho de 2026**, e a funcionalidade está a ser ativada país a país nos meses seguintes. Os nomes de utilizador são atribuídos por ordem de chegada, pelo que esta página o orienta na reserva do seu na WhatsApp Business Platform agora, mesmo que ainda não esteja ativo no seu país.
Este guia cobre apenas a via da **WhatsApp Business Platform**, que é aquela em que se encontra se o WhatsApp corre através do Flowella ou de qualquer outro sistema em vez da app WhatsApp Business num telefone.
**Verificado pela última vez a 13 de setembro de 2026** face ao Centro de Ajuda WhatsApp e à documentação para programadores do Meta. O Meta ainda está a lançar isto, por isso consulte as [fontes](#fontes) se algo no ecrã não corresponder.
## Porquê reservar já
* **Os nomes de utilizador são únicos e por ordem de chegada.** Uma vez que um handle esteja ocupado por qualquer conta WhatsApp, de consumidor ou empresarial, mais ninguém o pode usar.
* **Os handles correspondentes do Facebook e Instagram são reservados para os seus proprietários, mas apenas por tempo limitado.** O Meta reserva o nome de utilizador que já usa na sua Página do Facebook ou conta do Instagram para que o possa reclamar no WhatsApp. O WhatsApp diz que existe uma janela limitada para o fazer e não publicou uma data final. Depois dessa janela, não há garantia de que o handle continuará disponível.
* **Não custa nada.** Reservar um nome de utilizador não tem custo, e pode alterá-lo ou eliminá-lo mais tarde.
* **Protege a sua marca mesmo que ainda não tenha planos WhatsApp.** Um nome de utilizador reservado é retido para o seu número de telefone e não pode ser reclamado por mais ninguém.
## O que um nome de utilizador comercial faz e não faz
Um nome de utilizador comercial é uma forma de os clientes o contactarem **sem precisarem do seu número de telefone**. Uma vez ativo, os clientes que não têm o seu número guardado veem o seu nome de utilizador em vez do seu número em conversas, grupos e chamadas.
Vale a pena esclarecer os limites:
* **Não oculta o seu número de telefone comercial.** O seu número mantém-se no seu perfil de negócio. A documentação do Meta é explícita ao dizer que os nomes de utilizador comerciais não são uma funcionalidade de privacidade; isso é para os nomes de utilizador de consumidor.
* **Não há diretório.** Ninguém pode navegar ou pesquisar pela sua empresa. Os clientes têm de escrever o seu nome de utilizador exato, portanto coloque-o no seu website, sinalética, assinaturas de email e perfis sociais assim que estiver ativo.
* **Um nome de utilizador por número de telefone.** Se a sua Conta WhatsApp Business tiver vários números, cada um precisa do seu próprio nome de utilizador.
* **O seu nome de utilizador é separado do seu nome de exibição.** O nome de exibição continua a passar pela revisão do Meta e continua a aparecer aos clientes; consulte [Nome de exibição & perfil](/pt/meta/profile-setup).
### Como o seu nome é mostrado numa conversa
O Meta apresenta a identidade comercial nesta ordem de prioridade. O primeiro que se aplicar é o que o cliente vê.
1. O nome sob o qual o cliente o guardou nos seus contactos
2. O seu nome comercial verificado, ou o seu nome de Conta Oficial de Negócio
3. O seu nome de utilizador
4. O seu número de telefone
Assim, uma empresa que completou a Verificação de Negócio mostra o seu nome comercial aos clientes que não têm o número guardado, com o nome de utilizador por baixo como forma de a contactarem.
## Antes de começar
Precisa de todos os seguintes elementos. Se algum estiver em falta, trabalhe primeiro a [Sequência de configuração](/pt/meta/setup-sequence).
O nome de utilizador é definido num número de telefone que pertence a uma Conta WhatsApp Business (WABA) dentro do seu portefólio. Consulte [Portefólio empresarial](/pt/meta/business-portfolio) e [Conta WhatsApp Business](/pt/meta/whatsapp-business-account).
O número tem de estar registado para utilização de API na WABA. Um número que foi adicionado mas ainda não foi registado devolve o erro `133010` quando tenta definir um nome de utilizador. Consulte [Números de telefone](/pt/meta/phone-numbers).
O Meta exige que o portefólio empresarial tenha um **limite de mensagens superior** ao que cada novo portefólio começa (250 conversas iniciadas por empresa por 24 horas). Se não tiver, o WhatsApp Manager mostra **Account not eligible** e a API devolve o erro `147002`. A forma mais rápida de contornar isto é completar a [Verificação de negócio](/pt/meta/business-verification), que move um portefólio aprovado para 2.000. Escalar por volume de envio também funciona, mas demora mais tempo. Consulte [Limites de mensagens](/pt/meta/messaging-limits).
Para definir um nome de utilizador precisa de acesso de nível admin à WABA ou ao número de telefone. Se quiser reclamar um handle que já está em uso na sua Página do Facebook ou conta do Instagram, também precisa de **controlo total** dessa Página ou conta, ou de **acesso parcial com a permissão gerir telefone**, porque o Meta exige que associe o número de telefone a ela primeiro.
Se não tem a certeza de qual escalão de mensagens está a usar, abra **WhatsApp Manager → Account tools → Messaging limits**. Qualquer coisa acima de 250 é suficiente.
## Reservar o seu nome de utilizador no WhatsApp Manager
Esta é a via recomendada e a mostrada no guia em vídeo do Flowella.
Aceda a [business.facebook.com/latest/whatsapp\_manager/phone\_numbers](https://business.facebook.com/latest/whatsapp_manager/phone_numbers/) e selecione o portefólio empresarial que detém a sua WABA se lhe for pedido.
No menu esquerdo em **Account tools**, clique em **Phone numbers** e depois clique no número ao qual quer dar um nome de utilizador. O painel de detalhes do número abre-se à direita.
No topo do painel de detalhes, clique em **Profile**. Desloque-se para além de **Profile picture** e **Display name** até à secção **Username**.
Se o número ainda não tem nome de utilizador, clique em **Create**. Se já existir um, clique em **Edit**. A caixa de diálogo **Edit username** abre-se.
A caixa de diálogo mostra uma linha **Suggested**. Estes são os nomes de utilizador que o Meta já reservou para a sua empresa a partir da sua Página do Facebook, da sua conta do Instagram e do domínio do seu website, e têm maior probabilidade de aprovação. Clique num, ou escreva o seu próprio handle no campo. Um visto verde significa que está disponível; **This username is not available** significa que está ocupado ou falha as verificações do Meta.
Clique em **Save**. A secção Username mostra agora **Current username: @seuhandle** com um distintivo de estado e a data em que foi atualizado.
Se escolheu um handle que está em uso na sua Página do Facebook ou conta do Instagram, o Meta irá pedir-lhe para **associar o número de telefone** a essa Página ou conta antes de guardar. Pode fazê-lo a partir da mesma caixa de diálogo ou adicionando diretamente o número WhatsApp à Página ou conta do Instagram. Sem a associação, o pedido falha com erro `147003` (Facebook) ou `147004` (Instagram).
### O que significa o distintivo de estado
| Distintivo | Significado |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Reserved** | Aprovado e retido para o seu número de telefone, mas ainda não visível para os utilizadores do WhatsApp. Muda para ativo automaticamente quando o Meta disponibilizar os nomes de utilizador no seu país. Ninguém o pode reclamar entretanto. |
| **Approved** | Ativo e visível. Os clientes que não têm o seu número guardado veem o nome de utilizador e podem iniciar uma conversa escrevendo-o. |
O WhatsApp envia uma notificação quando um nome de utilizador reservado se torna ativo. Não precisa de fazer nada.
## Outras formas de reservar
Aceda a **Settings → Accounts → WhatsApp accounts**, abra o separador **Phone numbers**, clique no número, desloque-se para **Username** e clique em **Create**. É a mesma caixa de diálogo do WhatsApp Manager.
Para programadores e fornecedores de soluções, o Meta expõe o nome de utilizador no número de telefone comercial. O token de acesso precisa da permissão `whatsapp_business_management` com Controlo total ou Acesso parcial aos números de telefone na WABA.
Definir ou alterar um nome de utilizador:
```bash theme={null}
curl -X POST "https://graph.facebook.com///username" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer " \
-d '{ "username": "yourbrand" }'
```
Uma resposta bem-sucedida devolve `{ "status": "reserved" }` ou `{ "status": "approved" }`.
Listar os nomes de utilizador que o Meta reservou para o seu portefólio:
```bash theme={null}
curl "https://graph.facebook.com///username_suggestions" \
-H "Authorization: Bearer "
```
Leia o nome de utilizador e estado atuais com `GET .../username` e remova-o com `DELETE .../username`. Referência completa na documentação [Business-scoped user IDs](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids/) do Meta.
## Regras de nome de utilizador
* 3 a 35 caracteres
* Apenas letras inglesas (a a z), dígitos (0 a 9), pontos finais (.) e underscores (\_); caracteres acentuados como ñ, é ou ü são rejeitados
* Pelo menos uma letra; um nome de utilizador não pode ser apenas números
* Sem ponto final no início ou no fim, e sem dois pontos finais seguidos
* Não pode começar por `www.`
* Não pode terminar com uma extensão de domínio listada como `.com`, `.org`, `.net`, `.edu`, `.gov` ou `.html`
* Maiúsculas/minúsculas são ignoradas ao verificar a unicidade, mas pontos finais e underscores não: `myid`, `my.id` e `my_id` são três nomes de utilizador diferentes
* Alguns nomes de utilizador estão reservados pelo Meta para empresas, governos e figuras públicas e não podem ser reclamados
## Erros que pode ver
| Erro | O que significa | O que fazer |
| --------------------------------------------- | -------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Account not eligible** / `147002` | O portefólio empresarial ainda está no limite de mensagens inicial. | Complete a [Verificação de negócio](/pt/meta/business-verification), ou aguarde até ter escalado para além de 250 por volume de envio, e tente novamente. |
| **This username is not available** / `147001` | O handle está ocupado, falha as verificações internas do Meta ou está reservado para outra pessoa. | Escolha um handle diferente. Se for a sua marca registada e outra pessoa o detiver, consulte as [FAQ](#faq) abaixo. |
| **FB account not linked** / `147003` | O handle está em uso numa Página do Facebook que não associou a este número de telefone. | Associe o número de telefone à Página (controlo total, ou acesso parcial com gerir telefone) e tente novamente. |
| **IG account not linked** / `147004` | O handle está em uso numa conta do Instagram que não associou a este número de telefone. | Associe o número de telefone à conta do Instagram e tente novamente. |
| **Username transfer required** / `147005` | O handle já está noutro número de telefone no seu portefólio. | Mova-o: na API, reenvie com `"transfer_action": "force_transfer"`. |
| **Account not registered** / `133010` | O número de telefone não foi registado para utilização de API. | Termine o registo do número na WABA e tente novamente. |
| `100` Param invalid | O handle não respeita as regras de formato. | Verifique as [regras](#regras-de-nome-de-utilizador) acima. |
## Alterar, mover ou eliminar um nome de utilizador
* Pode **alterar** o seu nome de utilizador a partir da mesma caixa de diálogo Edit. Existe um limite ao número de vezes que o pode alterar e, uma vez que liberte um handle, este pode ficar disponível para outros o reclamarem.
* Na Plataforma, um nome de utilizador pode ser **transferido entre números de telefone no mesmo portefólio empresarial**, por exemplo, de um número de teste para um número de produção, ou ao consolidar números. O próprio handle não é alterado.
* **Delete** remove o nome de utilizador do número. Só faça isto se tiver a certeza; o handle volta para o pool.
## Quando os clientes ocultam os seus números
Os nomes de utilizador de consumidor são uma funcionalidade de privacidade. Quando um cliente adota um, o seu número de telefone fica **oculto de qualquer pessoa que ainda não o tenha guardado**, incluindo empresas. Esta é a parte do lançamento que interessa para qualquer coisa ligada a um CRM.
A resposta do Meta é o **ID de utilizador com âmbito comercial (BSUID)**, um identificador estável para cada cliente que é único no seu portefólio empresarial. Desde abril de 2026 aparece em cada webhook recebido. O número de telefone do cliente é incluído junto dele apenas quando uma de três condições se aplica: trocou uma mensagem ou chamada nos últimos 30 dias, o cliente está na sua lista de contactos comerciais ou o cliente partilhou explicitamente os seus detalhes de contacto. Caso contrário, o número é omitido e apenas o BSUID é fornecido. O Meta também fornece um botão **Request contact info** que as empresas podem enviar para pedir a um cliente que partilhe o seu número na conversa.
As consequências práticas:
* Um cliente que lhe envia mensagens através do seu nome de utilizador pode nunca partilhar o seu número de telefone.
* Se os seus fluxos de trabalho dependem do número de telefone como chave do cliente, precisam de tratar antes um ID estável. O Meta exige que todas as empresas e parceiros da Plataforma suportem BSUID.
* Onde um fluxo de trabalho precisa do número, como envio ou uma chamada de retorno, peça-o na conversa em vez de assumir que virá com a mensagem.
## FAQ
O Meta fornece duas vias. Para representação falsa, utilize o canal **Report Abuse** no Meta Direct Support. Para violação de marca registada, utilize o Formulário de Contacto de Propriedade Intelectual do WhatsApp. Ter a sua Página do Facebook e conta do Instagram associadas ao número, e a Verificação de Negócio completa, reforça o caso.
Não. O distintivo Conta Oficial de Negócio é um pedido separado no mesmo separador Profile e não é obrigatório. Os nomes de utilizador precisam da condição de limite de mensagens acima, não do visto azul.
O WhatsApp diz que, para empresas Meta Verified com um endereço de página web personalizado, o nome de utilizador comercial corresponde automaticamente a esse endereço e já está reservado. Verifique a secção Username no WhatsApp Manager para confirmar.
Esta página não cobre a app. Na app, os nomes de utilizador são reservados a partir do seu perfil de negócio no telefone (não no WhatsApp Web) e não é necessária Verificação de Negócio. Se utiliza a app e o Flowella em conjunto, consulte [Coexistência](/pt/meta/co-existence).
Assim que o seu nome de utilizador estiver ativo, partilhe-o em qualquer lugar onde atualmente partilhe o seu número. Os links rastreados e códigos QR do Flowella continuam a funcionar como hoje; consulte [Pontos de entrada](/pt/app/entry-points) e [Click-to-chat](/pt/campaigns/click-to-chat).
## Fontes
* Centro de Ajuda WhatsApp: [About usernames on WhatsApp Business](https://faq.whatsapp.com/1131753190029163/)
* Centro de Ajuda WhatsApp: [About username reservations on WhatsApp Business](https://faq.whatsapp.com/) (ligado a partir do artigo acima)
* Meta for Developers: [Business-scoped user IDs](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids/) (nomes de utilizador reservados, API de nome de utilizador, códigos de erro, regras de formato, prioridade de exibição)
* Meta for Developers: [Messaging limits](https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits)
## Relacionado
A forma mais rápida de contornar "Account not eligible".
Como funciona o escalão inicial e como o ultrapassar.
O nome que os clientes veem acima do seu nome de utilizador.
Tudo o que tem de estar pronto antes deste passo.