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

# Tokens de acesso e permissões do WhatsApp no Flowella

> Os tokens de acesso e permissões por trás de cada pedido à WhatsApp Business Platform, o que o Flowella guarda e o que fazer quando o acesso falha.

Cada pedido à WhatsApp Business Platform leva um **token de acesso**, e as **permissões** concedidas com esse token decidem o que o pedido pode fazer. Uma empresa que chama a API a partir da sua própria app cria o seu próprio token. O software que muitas empresas ligam, como o Flowella, recebe um token para cada empresa quando essa empresa conclui a janela pop-up de registo da Meta. Com o Flowella, nunca cria, copia ou cola um token da Meta.

> [!NOTE]
>
> **No Flowella.** Suportado. Concede ao Flowella quatro permissões na janela pop-up da Meta. O Flowella guarda o token que recebe encriptado, nunca o mostra e verifica a cada hora se continua a funcionar. Quando o token deixa de funcionar ou está perto de expirar, o Flowella envia aos proprietários e administradores da sua organização um email com uma ligação para voltar a ligar. As chaves da [API REST do Flowella](https://knowledge.flowella.io/pt/settings/api-keys.md) são independentes dos tokens da Meta.

## Tipos de token da Meta

| Token | Quem o usa | Quanto tempo dura |
| - | - | - |
| **System user token** | Uma empresa que chama a API com a sua própria app, para as suas próprias contas | Longa duração. Escolhe uma data de expiração quando o gera em **Business settings → System users**. |
| **Business integration system user token** ("business token") | Empresas de software que atuam em nome de empresas que se ligam através do Embedded Signup. Cada token está limitado a uma empresa. | Longa duração, para que o trabalho automático não obrigue a empresa a iniciar sessão novamente |
| **User token** | Programadores que fazem testes a partir do App Dashboard ou do Graph API Explorer | Curta. A própria Meta recomenda mudar para um system user token ou um business token. |

Quando conclui a janela pop-up, a Meta devolve um código ao Flowella, e o Flowella troca-o por um token de longa duração para a sua empresa. Consulte [A janela pop-up de registo da Meta](https://knowledge.flowella.io/pt/whatsapp/accounts/embedded-signup.md).

## Permissões

A Meta controla cada endpoint por permissão. O Flowella pede as quatro.

| Permissão | Para que a Meta precisa dela |
| - | - |
| `whatsapp_business_management` | Dados da conta, modelos, números de telefone, análises e webhooks ao nível da conta |
| `whatsapp_business_messaging` | Enviar qualquer mensagem e receber mensagens recebidas e estados de entrega |
| `business_management` | Ler diretamente o portfólio de negócios, por exemplo o estado de verificação |
| `whatsapp_business_manage_events` | Enviar eventos à Meta, que o Flowella usa para comunicar leads de [anúncios Click to WhatsApp](https://knowledge.flowella.io/pt/campaigns/click-to-whatsapp-ads.md) |

Para saber o que cada permissão permite ao Flowella fazer, consulte [As permissões que concede](https://knowledge.flowella.io/pt/whatsapp/accounts/embedded-signup.md#the-permissions-you-grant). Aceite todas as permissões que a Meta lista na janela pop-up. Se faltar uma, as funcionalidades que dependem dela falham.

Antes de os clientes poderem conceder uma permissão à app de uma empresa de software, a Meta tem de ter aprovado essa app para **Advanced access** a essa permissão através do App Review. Isso é responsabilidade do Flowella. A sua empresa não precisa de App Review para usar o Flowella.

## Pessoas no seu portfólio de negócios

O acesso dos seus colegas ao WhatsApp Manager é independente do acesso do Flowella. A Meta divide agora cada conta numa **WhatsApp account** e numa **Messaging account**, e dá acesso às pessoas a cada uma delas no Meta Business Suite.

1. No [Meta Business Suite](https://business.facebook.com), abra as **Settings** do seu portfólio de negócios.
2. Aceda a **Accounts → WhatsApp accounts**, selecione a conta, abra **People** e selecione **Add people**.
3. Repita em **Accounts → Messaging accounts**. O Meta Business Suite não copia o acesso de uma para a outra.

Para saber quem pode fazer o quê dentro do Flowella, consulte [Equipa](https://knowledge.flowella.io/pt/settings/team.md). Para os dois tipos de conta, consulte [Messaging accounts e WhatsApp accounts](https://knowledge.flowella.io/pt/whatsapp/accounts/whatsapp-business-account.md#messaging-accounts-and-whatsapp-accounts).

## Quando o acesso deixa de funcionar

O Flowella perde o acesso quando o token expira, quando a Meta o revoga ou quando alguém remove o acesso do Flowella ou uma permissão na Meta. O Flowella pode continuar a mostrar o WhatsApp como **Connected** enquanto isto acontece.

| O que vê | O que significa | O que fazer |
| - | - | - |
| Um email do Flowella a pedir-lhe para voltar a ligar o WhatsApp | A verificação horária do Flowella detetou que o token já não funciona ou que vai expirar em breve | [Voltar a ligar o número](https://knowledge.flowella.io/pt/troubleshooting/whatsapp-connection.md#reconnect-the-number) |
| O banner "WhatsApp needs reconnecting. Template sends are held until the connection is restored." | O Flowella está a reter os envios de modelos até o acesso ser reposto | [Voltar a ligar o número](https://knowledge.flowella.io/pt/troubleshooting/whatsapp-connection.md#reconnect-the-number). O Flowella envia depois o que estava a reter. |
| Erro `190` | O token expirou ou foi revogado | [Voltar a ligar o número](https://knowledge.flowella.io/pt/troubleshooting/whatsapp-connection.md#reconnect-the-number) |
| Erro `3`, `10` ou `200` a `299` | Uma permissão de que o Flowella precisa não foi concedida ou foi removida | Nas Meta Business Settings, abra **Connected apps** e selecione **Flowella** para ver a que ativos tem acesso. Depois volte a ligar e aceite todas as permissões. |

> [!WARNING]
>
> Não remova o número no Flowella para corrigir uma ligação. Remover um número elimina as respetivas conversas, notas e lista de opt-out no Flowella.

Consulte [Erros de acesso e permissões](https://knowledge.flowella.io/pt/whatsapp/errors/error-codes.md#access-and-permissions) para a lista completa.

## Remover o acesso do Flowella

Existem dois níveis, e fazem coisas diferentes.

| Ação | Onde | O que acontece |
| - | - | - |
| Deixar de usar um número | **Remove** em **Settings → WhatsApp (Meta)** | O Flowella elimina as conversas, notas e lista de opt-out desse número. O acesso do Flowella na Meta mantém-se e o número continua registado. Consulte [Remover um número](https://knowledge.flowella.io/pt/account/meta-integration.md#remove-a-number). |
| Retirar completamente o acesso do Flowella | Meta Business Settings, **Connected apps**, **Flowella** | O Flowella deixa de poder enviar ou receber na conta. As suas conversas e contactos ficam no Flowella até remover os números ou pedir ao Flowella para eliminar os seus dados. |

Se vai deixar o Flowella, guarde uma cópia do que precisar, remova os números no Flowella e depois retire o acesso na Meta. Para eliminar os restantes dados, contacte o [suporte do Flowella](https://flowella.io/support). Consulte [Retenção e eliminação de dados](https://knowledge.flowella.io/pt/security/data-security.md#retenção-e-eliminação-de-dados).

## Relacionado

> [card] [Janela pop-up de registo da Meta](https://knowledge.flowella.io/pt/whatsapp/accounts/embedded-signup.md)
>
> Cada ecrã da janela pop-up e as permissões que concede.

> [card] [Problemas de ligação do WhatsApp](https://knowledge.flowella.io/pt/troubleshooting/whatsapp-connection.md)
>
> Sinais de que a ligação caiu e como voltar a ligar.

> [card] [Segurança dos dados](https://knowledge.flowella.io/pt/security/data-security.md)
>
> O que o Flowella guarda e como está protegido.

> [card] [Chaves de API](https://knowledge.flowella.io/pt/settings/api-keys.md)
>
> Chaves para a API REST do Flowella.

Verificado com a documentação da Meta a 18 de novembro de 2026: [Access tokens](https://developers.facebook.com/documentation/business-messaging/whatsapp/access-tokens) e [Permissions](https://developers.facebook.com/documentation/business-messaging/whatsapp/permissions).


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