# Conectar o WhatsApp com token (usuário do sistema da Meta)

> Para quem já usa a API oficial com um app próprio na Meta: gere o token do usuário do sistema e ligue a conta do WhatsApp Business pelo ID e pelo token.

Endereço: https://help.nextags.com.br/tutoriais/canais/conectar-whatsapp-token/
Tipo: Tutorial · Avançado

Atualizado em: 24/10/2026

> **Resposta rápida**
>
> Na Meta, gere um token de usuário do sistema com acesso à conta do WhatsApp Business. Na NexTags, em **Configurações** › **Canais** › **WhatsApp** › **Conectar**, marque **Conecte uma conta comercial do WhatsApp existente.** e **Conexão manual usando token de acesso do usuário do sistema.**, preencha o ID da conta e o token, clique em **Continuar** e conecte o número.

> **Caminho avançado:**
> O token de usuário do sistema é feito para quem desenvolve com um app próprio na Meta. Para conectar o primeiro WhatsApp, use o [cadastro da Meta](https://help.nextags.com.br/tutoriais/canais/conectar-whatsapp-oficial/), que cria e liga tudo sozinho.

**Antes de começar**

- Uma conta do WhatsApp Business na Meta, com o número que você vai conectar.
- Um app do Facebook ligado ao portfólio empresarial da empresa: sem ele, a Meta não deixa criar usuários do sistema.
- Acesso às **Configurações** do portfólio no Meta Business Suite.

## Passo a passo

### Passo 1: Crie o usuário do sistema na Meta

No Meta Business Suite, abra as **Configurações**. Na aba **Usuários**, selecione **Usuários do sistema** e clique em **Adicionar novo usuário do sistema**. Dê um nome e clique em **Criar usuário do sistema**.

Depois, atribua os ativos a esse usuário: o app (com controle total) e a conta do WhatsApp Business. Mais detalhes na [Central de Ajuda da Meta](https://www.facebook.com/business/help/503306463479099).

### Passo 2: Gere o token

No usuário do sistema, clique em **Gerar novo token**. Selecione o app e marque as permissões **business_management**, **whatsapp_business_management** e **whatsapp_business_messaging**. Escolha a validade e clique em **Gerar token**.

Copie o token e guarde num lugar seguro. Um token com validade para de funcionar quando vence. Mais detalhes na [documentação da Meta](https://developers.facebook.com/docs/whatsapp/access-tokens).

### Passo 3: Copie o ID da conta do WhatsApp Business

Nas **Configurações** do Meta Business Suite, abra as contas do WhatsApp (no modelo novo da Meta, **Contas de mensagens**) e clique na conta: o número de identificação aparece no painel. Não confunda com o ID do portfólio nem com o da página do Facebook.

### Passo 4: Abra o WhatsApp em Configurações › Canais

Na NexTags, clique em **Configurações**, no pé do menu da esquerda, e abra a aba **Canais** (1). Clique no cartão **WhatsApp** (2) e em **Conectar** (3).

![Configurações › Canais com o cartão WhatsApp aberto e Não conectado: a linha WhatsApp com o botão Conectar e o texto Essa integração permite criar bots do WhatsApp.](https://help.nextags.com.br/_img/canais-conectar/whatsapp-conectar.webp)
*1. A aba Canais. 2. O cartão WhatsApp. 3. Conectar.*

1. **Canais**: a aba dos canais, nas Configurações.
2. **WhatsApp**: o cartão abre com um clique.
3. **Conectar**: abre a tela de conexão do WhatsApp.

### Passo 5: Marque as duas opções e cole o ID e o token

Marque **Conecte uma conta comercial do WhatsApp existente.** (1). Embaixo dela aparece **Conexão manual usando token de acesso do usuário do sistema.**: marque também (2). Preencha os campos (3 e 4) e clique em **Continuar** (5).

![Tela WhatsApp com as opções Conecte uma conta comercial do WhatsApp existente e Conexão manual usando token de acesso do usuário do sistema marcadas: aparecem os campos ID da Conta Comercial do WhatsApp (WABA) e Access Token.](https://help.nextags.com.br/_img/canais-conectar/whatsapp-token.webp)
*1 e 2. As duas opções marcadas. 3. O ID da conta. 4. O token. 5. Continuar.*

1. **Conecte uma conta comercial do WhatsApp existente.**: liga uma conta que já existe na Meta.
2. **Conexão manual usando token de acesso do usuário do sistema.**: troca a janela da Meta pelos campos do ID e do token.
3. **ID da Conta Comercial do WhatsApp (WABA)**: o ID que você copiou.
4. **Access Token**: o token do usuário do sistema.
5. **Continuar**: busca os números dessa conta.

### Passo 6: Escolha o número

Em **Selecione um número de telefone**, clique em **Conectar** (1) ao lado do número. **Conectado** aparece no número que já está conectado.

![Tela WhatsApp com a lista Selecione um número de telefone: cada número com o ID embaixo; o primeiro marcado como Conectado e o segundo com o botão Conectar.](https://help.nextags.com.br/_img/canais-conectar/whatsapp-numero.webp)
*1. Conectar, ao lado do número.*

1. **Conectar**: liga esse número à sua conta da NexTags. Embaixo de cada número fica o ID dele na Meta.

## Pronto: como conferir

A NexTags mostra o aviso de sucesso e abre o **Dashboard**, com o WhatsApp em **Canais conectados**. Em **Configurações** › **Canais**, o cartão **WhatsApp** mostra **Conectado**.

![Cartão WhatsApp conectado: a linha WhatsApp com o botão Configurações, que abre a tela do número, e a linha com o botão Desconectar.](https://help.nextags.com.br/_img/canais-conectar/whatsapp-conectado.webp)
*O cartão WhatsApp conectado.*

1. **Configurações**: a tela do número, com o status e os IDs. Veja [A tela do número](https://help.nextags.com.br/tutoriais/canais/tela-do-numero/).
2. **Desconectar**: tira o número da conta.

## Se não funcionou

### Apareceu "No phone number found on the WhatsApp Business Account."

A conta desse ID não tem números. Confira se copiou o ID da conta do WhatsApp Business certa, e não o do portfólio.

### Apareceu uma mensagem de erro da Meta

O token não tem acesso à conta ou às permissões. Confira se o usuário do sistema recebeu a conta do WhatsApp Business e se o token tem as três permissões. Gere outro token se precisar.

### Apareceu "Já conectado a outra conta comercial."

O número já está em outra conta da NexTags (o aviso mostra o ID e o nome dela). Desconecte lá e conecte de novo aqui. Veja [Desconectar ou trocar a conta conectada](https://help.nextags.com.br/tutoriais/canais/desconectar-ou-trocar/).

### A segunda opção não aparece

**Conexão manual usando token de acesso do usuário do sistema.** só aparece depois que você marca **Conecte uma conta comercial do WhatsApp existente.**.

### Faça com a IA

Cole este pedido no ChatGPT ou no Claude:

```text
Vou ligar o WhatsApp da minha empresa à NexTags com um token de usuário do sistema da Meta. Leia este tutorial: https://help.nextags.com.br/tutoriais/canais/conectar-whatsapp-token.md

Me guie no Meta Business Suite, um passo por vez, para criar o usuário do sistema, dar acesso ao app e à conta do WhatsApp Business e gerar o token com as permissões certas. Me avise sobre cuidados para guardar o token. Hoje eu tenho: [descreva o seu app e a sua conta na Meta].
```