> ## 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

> Reserve o nome de utilizador da sua empresa no WhatsApp Manager antes que outra pessoa o faça: requisitos, passos, regras, erros e impacto no Flowella.

O WhatsApp está a introduzir **nomes de utilizador**. Em vez de um número de telefone, a sua empresa recebe um identificador como `@yourbrand` que os clientes podem escrever no WhatsApp para iniciar uma conversa. As reservas de nomes de utilizador de empresas abriram a **29 de junho de 2026**, e a funcionalidade está a ser ativada país a país ao longo dos meses seguintes. Os nomes de utilizador são atribuídos por ordem de chegada, por isso esta página explica como reservar já o seu na WhatsApp Business Platform, mesmo que ainda não esteja ativo no seu país.

Este guia abrange apenas a via da **WhatsApp Business Platform**, que é a que utiliza se o WhatsApp funciona através do Flowella ou de outro sistema, e não através da app WhatsApp Business num telemóvel.

> [!NOTE]
>
> **Última verificação a 13 de setembro de 2026** com base no WhatsApp Help Center e na documentação para programadores da Meta. A Meta ainda está a implementar esta funcionalidade, por isso consulte as [fontes](#sources) se algo no ecrã não corresponder.

## Porquê reservar agora

* **Os nomes de utilizador são únicos e atribuídos por ordem de chegada.** Quando um identificador é ocupado por qualquer conta WhatsApp, de consumidor ou de empresa, mais ninguém o pode usar.
* **Os identificadores correspondentes do Facebook e do Instagram ficam guardados para os seus titulares, mas apenas durante um tempo limitado.** A 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 indica que existe um prazo limitado para o fazer e não publicou uma data de fim. Depois desse prazo, não há garantia de que o identificador continue disponível.
* **Não tem custos.** Reservar um nome de utilizador não tem taxa, e pode alterá-lo ou eliminá-lo mais tarde.
* **Protege a sua marca mesmo que ainda não tenha planos para o WhatsApp.** Um nome de utilizador reservado fica guardado para o seu número de telefone e não pode ser reclamado por mais ninguém.

## O que um nome de utilizador de empresa faz e não faz

Um nome de utilizador de empresa é uma forma de os clientes o contactarem **sem precisarem do seu número de telefone**. Quando estiver ativo, os clientes que não têm o seu número guardado veem o seu nome de utilizador em vez do número nas conversas, grupos e chamadas.

Convém ser claro quanto aos limites:

* **Não oculta o número de telefone da empresa.** O seu número continua no perfil empresarial. A documentação da Meta é explícita: os nomes de utilizador de empresas não são uma funcionalidade de privacidade, ao contrário dos nomes de utilizador de consumidores.
* **Não existe um diretório.** Ninguém pode navegar ou pesquisar pela sua empresa. Os clientes têm de escrever o seu nome de utilizador exato, por isso coloque-o no seu site, sinalética, assinaturas de email e perfis nas redes sociais quando estiver ativo.
* **Um nome de utilizador por número de telefone.** Se a sua WhatsApp Business Account tiver vários números, cada um precisa do seu próprio nome de utilizador.
* **O nome de utilizador é distinto do nome a apresentar.** O nome a apresentar continua a passar pela revisão da Meta e continua a aparecer aos clientes. Consulte [Nome a apresentar e perfil](https://knowledge.flowella.io/pt/whatsapp/accounts/profile-setup.md).

### Como o seu nome aparece numa conversa

A Meta apresenta a identidade da empresa por esta ordem de prioridade. O primeiro que se aplicar é o que o cliente vê.

1. O nome com que o cliente o guardou nos contactos
2. O seu nome de empresa verificado, ou o nome da sua Official Business Account
3. O seu nome de utilizador
4. O seu número de telefone

Assim, quando a Meta aprovar o seu nome a apresentar, os clientes que não guardaram o seu número veem esse nome e não o nome de utilizador. Consulte [Nomes a apresentar](https://knowledge.flowella.io/pt/whatsapp/accounts/display-names.md#how-meta-reviews-a-name).

## Antes de começar

Precisa de ter tudo o que se segue. Se faltar algo, siga primeiro a [Sequência de configuração](https://knowledge.flowella.io/pt/whatsapp/accounts/setup-sequence.md).

**1. Um portfólio de negócios Meta com uma WhatsApp Business Account**

O nome de utilizador é definido num número de telefone que pertence a uma WhatsApp Business Account (WABA) dentro do seu portfólio. Consulte [Portfólio de negócios](https://knowledge.flowella.io/pt/whatsapp/accounts/business-portfolio.md) e [WhatsApp Business Account](https://knowledge.flowella.io/pt/whatsapp/accounts/whatsapp-business-account.md).

**2. Um número de telefone registado na Platform**

O número tem de estar registado para utilização da API na WABA. Um número que foi adicionado mas ainda não registado devolve o erro `133010` quando tenta definir um nome de utilizador. Consulte [Números de telefone](https://knowledge.flowella.io/pt/whatsapp/accounts/phone-numbers.md).

**3. Um limite de mensagens acima do nível inicial**

A Meta exige que o portfólio de negócios tenha um **limite de mensagens superior** ao nível com que todos os novos portfólios começam (250 destinatários únicos num período móvel de 24 horas). Caso contrário, o WhatsApp Manager mostra **Account not eligible** e a API devolve o erro `147002`. A forma mais rápida de ultrapassar isto é concluir a [Verificação da empresa](https://knowledge.flowella.io/pt/whatsapp/accounts/business-verification.md), após a qual a Meta pode aumentar o limite para 2.000. Enviar 2.000 mensagens de alta qualidade a destinatários únicos em 30 dias também funciona, mas demora mais. Consulte [Limites de mensagens](https://knowledge.flowella.io/pt/whatsapp/limits/messaging-limits.md).

**4. As permissões certas**

Para definir um nome de utilizador, precisa de acesso de administrador à WABA ou ao número de telefone. Se quiser reclamar um identificador que já está em uso na sua Página do Facebook ou conta do Instagram, precisa também de **controlo total** dessa Página ou conta, ou de **acesso parcial com a permissão de gerir telefone**, porque a Meta exige que associe primeiro o número de telefone a essa Página ou conta.

> [!TIP]
>
> Se não tiver a certeza de qual é o seu limite de mensagens, abra **WhatsApp Manager → Account tools → Messaging limits**. Qualquer valor acima de 250 é suficiente.

## Reservar o nome de utilizador no WhatsApp Manager

Esta é a via recomendada.

**1. Abrir o WhatsApp Manager**

Aceda a [business.facebook.com/latest/whatsapp\_manager/phone\_numbers](https://business.facebook.com/latest/whatsapp_manager/phone_numbers/) e, se lhe for pedido, selecione o portfólio de negócios a que pertence a sua WABA.

**2. Selecionar o número de telefone**

No menu da esquerda, em **Account tools**, clique em **Phone numbers** e depois no número a que quer dar um nome de utilizador. O painel de detalhes do número abre-se à direita.

**3. Abrir o separador Profile**

No topo do painel de detalhes, clique em **Profile**. Desça para além de **Profile picture** e **Display name** até à secção **Username**.

**4. Clicar em Create (ou Edit)**

Se o número ainda não tiver nome de utilizador, clique em **Create**. Se já tiver um, clique em **Edit**. Abre-se a caixa de diálogo **Edit username**.

**5. Escolher uma sugestão ou escrever o seu**

A caixa de diálogo mostra uma linha **Suggested**. Estes são os nomes de utilizador que a 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 site, e têm maior probabilidade de aprovação. Clique num deles ou escreva o seu próprio identificador no campo. Um visto verde significa que está disponível. **This username is not available** significa que está ocupado ou não passa nas verificações da Meta.

**6. Guardar**

Clique em **Save**. A secção Username mostra agora **Current username: @yourhandle** com um selo de estado e a data em que foi atualizado.

> [!WARNING]
>
> Se escolheu um identificador que está em uso na sua Página do Facebook ou conta do Instagram, a Meta pede-lhe que **associe o número de telefone** a essa Página ou conta antes de guardar. Pode fazê-lo na mesma caixa de diálogo, ou adicionando diretamente o número de WhatsApp à Página ou conta do Instagram. Sem essa associação, o pedido falha com o erro `147003` (Facebook) ou `147004` (Instagram).

### O que significa o selo de estado

| Selo | Significado |
| - | - |
| **Reserved** | Aprovado e guardado para o seu número de telefone, mas ainda não visível para os utilizadores do WhatsApp. Passa automaticamente a ativo quando a Meta disponibilizar os nomes de utilizador no seu país. Entretanto, ninguém o pode reclamar. |
| **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 fica ativo. Não precisa de fazer nada.

## Outras formas de reservar

> [accordion] Meta Business Suite
>
> Aceda a **Settings → Accounts → WhatsApp accounts**, abra o separador **Phone numbers**, clique no número, desça até **Username** e clique em **Create**. É a mesma caixa de diálogo do WhatsApp Manager.

> [accordion] Username API
>
> Para programadores e fornecedores de soluções, a Meta expõe o nome de utilizador no número de telefone da empresa. O token de acesso precisa da permissão `whatsapp_business_management` com Full control ou Partial access aos números de telefone da WABA.
>
> Definir ou alterar um nome de utilizador:
>
> ```bash theme={null}
> curl -X POST "https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/username" \
>   -H "Content-Type: application/json" \
>   -H "Authorization: Bearer <ACCESS_TOKEN>" \
>   -d '{ "username": "yourbrand" }'
> ```
>
> Uma resposta bem-sucedida devolve `{ "status": "reserved" }` ou `{ "status": "approved" }`.
>
> Listar os nomes de utilizador que a Meta reservou para o seu portfólio:
>
> ```bash theme={null}
> curl "https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/username_suggestions" \
>   -H "Authorization: Bearer <ACCESS_TOKEN>"
> ```
>
> Leia o nome de utilizador e o estado atuais com `GET .../username` e remova-o com `DELETE .../username`. A referência completa está na documentação [Business-scoped user IDs](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids/) da Meta.

## Regras de nome de utilizador

* Entre 3 e 35 caracteres
* Apenas letras inglesas (a a z), algarismos (0 a 9), pontos finais (.) e sublinhados (\_). Caracteres acentuados como ñ, é ou ü são rejeitados
* Pelo menos uma letra. Um nome de utilizador não pode ter 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`
* As maiúsculas e minúsculas são ignoradas na verificação de unicidade, mas os pontos finais e sublinhados não: `myid`, `my.id` e `my_id` são três nomes de utilizador diferentes
* Alguns nomes de utilizador estão guardados pela 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 portfólio de negócios ainda está no limite de mensagens inicial. | Conclua a [Verificação da empresa](https://knowledge.flowella.io/pt/whatsapp/accounts/business-verification.md), ou aguarde até ultrapassar 250 através do volume de envios, e tente novamente. |
| **This username is not available** / `147001` | O identificador está ocupado, não passa nas verificações internas da Meta ou está guardado para outra pessoa. | Escolha outro identificador. Se for a sua marca registada e outra pessoa o tiver, consulte as [Perguntas frequentes](#faq) abaixo. |
| **FB account not linked** / `147003` | O identificador 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 gestão de telefone) e tente novamente. |
| **IG account not linked** / `147004` | O identificador 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 identificador já está noutro número de telefone do seu portfó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 da API. | Conclua o registo do número na WABA e tente novamente. |
| `100` Param invalid | O identificador não cumpre as regras de formato. | Verifique as [regras](#username-rules) acima. |

## Alterar, mover ou eliminar um nome de utilizador

* Pode **alterar** o nome de utilizador na mesma caixa de diálogo Edit. Existe um limite para o número de alterações, e quando liberta um identificador este pode ficar disponível para outros o reclamarem.
* Na Platform, um nome de utilizador pode ser **transferido entre números de telefone do mesmo portfólio de negócios**, por exemplo de um número de teste para um número de produção, ou ao consolidar números. O identificador em si mantém-se.
* **Eliminar** remove o nome de utilizador do número. Faça-o apenas se tiver a certeza, porque o identificador volta a ficar disponível.

## Quando os clientes ocultam os números

Os nomes de utilizador de consumidores são uma funcionalidade de privacidade. Quando um cliente adota um, o seu número de telefone fica **oculto para quem ainda não o tiver guardado**, incluindo empresas. Esta é a parte da implementação que importa para tudo o que está ligado a um CRM.

A resposta da Meta é o **business-scoped user ID (BSUID)**, um identificador estável para cada cliente e exclusivo da sua empresa. Desde abril de 2026 aparece em todos os webhooks recebidos. Para um cliente com nome de utilizador, a Meta inclui o número de telefone apenas quando se verifica uma destas condições: esse número da empresa trocou uma mensagem ou chamada com o cliente nos últimos 30 dias, o cliente está na sua lista de contactos Meta, ou o cliente partilhou os seus dados de contacto. Caso contrário, a Meta envia apenas o BSUID. A Meta oferece também um botão **Request contact info** que pede ao cliente que partilhe o número na conversa, mas o editor de modelos do Flowella não oferece este botão.

O que isto significa no Flowella:

* **O Flowella identifica cada contacto pelo número de telefone.** Se a Meta enviar a mensagem de um cliente sem o número de telefone, o Flowella não a consegue associar a um contacto, e a mensagem não aparece no Flowella nem chega ao HubSpot.
* **As conversas em curso continuam a funcionar.** A Meta inclui o número para os clientes que enviaram mensagens para esse número da empresa, ou que receberam dele uma mensagem ou chamada, nos últimos 30 dias.
* **Peça o número quando precisar dele.** Quando um processo depende do número, como um envio ou uma chamada de retorno, peça-o na conversa em vez de assumir que chega com cada mensagem.

Para cada identificador, quando a Meta inclui o número de telefone e como funciona o contact book, consulte [Identificadores de utilizador](https://knowledge.flowella.io/pt/whatsapp/messaging/user-identifiers.md).

## Perguntas frequentes

> [accordion] Alguém ocupou a minha marca como nome de utilizador. O que posso fazer?
>
> A Meta disponibiliza duas vias. Para usurpação de identidade, utilize o canal **Report Abuse** no Meta Direct Support. Para violação de marca registada, utilize o WhatsApp Intellectual Property Contact Form. Ter a sua Página do Facebook e conta do Instagram associadas ao número, e a Verificação da empresa concluída, reforça o seu caso.

> [accordion] Preciso do visto azul (Official Business Account) para obter um nome de utilizador?
>
> Não. O selo Official Business Account é um pedido separado no mesmo separador Profile e não é obrigatório. Os nomes de utilizador exigem a condição do limite de mensagens acima, não o visto azul.

> [accordion] Tenho Meta Verified com um endereço web personalizado. Tenho de fazer alguma coisa?
>
> O WhatsApp indica que, para empresas Meta Verified com um endereço de página web personalizado, o nome de utilizador da empresa corresponde automaticamente a esse endereço e já está reservado. Verifique a secção Username no WhatsApp Manager para confirmar.

> [accordion] Uso a app WhatsApp Business num telemóvel, não a Platform
>
> Esta página não abrange a app. Na app, os nomes de utilizador são reservados a partir do perfil empresarial no telemóvel (não no WhatsApp Web) e não é necessária a Verificação da empresa. Se usar a app e o Flowella em conjunto, consulte [Coexistência](https://knowledge.flowella.io/pt/whatsapp/accounts/co-existence.md).

> [accordion] O meu nome de utilizador funciona nos pontos de entrada e links click-to-chat do Flowella?
>
> Sim. Os links rastreados e códigos QR do Flowella (pontos de entrada, em acesso antecipado) abrem uma conversa com o número de telefone da sua empresa, por isso um nome de utilizador não os altera. Quando o seu nome de utilizador estiver ativo, pode também partilhá-lo em qualquer lado onde partilha o seu número. Consulte [Pontos de entrada](https://knowledge.flowella.io/pt/app/entry-points.md) e [Click-to-chat](https://knowledge.flowella.io/pt/campaigns/click-to-chat.md).

## Fontes

* WhatsApp Help Center: [About usernames on WhatsApp Business](https://faq.whatsapp.com/1131753190029163/)
* WhatsApp Help Center: *About username reservations on WhatsApp Business*, com link 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, Username API, códigos de erro, regras de formato, prioridade de apresentação)
* Meta for Developers: [Messaging limits](https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits)

## Relacionado

> [card] [Verificação da empresa](https://knowledge.flowella.io/pt/whatsapp/accounts/business-verification.md)
>
> A forma mais rápida de ultrapassar "Account not eligible".

> [card] [Limites de mensagens](https://knowledge.flowella.io/pt/whatsapp/limits/messaging-limits.md)
>
> Como funciona o nível inicial e como o ultrapassar.

> [card] [Nome a apresentar e perfil](https://knowledge.flowella.io/pt/whatsapp/accounts/profile-setup.md)
>
> O nome que os clientes veem acima do seu nome de utilizador.

> [card] [Sequência de configuração](https://knowledge.flowella.io/pt/whatsapp/accounts/setup-sequence.md)
>
> Tudo o que tem de estar pronto antes deste passo.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.