# Integração do WhatsApp Cloud API (Meta) no Tiflux

## 📌 📲 Integração do WhatsApp Cloud API (Meta) no Tiflux

```
📍 Localização no Tiflux:
Configurações > Geral > Integrações > Comunicação > Meta
```

***

### 🎯 Introdução

Esta documentação descreve **todo o processo de integração do WhatsApp Cloud API (Meta) ao Tiflux**, incluindo:

* Criação do aplicativo na Meta
* Configuração no portal de desenvolvedores
* Geração de token permanente
* Configuração do Webhook
* Ativação do número
* Configurações pós-integração

Os procedimentos utilizam os portais oficiais da Meta:

* 🌐 <https://developers.facebook.com/>
* 🌐 <https://business.facebook.com/>

***

### 📚 Sumário

* 🔄 Pré-requisitos
* ⚙️ Criação do Aplicativo no Meta Developers
* 🔐 Geração do Token Permanente
* 🔗 Configuração no Tiflux
* 📡 Configuração do Webhook
* ✅ Ativação do Número no WhatsApp Manager
* 💳 Forma de Pagamento e Verificação da Empresa
* ⚠️ Avisos Importantes
* ❓ Perguntas Frequentes (FAQ)
* 🔍 Palavras-chave para indexação

***

### 🔄 Pré-requisitos

Antes de iniciar:

✅ Número **não pode estar vinculado ao WhatsApp comum ou Business no celular**\
(se estiver, deve ser excluído do aparelho)

✅ Conta no **Meta Business Manager verificada**

Acesse: \
👉 <https://business.facebook.com/>

✅ Permissão de **Administrador** no Gerenciador de Negócios\
✅ Acesso administrador no Tiflux

***

### ⚙️ Criação do Aplicativo no Facebook Developers

Acesse:\
👉 <https://developers.facebook.com/>

#### 1️⃣ Criar Aplicativo

* Clique em **Meus Aplicativos**
* Clique em **Criar Aplicativo**

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2Fj0JrgDcSGMQBFfrUNDP9%2Fimage.png?alt=media&#x26;token=9d87700f-fe38-4f28-86e8-25712d98985f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FZC2MKXENU4Q0K1EULf2a%2Fimage.png?alt=media&#x26;token=ecade415-249f-49cd-9b64-a39560d3b1b5" alt=""><figcaption></figcaption></figure>

* Tipo: **Outros**

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FFCvcZERc4OxIYTnt3MoV%2Fimage.png?alt=media&#x26;token=31e9591f-184a-4449-9a78-d7738de952ed" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FbBYldFnMVDbmef2rY8zW%2Fimage.png?alt=media&#x26;token=bba6e478-6326-4890-b6ca-3235dfab566f" alt=""><figcaption></figcaption></figure>

* Depois selecione: **Empresa**

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FmdvRcaOOkPZSmggqYtKS%2Fimage.png?alt=media&#x26;token=657fb8bc-9f49-446c-b28e-aa122d871b37" alt=""><figcaption></figcaption></figure>

Preencha:

* Nome do App (ex: Cliente\_Tiflux)
* E-mail de contato
* Portfólio empresarial

Clique em **Criar Aplicativo**

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FKkyR5m1ffwj9eSMSrxtD%2Fimage.png?alt=media&#x26;token=f9e49614-80b5-4ab2-b3a5-c7867c759275" alt=""><figcaption></figcaption></figure>

***

#### 2️⃣ Adicionar Produto WhatsApp

Dentro do app:

* Vá em **WhatsApp**
* Clique em **Configurar**

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FVkyujHmdRtJKb2Vnlmy4%2Fimage.png?alt=media&#x26;token=07efc7ba-cf9d-40ec-9ccd-eb6d91e4bd95" alt=""><figcaption></figcaption></figure>

* Acesse **Configuração da API**

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FijeYDGtyfamprXVVSMc4%2Fimage.png?alt=media&#x26;token=fa38e1cf-20f3-499d-97ed-1d560d1c93e6" alt=""><figcaption></figcaption></figure>

***

#### 3️⃣ Adicionar Número

Na etapa **Adicionar Número de Telefone**:

* Informe o número (com DDI, sem formatação)
* Nome de exibição (seguindo as diretrizes da Meta)
* Categoria
* Descrição da empresa

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2F6IyeORfdFr8Q8zOBmwR7%2Fimage.png?alt=media&#x26;token=70cf5c3a-b167-45b8-9cf5-df4d6c3de771" alt=""><figcaption></figcaption></figure>

Receba o código via **SMS ou ligação**\
Confirme o código.

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FZ5gGeezwYAYf66OrnuLv%2Fimage.png?alt=media&#x26;token=28710693-f777-4188-816b-251002b6b2eb" alt=""><figcaption></figcaption></figure>

***

### 🔐 Geração do Token Permanente

Em:\
👉 <https://business.facebook.com/>

#### 1️⃣ Criar Usuário do Sistema

* Vá em **Usuários do Sistema**
* Clique em **Adicionar**

Atribua o perfil **Admin**

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FFZLK5jIlzl4Kfag8085I%2Fimage.png?alt=media&#x26;token=a0b8d0ea-f63e-4f85-b3b3-30214993c8e3" alt=""><figcaption></figcaption></figure>

***

