Conectar o Instagram ao Reach: o passo a passo na Meta

Conectar seu Instagram ao Reach exige um app na Meta. Não é opcional e não tem atalho: a Meta só entrega comentário e mensagem para aplicativos que ela aprovou. Este guia é o caminho inteiro, na ordem, com o que costuma travar em cada passo.

Reserve 40 minutos para a parte que depende de você. A aprovação da Meta leva de 2 a 6 semanas — e ela é o único passo que ninguém consegue acelerar.

Antes de começar

Três coisas precisam estar prontas, e a falta de qualquer uma trava tudo no meio:

• Conta profissional no Instagram. Comercial ou Criador de conteúdo. Conta pessoal não serve, e trocar leva 2 minutos em Configurações → Tipo de conta.
• Conta PÚBLICA. A Meta só manda aviso de comentário e menção quando o perfil é público. Perfil fechado recebe mensagem, mas não recebe comentário — que é justamente o gatilho mais usado.
• Uma Página do Facebook vinculada. Mesmo que você não use o Facebook, a verificação do negócio acontece por lá.

Passo 1 · Criar o app

Vá em developers.facebook.com/apps e clique em Criar app.

Quando a Meta perguntar o que você quer fazer, escolha o caso de uso "Gerenciar mensagens e conteúdo no Instagram". Esse detalhe importa: ele já traz as permissões certas configuradas. Se você escolher "Outro" e tentar montar na mão, vai faltar coisa e você só descobre semanas depois, na revisão.

O tipo do app é Empresa (Business).

Passo 2 · Pegar o App ID e o App Secret

Dentro do app, vá em Configurações do app → Básico.

O ID do aplicativo fica visível. O Chave secreta do aplicativo aparece depois de clicar em "Mostrar" e digitar sua senha do Facebook.

Copie os dois e cole na Cool, em Super admin → Configurações → Integrações. O botão "Conectar Instagram" na tela de Canais só acende depois disso.

A chave secreta é uma senha. Ela dá acesso a tudo que o app pode fazer — não mande por WhatsApp, não cole em documento compartilhado, não deixe em print.

Passo 3 · Configurar o login

Ainda no painel da Meta, procure o produto Instagram no menu lateral e entre em Configuração da API.

Em Login empresarial para Instagram, adicione a URL de redirecionamento:

https://coolbases.com/api/reach/meta/callback

Tem que ser exatamente isso, com https e sem barra no final. A Meta compara caractere por caractere: uma barra sobrando faz o login falhar com uma mensagem que não explica nada.

As permissões que o Reach usa são estas três:

• instagram_business_basic — ler o perfil e os posts
• instagram_business_manage_comments — ler e responder comentário
• instagram_business_manage_messages — mandar e receber direct

Passo 4 · Configurar o webhook

Webhook é como a Meta avisa a Cool que alguém comentou. Sem ele, a automação nunca dispara — ela fica ligada e em silêncio, que é o pior tipo de defeito porque parece que está funcionando.

Na mesma tela, em Webhooks, preencha:

• URL de retorno de chamada: https://coolbases.com/api/webhooks/meta
• Token de verificação: qualquer frase secreta que você inventar

Essa frase precisa ser idêntica à que você colar na Cool, em Super admin → Configurações → Integrações, no campo do token de verificação. Ela é a prova de que o webhook é seu: a Meta manda a frase de volta, a Cool compara, e só aceita se bater.

Clique em Verificar e salvar. Se der erro aqui, é quase sempre uma destas duas coisas: a frase está diferente nos dois lados, ou as credenciais do passo 2 ainda não foram salvas na Cool.

Depois de verificar, assine os campos:

Passo 5 · Enviar para revisão

Aqui começa a espera. A Meta só entrega mensagem para pessoas fora da equipe do app depois de aprovar o Acesso avançado de cada permissão.

O que ela pede:

1. Verificação do negócio — CNPJ ou documento, no Gerenciador de Negócios. É a parte mais demorada e é bom começar por ela.
2. Política de privacidade pública, com URL acessível.
3. Vídeo de tela mostrando o fluxo funcionando de ponta a ponta: alguém comenta, o app responde, a pessoa recebe o direct. Grave usando sua própria conta de teste.
4. Descrição de uso de cada permissão, explicando por que seu app precisa dela.

Enquanto a revisão não sai, o app funciona só para as contas que estiverem listadas como testadoras no app. Isso é o suficiente para você testar tudo com calma antes de abrir para os clientes.

Passo 6 · Colocar o app no ar

Depois da aprovação, mude o app de Desenvolvimento para Ativo, no topo do painel da Meta.

Este passo é esquecido com frequência. Com o app em Desenvolvimento, a Meta simplesmente não envia webhook — e a automação fica pausada sem erro nenhum aparecer.

Passo 7 · Conectar sua conta na Cool

Volte para a Cool, em Reach → Canais, e clique em Conectar Instagram. A Meta vai pedir sua autorização e devolver você para cá com a conta ligada.

Daí em diante, o painel "O que falta pro Reach funcionar" mostra os passos que sobraram — e some quando não sobrar nenhum.

Quando alguma coisa não funciona

A automação está ligada e não dispara. Confira, nesta ordem: o app está Ativo (passo 6)? O campo comments está assinado (passo 4)? O perfil do Instagram está público? O comentário veio de alguém que não é você — a Meta não dispara webhook para comentário do próprio dono do perfil.

O login falha logo depois de autorizar. A URL de redirecionamento do passo 3 está diferente. Compare caractere por caractere, prestando atenção na barra final.

O direct não chega. A Meta só deixa mandar mensagem dentro de 24 horas depois da última mensagem da pessoa. Fora dessa janela, só a primeira resposta ao comentário passa — e essa vale por até 7 dias. É regra da Meta, não limite da Cool.

O comentário some depois de responder. O Instagram esconde automaticamente comentários que ele julga spam. Se a sua automação responde muito rápido e sempre igual, a chance aumenta — por isso o Reach deixa você escrever várias variações da mesma resposta, e sorteia entre elas.

O que a Cool faz e o que a Meta faz

Vale ter isso claro, porque muda quem você procura quando algo falha:

• A Meta decide se a mensagem sai, para quem, e dentro de qual janela. As regras de 24h e 7 dias são dela.
• A Cool decide o que dizer, quando, para quem, e guarda tudo no seu CRM.

Quando uma mensagem não sai, na esmagadora maioria das vezes é uma regra da Meta sendo respeitada — e o Reach mostra o motivo em vez de falhar em silêncio.