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

# IDs de utilizador WhatsApp: números, BSUIDs e usernames

> Como o WhatsApp identifica clientes por número de telefone, wa_id, BSUID e nome de utilizador, quando a Meta omite o número e o que o Flowella precisa.

O WhatsApp identifica agora cada cliente de até quatro formas: o **número de telefone**, o **WhatsApp ID** (`wa_id`, normalmente o número sem o sinal de mais), um **ID de utilizador associado à empresa** (BSUID) que é único para a sua empresa, e um **nome de utilizador** opcional. À medida que os clientes adotam nomes de utilizador, a Meta deixa de enviar às empresas os números de telefone de alguns clientes. O BSUID passa então a ser o único identificador que recebe, por isso tudo o que dependa de números de telefone tem de funcionar sem eles.

> [!NOTE]
>
> **No Flowella.** Parcialmente suportado. O Flowella identifica cada contacto pelo número de telefone e só envia para números de telefone. Se a Meta enviar a mensagem de um cliente sem 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. A maioria dos clientes ainda não é afetada: a Meta continua a incluir o número de qualquer pessoa com quem tenha estado em contacto recentemente.

## Os quatro identificadores

| Identificador | Campo nos dados da Meta | Âmbito | Notas |
| - | - | - | - |
| Número de telefone | `wa_id`, `from` | Global | Pode faltar para clientes com nome de utilizador |
| ID de utilizador associado à empresa | `user_id` | Um portfólio de negócios | Sempre presente nas mensagens, para todos os clientes, desde abril de 2026 |
| Parent BSUID | `parent_user_id` | Vários portfólios que a Meta inscreveu em conjunto | Apenas para grandes empresas com vários portfólios, mediante pedido |
| Nome de utilizador | `username` | Global | Opcional. Os clientes podem alterá-lo. Aparece em vez do número de telefone no WhatsApp. |

### Como é um BSUID

Um BSUID começa pelo código de país de duas letras do cliente e um ponto, seguido de até 128 letras e números, por exemplo `GB.13491208655302741918`. Um parent BSUID tem `ENT` depois do código de país, por exemplo `GB.ENT.11815799212886844830`. Use sempre o valor completo.

* Pertence a um **portfólio de negócios**. Qualquer número desse portfólio lhe pode enviar mensagens, mas um número de outro portfólio não.
* É criado automaticamente e não muda quando o cliente altera o nome de utilizador.
* **Muda** quando o cliente altera o número de telefone. A Meta envia uma mensagem de sistema quando isso acontece.

## Quando a Meta omite o número de telefone

Um cliente que adota um nome de utilizador fica com o número oculto. A Meta continua a incluí-lo nos seus webhooks quando se verifica qualquer uma destas condições:

| Condição | Âmbito |
| - | - |
| Esse número da empresa enviou uma mensagem ou ligou para o número do cliente nos últimos 30 dias | Cada número da empresa separadamente |
| Esse número da empresa recebeu uma mensagem ou chamada do número do cliente nos últimos 30 dias | Cada número da empresa separadamente |
| O cliente está no **contact book** do seu portfólio de negócios | Todos os números do portfólio |
| O cliente partilhou o número consigo, por exemplo com um botão de pedido de dados de contacto | A partir daí, através do contact book |

Os clientes sem nome de utilizador chegam sempre com o número de telefone.

### O contact book

A Meta mantém um contact book para cada portfólio de negócios. Quando qualquer um dos seus números envia uma mensagem ou liga para o número de telefone de um cliente, ou recebe contacto dele, a Meta regista o número com o BSUID e continua a incluir o número nos seus webhooks. Só regista contactos a partir do momento em que a funcionalidade começou, e não conversas anteriores. Pode desativá-lo no Meta Business Suite em **Business settings** > **Business info**. Desativá-lo elimina permanentemente tudo o que tem guardado.

## Enviar para um BSUID

Desde julho de 2026, pode enviar mensagens para um BSUID em vez de um número de telefone. Se um pedido tiver ambos, a Meta usa o número de telefone. Os modelos de autenticação com botões copy code, one-tap ou zero-tap continuam a precisar do número de telefone. Os envios que não suportam BSUIDs falham com o erro `131062`.

## Pedir o número

A Meta disponibiliza um botão de **pedido de dados de contacto**, em modelos de utilidade e de marketing ou numa mensagem interativa. Quando o cliente lhe toca, o número de telefone é partilhado na conversa e adicionado ao seu contact book. O texto do botão não pode ser alterado.

> [!NOTE]
>
> **No Flowella.** O editor de modelos do Flowella não disponibiliza o botão de pedido de dados de contacto, e o Flowella não consegue enviar para um BSUID. Quando um processo precisa do número, como uma entrega ou uma chamada de retorno, peça-o num Flow ou na conversa.

## O que fazer agora

* **Mantenha o contacto com os clientes.** Os clientes com quem trocou mensagens nos últimos 30 dias, ou que estão no seu contact book, continuam a chegar com o número.
* **Mantenha o contact book ativado**, para que os números continuem a chegar depois dos 30 dias.
* **Recolha o número de telefone nos seus formulários e Flows** para os processos que dependem dele.
* **Verifique as suas próprias integrações.** Tudo o que recebe os webhooks do Flowella ou lê dados da Meta diretamente não deve assumir que todos os clientes têm número de telefone.

## Relacionado

> [card] [Nome de utilizador da empresa](https://knowledge.flowella.io/pt/whatsapp/accounts/business-username.md)
>
> Reserve o nome de utilizador da sua empresa.

> [card] [Tipos de mensagem](https://knowledge.flowella.io/pt/whatsapp/messaging/message-types.md)
>
> O que os clientes e as empresas podem enviar.

> [card] [Privacidade e residência de dados](https://knowledge.flowella.io/pt/whatsapp/messaging/data-privacy-and-residency.md)
>
> Como a Meta guarda os dados das mensagens.

> [card] [Alterações à plataforma](https://knowledge.flowella.io/pt/whatsapp/platform-changes.md)
>
> Quando os nomes de utilizador chegam aos clientes.

Verificado com base na documentação [Business-scoped user IDs](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids) da Meta a 18 de novembro de 2026.


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