# Como conectar o WhatsApp Cloud API inserindo credenciais (token da Meta)

Conectar o WhatsApp oficial (Cloud API) **inserindo as credenciais manualmente** é a alternativa ao botão "Conectar via Meta". É o caminho ideal quando você quer usar um **token permanente** gerado no seu próprio Meta Business — sem depender do login OAuth.

Este guia tem duas partes: primeiro você gera as credenciais na Meta, depois cola tudo na plataforma. Reserve uns 10 minutos. ⏱️

## O que você vai precisar

- Uma conta no [Meta Business Suite](https://business.facebook.com) com a **conta do WhatsApp Business (WABA)** já criada;
- Um **app** criado no [Meta for Developers](https://developers.facebook.com) com o produto **WhatsApp** adicionado;
- Acesso de administrador ao Business.

---

## Parte 1 — Gerar as credenciais na Meta

### 1. Crie (ou use) um Usuário do Sistema

No **Meta Business Suite**, acesse **Configurações → Usuários → Usuários do sistema** — ou vá direto pelo link:

👉 [business.facebook.com/latest/settings/system_users](https://business.facebook.com/latest/settings/system_users)

![Menu Configurações — Usuários do sistema](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBL3lrQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--df769478682c27e8f54ca316fcd169637c1108e2/menu-usuarios-do-sistema.png)

Se ainda não tiver um, clique em **Adicionar** e crie um usuário do tipo **Admin** (ex.: `wa-user`).

Depois, na aba **Ativos atribuídos**, adicione os ativos que ele vai acessar: o **app** e a **conta do WhatsApp Business** — com acesso total.

### 2. Gere o token permanente

Com o usuário do sistema selecionado, clique em **Gerar token** (canto superior direito):

![Usuários do sistema — botão Gerar token](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBN09rQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--da01f2613c48f7a6025bc7302ac5c907e024c451/meta-usuarios-sistema-gerar-token.jpeg)

No assistente:

1. **Selecionar app**: escolha o seu app;
2. **Definir expiração**: escolha **Nunca** (é isso que torna o token permanente);
3. **Atribuir permissões**: marque estas **4 permissões**:
   - `business_management`

![Permissão business_management](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBN1NrQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--98d950634d173005d27633a81388e4a3b463a0a7/permissoes-business-management.jpeg)

   - `whatsapp_business_manage_events`
   - `whatsapp_business_management`
   - `whatsapp_business_messaging`

![Permissões do WhatsApp Business](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBN1drQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--59cfb0323c15f94dd2f9b9aa32371c9a86f893eb/permissoes-whatsapp.jpeg)

4. **Concluir** e **copie o token** com atenção — ele aparece **uma única vez**. Guarde em local seguro.

### 3. Anote os IDs do número e da conta

No [WhatsApp Manager](https://business.facebook.com/wa/manage) (ou no painel do app, em **WhatsApp → Configuração da API**), localize e copie:

- **ID do número de telefone** (*Phone number ID*) — o identificador do número que vai ser conectado;
- **ID da conta do WhatsApp Business** (*WhatsApp Business Account ID / WABA ID*).

💡 Os dois aparecem juntos na tela "Configuração da API" do produto WhatsApp no seu app.

---

## Parte 2 — Conectar na plataforma

### 4. Crie o canal

Acesse **Configurações → Canais → Adicionar canal** e escolha **WhatsApp**:

![Escolha um canal — WhatsApp](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNitrQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--b81cfb71c7087c43219cd694f925766ebbc26801/escolha-canal-whatsapp.jpeg)

### 5. Selecione o provedor Cloud

Entre os provedores, escolha **Cloud do WhatsApp**:

![Selecione seu provedor — Cloud do WhatsApp](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBN0NrQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--b6f8704db1f4faf9ded57ff293ecc6fc21fa5925/provedor-cloud-whatsapp.jpeg)

### 6. Escolha "Inserir credenciais"

Na pergunta "Como deseja conectar?", selecione **Inserir credenciais**:

![Como deseja conectar — Inserir credenciais](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBN0drQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--36d571ff9378d52da179504466e05db89137ec1e/inserir-credenciais.jpeg)

### 7. Preencha o formulário

![Formulário do Cloud do WhatsApp](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBN0trQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--0c7d96ab00fe3a2113fbd21a3b7fa1c2135bbae6/formulario-cloud-api.jpeg)

| Campo | O que colocar |
|---|---|
| **Nome do Canal** | Um nome interno para identificar o canal (ex.: "WhatsApp Vendas") |
| **Número de telefone** | O número completo do WhatsApp, com DDD |
| **ID do número de telefone** | O *Phone number ID* copiado no passo 3 |
| **ID da conta do WhatsApp Business** | O *WABA ID* copiado no passo 3 |
| **Token de Acesso** | O token permanente gerado no passo 2 |

Clique em **Criar canal do WhatsApp** ✅

Pronto! O canal é criado e o webhook do número é configurado **automaticamente** — as mensagens começam a chegar na plataforma em seguida.

---

## Problemas comuns

- **"Token inválido"**: confira se o token foi copiado inteiro e se as 4 permissões do passo 2 foram marcadas. Tokens temporários (do painel de teste do app) expiram em 24h — use sempre o token do **usuário do sistema** com expiração "Nunca";
- **Mensagens não chegam**: verifique se o usuário do sistema tem a **WABA atribuída** nos ativos (passo 1) e se o número está com o status "Conectado" no WhatsApp Manager;
- **Número já usado em outra plataforma**: um número Cloud API só entrega mensagens para um webhook por vez — desconecte da outra ferramenta antes;
- **Quer enviar mensagens fora da janela de 24h?** Cadastre e aprove **templates** no WhatsApp Manager — eles aparecem automaticamente na plataforma após a sincronização.

Qualquer dificuldade, fale com o nosso suporte. 💙