Dica
Assinante Connect.ai: você já tem acesso ao App compartilhado da Connect.ai e pode conectar canais WABA, Instagram e Facebook sem precisar criar o seu próprio app. Este tutorial é para quem deseja ter um App Próprio — seja para isolar a reputação dos canais ou para operar como Tech Provider independente.
Se quiser saber mais sobre a diferença, leia Score do App Tech Provider.
Tudo certo
Material de apoio pronto: descrições de permissões, screencasts e modelos de formulário para o Connect.ai estão disponíveis na central de ajuda. Copie, cole e adapte para acelerar o processo.
Pré-requisitos
Antes de começar, garanta que você tem:
- Uma conta de Facebook pessoal (será usada para acessar o Facebook Developers)
- Um Gerenciador de Negócios (BM) da Meta criado e com CNPJ verificado
- O CNPJ da sua empresa em mãos para a verificação de empresa
- URLs de política de privacidade e termos de uso do seu sistema (pode usar as do Connect.ai como referência:
connectai.aihuby.com.br)
Etapa 1 — Verificações obrigatórias
Duas verificações são necessárias antes de ativar recursos avançados como cadastro incorporado e coexistência. Você pode criar o app primeiro e fazê-las depois, mas recomendamos concluí-las antes de avançar.
Verificação de empresa (CNPJ)
Acesse o seu Gerenciador de Negócios (business.facebook.com) → Configurações do Negócio → Informações do Negócio → inicie a verificação inserindo o CNPJ da empresa.
Verificação de atividade (Tech Provider)
Feita dentro do próprio aplicativo após criá-lo. Você descreve sua atividade — que fornece um sistema de atendimentoomnichannel — e aguarda a aprovação da Meta.
Atenção
Sem essas duas verificações, funcionalidades como cadastro incorporado (embedded signup) e coexistência não ficam disponíveis. O painel do app mostrará os três selos: Verificação de empresa, Verificação de acesso e Análise do app.
Etapa 2 — Criar o aplicativo
- Acesse developers.facebook.com com sua conta de Facebook.
- Crie ou acesse sua conta de desenvolvedor.
- Navegue até Meus Apps → Criar App.
- Selecione os casos de uso:
- Interação de Messenger
- Interação de Instagram
- Interação de WhatsApp
- Gerenciamento de conteúdo (gerenciar tudo na sua página)
- Dê um nome ao app, informe o e-mail de contato do responsável.
- Selecione a Business Manager associada (com verificação de empresa concluída).
- Conclua a autenticação (o Authenticator pode ser solicitado) e aguarde a criação.
Etapa 3 — Configurações básicas
Acesse Configurações → Básico no painel lateral esquerdo do app.
| Campo | O que preencher |
|---|---|
| Domínios do aplicativo | O domínio onde seu sistema está instalado. Para o Connect.ai: aihuby.com.br |
| Política de Privacidade | URL da sua política de privacidade |
| Termos de Serviço | URL dos seus termos de uso |
| Categoria | Mensagens |
| Ícone do app | Imagem 512×512 px — aparece no onboarding para o usuário final |
| Plataforma | Adicione Website com a URL de login do seu sistema |
Instruções de acesso para o analista da Meta
No campo de instruções de acesso, informe como o time da Meta pode testar o seu sistema:
- URL de acesso (tela de login)
- E-mail e senha de um usuário de teste criado exclusivamente para eles
- Deixe claro que não há pagamento exigido para acessar
- Informe se há restrição de geolocalização (na maioria dos casos: não há)
Dica
Para o Connect.ai: crie um conta de teste exclusivo para o analista da Meta e forneça um login dedicado. Nunca use credenciais de clientes reais.
Salve as configurações básicas antes de avançar.
Etapa 4 — Login incorporado do Facebook
O Login Incorporado (Embedded Login) é o popup que permite ao usuário final conectar suas contas da Meta ao seu sistema.
No painel lateral, acesse Login incorporado do Facebook → Configurações.
-
Habilite Login no navegador incorporado e Logout no navegador incorporado.
-
Em Subdomínios OAuth válidos, insira o domínio onde o seu app roda.
- Para o Connect.ai:
aihuby.com.br
- Para o Connect.ai:
-
Em URIs de redirecionamento do OAuth válidos, insira os endpoints de retorno após o onboarding:
https://oauth.aihuby.com.br/waba-signuphttps://oauth.aihuby.com.br/instagram-signuphttps://oauth.aihuby.com.br/facebook-signup
Se você configurou um domínio OAuth customizado, substitua
oauth.aihuby.com.brpelo seu subdomínio. -
Salve as alterações.
Etapa 5 — Caso de uso: WhatsApp (WABA)
No painel lateral, acesse WhatsApp → Personalizar.
Permissões
Na aba Permissões e recursos, as permissões básicas (whatsapp_business_messaging, whatsapp_business_management, public_profile) já vêm pré-selecionadas. Adicione as permissões adicionais conforme o uso do seu sistema.
Dica
Para o Connect.ai: a lista completa de permissões necessárias está na página de apoio.
Webhook (recebimento de mensagens)
Na aba Configuração:
- No campo URL de callback, insira a rota de webhook do Connect.ai.
- Para configurar por conta: acesse Connect.ai → Configuração → Integrações Meta e copie a rota de webhook do conta.
- No campo Token de verificação, insira o token configurado no Connect.ai para aquele webhook.
- Clique em Verificar e salvar.
- Na seção de campos do webhook, marque os eventos que deseja receber (
messages,message_deliveries,message_reads, etc.). Se não souber quais, marque todos.
Cadastro incorporado (Embedded Signup)
O cadastro incorporado é o onboarding que permite conectar números WABA pelo painel do Connect.ai sem que o cliente precise sair do sistema.
Atenção
O botão Começar a usar o cadastro incorporado só fica disponível após as três verificações estarem completas: empresa (CNPJ), acesso (atividade) e análise do app.
Para configurar:
- Clique em Criar configuração → dê um nome (ex:
waba) → salve. - Em Gerenciar lista de permissões de domínio, adicione o mesmo redirect URI configurado no Login Incorporado.
Etapa 6 — Caso de uso: Instagram
No painel lateral, acesse Instagram → Personalizar.
Permissões
Adicione as permissões que o seu sistema utilizará (instagram_basic, instagram_business_basic, pages_show_list, etc.).
Webhook
- Acesse a aba Configuração de API.
- Cole a URL de callback e o token de verificação gerados no Connect.ai.
- Clique em Verificar.
- Marque os campos/eventos que deseja receber.
Redirect URI
Na seção de redirecionamento, adicione:
https://oauth.aihuby.com.br/instagram-signup(ou seu domínio customizado)
Etapa 7 — Caso de uso: Messenger
No painel lateral, acesse Messenger → Personalizar.
Permissões
Adicione as permissões necessárias para gerenciar conversas e páginas.
Webhook
Mesmo processo do Instagram: configure via Provedor Global ou por conta no Connect.ai, cole URL de callback e token, verifique e marque os eventos desejados (messages, message_reads, messaging_referrals, etc.).
Dica
O redirect do Messenger já está coberto pelo Login Incorporado do Facebook configurado na Etapa 4 — não é necessário configurar um redirect separado.
Etapa 8 — Caso de uso: Gerenciamento de página
No painel lateral, acesse Gerenciamento de conteúdo → Personalizar.
Neste caso de uso, a configuração é apenas de permissões — não há webhook próprio. Adicione as permissões que o seu sistema utilizará para gerenciar posts, comentários, engajamento e metadados de páginas.
Etapa 9 — Gerar token permanente de sistema
O token permanente é necessário para autenticar as chamadas de API do Connect.ai com a Meta.
- Acesse seu Gerenciador de Negócios (
business.facebook.com). - Vá em Configurações do Negócio → Usuários → Usuários do Sistema.
- Crie um Usuário do Sistema do tipo Admin (ex:
token). - Atribua o aplicativo criado a esse usuário (aba Apps → Atribuir apps → selecione o seu app e marque Gerenciar app).
- Clique em Gerar novo token → selecione o app → marque todas as permissões necessárias → gere e copie o token.
Etapa 10 — Publicar o app
Antes de submeter para análise, o app precisa ser publicado (modo produção).
No painel do app, acesse Publicação do app e habilite o modo de produção. O botão só fica disponível após as configurações básicas (domínio, política de privacidade, termos e plataforma) estarem preenchidas.
Etapa 11 — Análise do app (aprovação da Meta)
Esta é a etapa final e mais delicada. A Meta revisa todas as permissões solicitadas.
No painel lateral, acesse Análise do app.
Passo a passo da análise
- Clique em Iniciar análise.
- Para cada permissão listada, clique em Começar e preencha:
- Descrição de uso: explique como e por que sua plataforma utiliza aquela permissão.
- Screencast: grave um vídeo mostrando a funcionalidade em uso no seu sistema.
- Chamadas de API (quando exigido): algumas permissões requerem chamadas de teste reais. Use o explorador de API da Meta ou uma IA para gerar as chamadas via cURL.
- Preencha a seção Tratamento de dados:
- Você tem operadores com acesso a dados? (geralmente: Não)
- Quem é o responsável pelos dados? (nome, CPF, país)
- Você compartilhou dados por exigência de segurança nacional? (geralmente: Não)
- Preencha a seção Instruções para o analista (mesmas informações da Etapa 3 — login de teste, URL, sem pagamento).
- Quando todas as seções estiverem verdes, clique em Enviar para análise.
Dica
O prazo médio de análise é de 10 dias úteis. A Meta pode aprovar, reprovar ou solicitar ajustes. Se solicitar ajustes, corrija o que foi apontado e reenvie.
Para o Connect.ai: as descrições e screencasts prontos estão na página de apoio. Use-os como base — a Meta pode pedir que você grave na sua própria plataforma.
Resumo das etapas
| # | Etapa | Observação |
|---|---|---|
| 1 | Verificações de empresa e atividade | Obrigatório para cadastro incorporado e coexistência |
| 2 | Criar o app no Facebook Developers | Escolha os 4 casos de uso |
| 3 | Configurações básicas | Domínio, políticas, ícone, instruções de acesso |
| 4 | Login incorporado | Subdomínio + URIs de redirecionamento |
| 5 | WhatsApp (WABA) | Permissões + webhook + cadastro incorporado |
| 6 | Permissões + webhook + redirect URI | |
| 7 | Messenger | Permissões + webhook |
| 8 | Gerenciamento de página | Só permissões |
| 9 | Token permanente | Gerado no Gerenciador de Negócios |
| 10 | Publicar o app | Habilitar modo produção |
| 11 | Análise do app | Descrições + screencasts + envio para revisão |