Conclusão da Integração Whatsapp Oficial (Waba) — Embedded Signup Funcional

Já existe backend e frontend implementados e integrados com a API Oficial do WhatsApp Business (WABA).

Atualmente, o fluxo de Embedded Signup entra em loop:
o usuário autentica na Meta, retorna para a plataforma e não consegue criar ou selecionar WABA/número.

📌 Procuramos desenvolvedor cadastrado como developer na Meta, com experiência comprovada em WhatsApp Cloud API + Embedded Signup, e vivência real em App Review da Meta.

O problema está relacionado a configuração incompleta do App na Meta, permissões, callbacks e fluxo OAuth.

Este projeto não é para começar do zero, e sim para corrigir, destravar e entregar a integração funcionando em produção, de ponta a ponta.

🎯 Objetivo

Entregar a integração completa com WhatsApp Oficial funcionando, validada com mensagens reais, pronta para uso por clientes finais.

📦 Escopo Obrigatório
1. App da Meta (Responsabilidade do Dev)

Revisar, corrigir e validar:

Tipo do App

Produto WhatsApp

Embedded Signup

Redirect URIs

Webhooks

Permissões necessárias ao funcionamento do Embedded Signup
(incluindo business_management, caso exigido pelo fluxo)

Garantir funcionamento para usuários:

Sem Business Manager

Sem WABA prévio

Pequenos empresários que usam apenas WhatsApp Business no celular

⚠️ Esta etapa não pode ser delegada ao cliente.
O desenvolvedor é responsável por conduzir corretamente o processo técnico e de aprovação na Meta.

2. Embedded Signup (Obrigatório)

Fluxo esperado e validado:

Usuário clica em “Conectar WhatsApp Oficial”

Login na Meta

Criação ou seleção de Business, WABA e número

Retorno à plataforma com:

Business id

waba id

phone number id

status da conexão

🚫 sem loop
🚫 sem travar em “processando conexão”

3. Backend

Node.js 18+, NestJS

MySQL, Redis, BullMQ

OAuth funcional

Tokens criptografados

Webhook validado (x-hub-signature-256)

Envio e recebimento de mensagens reais via API Oficial

4. Frontend

Ajustar estados do fluxo de conexão

Guiar usuário leigo com mensagens claras

Exibir status, número conectado e erros compreensíveis

Totalmente integrado ao backend final e funcional

✅ Critérios de Aceitação

✔ Embedded Signup funcionando ponta a ponta
✔ WABA criado ou selecionado dentro da plataforma
✔ Permissões aprovadas e ativas
✔ Mensagens reais enviadas e recebidas
✔ Projeto utilizável em produção, sem gambiarras

➕ Continuidade do Projeto

Haverá extensão para evolução da ferramenta, incluindo os módulos:

- IA

- Catálogo

- Pagamentos no próprio Whatsapp

Outros projetos sempre utilizando WhatsApp Oficial