Manual de configuração da Meta

ConvertMessage — Instagram: comentário → Direct → resposta → link

Diagnóstico da tela atual
Se o menu esquerdo mostra apenas Login do Facebook para Empresas, o caso de uso do Instagram ainda não foi adicionado. Não configure URI de OAuth nessa área para este teste.

1. Encontrar o caso de uso correto

1 No painel do aplicativo Meta, clique em Casos de uso.

2 Procure uma opção com nome semelhante a:

Gerenciar mensagens e conteúdo no Instagram
Manage messages and content on Instagram

3 Clique em Adicionar, Configurar ou Personalizar.

Se a opção aparecer: continue usando o aplicativo atual.

Se a opção não aparecer: crie outro aplicativo e, durante a criação, selecione esse caso de uso do Instagram. É mais rápido e seguro do que adaptar um app criado somente para Facebook Login.

2. Escolher o tipo de integração

Dentro da configuração do Instagram, escolha:

Instagram API with Instagram Login
Configuração da API com Login do Instagram

O ConvertMessage usa o host graph.instagram.com. Não escolha a alternativa que exige Facebook Page neste primeiro teste.

3. Preparar a conta do Instagram

A conta é profissional: Business ou Creator.
Você consegue entrar nela e autorizar o aplicativo.
A conta foi adicionada como Testadora do Instagram enquanto o app estiver em desenvolvimento.
O convite de testadora foi aceito dentro da própria conta do Instagram.

Erro: “Função de desenvolvedor é insuficiente”

Causa: ser administrador do app com a conta do Facebook não concede automaticamente uma função à conta do Instagram. No modo de desenvolvimento, a conta profissional precisa ser adicionada e aceitar a função de Testadora do Instagram.

No painel Meta, abra Funções do app → Funções.
Clique em Adicionar pessoas.
Escolha a função Testador do Instagram ou Instagram Tester.
Informe o nome de usuário exato da conta profissional do Instagram e envie o convite.
Entre no Instagram pelo navegador com a conta convidada e abra diretamente:

https://www.instagram.com/accounts/manage_access/

Aceite o convite do app Convert Message-IG.
Volte ao painel Meta, atualize a página com Ctrl + F5 e abra novamente a configuração com Login do Instagram.

Importante: em algumas versões do aplicativo móvel do Instagram, a opção Convites de testador não aparece. O endereço direto acima, aberto no navegador com a conta correta conectada, é o caminho mais confiável.

Não use “Usuários de teste”: essa área cria usuários sintéticos da plataforma. Para este caso, use a conta real como Testadora do Instagram.

4. Permissões necessárias

Permissão	Uso
`instagram_business_basic`	Identificar a conta profissional.
`instagram_business_manage_comments`	Receber comentários e responder privadamente ao comentário.
`instagram_business_manage_messages`	Receber a resposta no Direct e enviar o link final.

5. Gerar credenciais

Na página Configuração da API com login do Instagram, localize a faixa:

2. Gerar tokens de acesso

Clique na seta à direita para expandir essa faixa. O botão Adicionar conta, a conta conectada e a opção de gerar token ficam dentro dessa seção recolhida.

A interface muda depois da vinculação: antes de adicionar a conta pode aparecer Adicionar conta; depois da vinculação, esse botão pode ser substituído pela conta conectada e por Gerar token. Isso é normal.

Guarde o token somente no servidor.

Também serão necessários:

Instagram Account ID da conta profissional.
Chave secreta do app do Instagram exibida na configuração com Login do Instagram.
Webhook Verify Token, que é criado por você e já existe no servidor.

6. Configurar o servidor

No arquivo de ambiente do ConvertMessage, preencher:

INSTAGRAM_APP_SECRET=...
INSTAGRAM_ACCOUNT_ID=...
INSTAGRAM_ACCESS_TOKEN=...
META_MODO_SIMULACAO=false

Depois, reinicie somente o processo do ConvertMessage:

pm2 restart convertmessage --update-env

Não use pm2 restart all, pm2 reload all nem pm2 delete all.

7. Configurar o webhook

Na área de Webhooks do Instagram, selecione o produto Instagram e use:

Callback URL:
/webhooks/instagram

Verify Token:
valor de WEBHOOK_VERIFY_TOKEN do servidor

Assine os campos:

comments
messages

8. Assinar a conta profissional

Com o ID e o token da conta, execute no servidor:

curl -X POST   "https://graph.instagram.com/VERSAO/INSTAGRAM_ACCOUNT_ID/subscribed_apps?subscribed_fields=comments,messages"   -H "Authorization: Bearer INSTAGRAM_ACCESS_TOKEN"

Resposta esperada:

{"success":true}

9. Teste real

Mantenha uma campanha ativa com publicação, comentário e resposta em *.
Use outra conta para comentar READY em um Reel.
Confira o Direct e também Solicitações de mensagens.
Responda YES.
Confirme no painel que a conversa terminou como concluida.

10. Checkpoints

O caso de uso do Instagram aparece no app.
A conta profissional recebeu e aceitou a função de Testadora do Instagram.
A conta profissional foi adicionada à configuração da API.
O token lê o ID e o nome de usuário da conta.
A Meta aceita a Callback URL.
/subscribed_apps retorna sucesso.
Comentário real cria evento no painel.
Direct inicial chega.
Resposta no Direct libera o link final.

Quando travar: tire um print da página inteira, incluindo o menu esquerdo e todos os botões da área central. Nunca mostre Access Token, App Secret ou Verify Token.