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

• Tipo: Outros

• Depois selecione: Empresa

Preencha:

• Nome do App (ex: Cliente_Tiflux)

• E-mail de contato

• Portfólio empresarial

Clique em Criar Aplicativo

---

2️⃣ Adicionar Produto WhatsApp

Dentro do app:

• Vá em WhatsApp

• Clique em Configurar

• Acesse Configuração da API

---

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

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

---

🔐 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

---

2️⃣ Adicionar Ativos

• Selecione o Gerenciador de Negócios

• Nos "3 pontinhos" Atribua Ativos

• Selecione a conta do WhatsApp e Aplicativo

• Dê Controle Total

---

3️⃣ Gerar Token

• Clique em Gerar novo token

• Selecione o app criado

• Expiração: Nunca

Marque as permissões:

• whatsapp_business_messaging

• whatsapp_business_management

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

---

🔗 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

Clique em:

✔ Concordo ✔ Gerar URL de Callback

Copie:

• URL de Callback

• Token de Verificação

---

📡 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