#### 2️⃣ Adicionar Ativos

* Selecione o Gerenciador de Negócios
* Nos "3 pontinhos" Atribua Ativos
* Selecione a conta do WhatsApp e Aplicativo
* Dê **Controle Total**

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FPIxijRwIN7YtA2hAEhL9%2Fimage.png?alt=media&#x26;token=f70c1edf-2053-4208-a30e-ffd089748dd0" alt=""><figcaption></figcaption></figure>

***

#### 3️⃣ Gerar Token

* Clique em **Gerar novo token**

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FuwxhGvubzvFTghLD2huB%2Fimage.png?alt=media&#x26;token=495dcf05-2264-4658-b7f9-6dcd316a2435" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FlN9UUqd1Kgihvk4I35hi%2Fimage.png?alt=media&#x26;token=07230c48-a88a-4b20-b0b2-ecd58ad6cd62" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FEYVvUwZrrrNIdGVh6Qnc%2Fimage.png?alt=media&#x26;token=d17be322-fcd5-498c-99f0-79b5b0e162fc" alt=""><figcaption></figcaption></figure>

* Selecione o app criado
* Expiração: **Nunca**

Marque as permissões:

* `whatsapp_business_messaging`
* `whatsapp_business_management`

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FVmAzqj0T0jCeNfqWBmmY%2Fimage.png?alt=media&#x26;token=761210dc-e2a4-4d9b-8ef6-1de0e86ada5e" alt=""><figcaption></figcaption></figure>

⚠️ Copie e salve o token. Ele não será exibido novamente.

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FYjLmAr8hGxz78sLvurzf%2Fimage.png?alt=media&#x26;token=aff77edf-507b-43f5-8c62-c8068317fb3f" alt=""><figcaption></figcaption></figure>

***

### 🔗 Configuração no Tiflux

No Tiflux:

```
Configurações > Geral > Integrações > Comunicação > Meta
```

Preencha:

* Nome da Integração
* ID do Telefone
* ID da Conta WhatsApp Business
* Token do App

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FEcLLQKOtwhsw59JuC7r9%2Fimage.png?alt=media&#x26;token=392c7387-9eda-4598-ae06-e40799e50c5a" alt=""><figcaption></figcaption></figure>

Clique em:

✔ Concordo\
✔ Gerar URL de Callback

Copie:

* URL de Callback
* Token de Verificação

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FJqq50WKTHSHacajqwNBQ%2Fimage.png?alt=media&#x26;token=a34d6a85-666f-44e5-816e-e74398966a15" alt=""><figcaption></figcaption></figure>

***

### 📡 Configuração do Webhook na Meta

Volte ao:\
👉 <https://developers.facebook.com/>

Dentro do aplicativo:

* Vá em **WhatsApp > Configuração**
* Encontre **Webhooks**
* Clique em **Editar**

Cole:

* URL de Callback (Tiflux)
* Token de Verificação (Tiflux)

Clique em **Verificar e Salvar**

***

#### Assinar Campos

Clique em **Gerenciar** e marque:

* `messages`
* `message_template_status_update`

Clique em **Assinar**

⚠️ Também verifique na seção **Produtos** se o WhatsApp Business API está corretamente vinculado.

***

### ✅ Ativação do Número no WhatsApp Manager

Acesse:\
👉 <https://business.facebook.com/wa/manage>

1. Clique no número (status Pendente)
2. Vá em Configurações (ícone engrenagem)
3. Selecione **Gerenciador do WhatsApp**
4. Vá em **Configuração da API**
5. Clique em **Gerar Token**
6. Salve

O número deverá mudar para:

🟢 **Conectado**

Após isso, o número já pode receber mensagens no Tiflux.

***

### 💳 Pós-integração

### Forma de Pagamento

No:\
👉 <https://business.facebook.com/>

* Vá em Configuração da API
* Adicionar forma de pagamento

⚠️ Obrigatório para envio de mensagens\
⚠️ Não obrigatório para recebimento

***

### Verificação da Empresa

No Business Manager:

* Configurações da Conta
* Verificação da Empresa

Pode ser necessário enviar documentação.

***

### ⚠️ Avisos Importantes

🔹 O número deve estar desvinculado do celular\
🔹 O token é único e não pode ser recuperado\
🔹 Webhook precisa estar assinado corretamente\
🔹 Sem forma de pagamento → apenas recebimento\
🔹 Envio proativo exige modelo HSM aprovado\
🔹 Cada número exige app e token próprios

***

### ❓ Perguntas Frequentes (FAQ)

**🔹** Preciso de HSM para receber mensagens?\
Não. Apenas para iniciar conversas fora da janela de 24h.

**🔹** O token expira?\
Se configurado como "Nunca", não.

**🔹** Posso usar o número em outro sistema?\
Não. Ele ficará exclusivo na Cloud API.

**🔹** Onde vejo erros?\
Em: developers.facebook.com > Webhooks > Logs

**🔹** Posso integrar vários números?\
Sim. Repita o processo para cada um.

***

### 🔍 Palavras-chave para indexação

```
integração meta tiflux
whatsapp cloud api tiflux
configurar webhook meta
gerar token whatsapp business
ativar numero meta
business facebook whatsapp
facebook developers api
modelo hsm meta
receber whatsapp no tiflux
configuração cloud api
meta business manager verificação
```