Ctrlk
Page cover

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:

📚 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:

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

AnteriorWhatsApp Cloud APIPróximoGuia de Boas Práticas: Modelos de Mensagem HSM (WhatsApp API)

Atualizado