Instagram Comentários

Instagram Comentários recebe comentários feitos em posts próprios de uma conta profissional. O SquadOS aplica filtros por post e palavra-chave e, quando o evento passa, entrega o texto a um agente. A resposta normal é um comentário público; opcionalmente, o agente pode decidir usar uma resposta privada por DM.

Antes de conectar

Você precisa de:

uma conta Instagram Business ou Creator;
acesso de login a essa conta;
um agente ativo para processar os comentários;
acesso à opção restrita durante o App Review.

A autorização usa o Login do Instagram, não o login do Facebook. Comentários e Direct são caixas separadas, mesmo que usem a mesma conta profissional e o mesmo agente.

Conectar a caixa

No painel administrativo, abra Caixas de entrada e selecione Conectar caixa de entrada.
No grupo Instagram, escolha Instagram Comentários.
Selecione Conectar com Instagram, entre na conta profissional no popup e autorize as permissões solicitadas.
Quando o cartão mostrar Conectado: @usuário, selecione Continuar.
Em Destino padrão, escolha um agente ativo, confira o nome da caixa e selecione Concluir.

Uma conexão marcada como Conectada confirma o estado salvo, mas não substitui um teste real de entrega. Faça um comentário com outra conta em um post monitorado e confirme a entrada e a resposta antes de usar o canal em um post movimentado.

Abrir e salvar a configuração

Em Caixas de entrada, abra a ação Configurações da linha. No cartão Instagram Comentários, selecione Configurar. O painel Configurar gatilho de comentários reúne os três blocos abaixo. Ao terminar, selecione Salvar configurações.

1. Posts monitorados

Todos os posts da conta aceita comentários de qualquer mídia própria da conta. Posts antigos continuam dentro do filtro e podem aumentar volume, custo e exposição pública.
Posts selecionados limita o canal aos IDs escolhidos. Selecione + Adicionar post, marque as mídias e confirme com Adicionar (N). O seletor carrega 25 itens por página; use Carregar mais para buscar a página seguinte.

O limite salvo é de 100 posts. Selecione somente o necessário: ao confirmar mais itens do que o espaço restante, a interface corta a lista em 100 sem identificar quais excedentes foram descartados.

Posts em colaboração

O seletor lista a mídia própria devolvida pela API da conta conectada. Um post Collab pertence à conta que o publicou, não às contas convidadas como colaboradoras. Se a conta conectada só colaborou, o post não aparece, seu webhook vai para a conta dona e ela não pode respondê-lo pela API.

Conecte a conta que publicou a mídia. Se não houver mídia própria, a interface mostra Esta conta não tem posts próprios.

2. Palavras-chave

Digite um termo e pressione Enter. Cada valor é aparado para 64 caracteres, e a lista aceita no máximo 50 valores.

Em Lógica de correspondência:

Qualquer uma aceita o comentário quando pelo menos um valor combina;
Todas exige que todos combinem;
Nenhuma — bloqueio aceita apenas quando nenhum combina.

Em Tipo de correspondência:

Contém procura o valor como substring;
Exato compara o comentário completo, ignorando espaços nas pontas;
Regex executa cada valor como expressão regular.

Diferenciar maiúsculas/minúsculas vem desligado. Sem valores, o filtro de palavras-chave não restringe os comentários.

3. Avançado

Ignorar replies (só responder comentários top) vem ligado. Assim, respostas a outro comentário são ignoradas e somente comentários de primeiro nível entram.
Permitir Private Reply (DM) disponibiliza a ferramenta instagram_private_reply ao agente. Isso não força toda resposta a virar DM: o modelo escolhe usar a ferramenta quando julga a resposta confidencial, pessoal ou longa. Se a ferramenta termina com sucesso, o SquadOS não publica também um comentário. Se ela não for usada ou falhar, o fluxo normal ainda tenta uma resposta pública.

A interface informa uma janela de sete dias para a resposta privada. O SquadOS não valida essa janela localmente; a API da Meta decide se a tentativa ainda é aceita. A mensagem privada é cortada em 1.000 caracteres.

O que acontece com cada comentário

A Meta envia o webhook para a conta conectada.
O SquadOS localiza a caixa ativa mais recente daquela conta. Se houver caixas duplicadas, somente essa vencedora processa o evento.
O runtime descarta texto vazio, comentários da própria conta, posts fora da seleção, respostas em thread quando a exclusão está ligada e comentários que não passam pelas palavras-chave.
Um comentário de primeiro nível cria uma conversa; respostas dentro da mesma thread reutilizam a conversa do comentário pai.
O texto é entregue ao agente. Se nenhuma resposta privada bem-sucedida ocorreu, a resposta do agente é publicada como comentário, com corte em 2.200 caracteres.

O próprio comentário publicado pela conta conectada é sempre ignorado para evitar loop. Essa proteção não pode ser desligada.

Operação segura

Comece com Posts selecionados e termos específicos.
Teste com outra conta; comentários da conta conectada são ignorados por design.
Revise o prompt para impedir afirmações sensíveis, coleta pública de dados e respostas fora do escopo.
Para dados pessoais, habilite Private Reply e instrua o agente sobre quando chamar a ferramenta, mas não trate a DM como garantida.
Monitore as conversas e o próprio post. A resposta pública fica visível para qualquer pessoa que veja a publicação.

Diagnóstico

Instagram Comentários não aparece na lista: a permissão ainda está restrita à conta de App Review. Use Instagram Direct ou aguarde a liberação.
A conexão terminou, mas nenhum comentário entra: confirme que o destino é um agente ativo, que o teste veio de outra conta e que a mídia passa pelo filtro de posts.
O seletor está vazio: conecte a conta que publicou os posts; mídia em que ela é apenas colaboradora não é listada.
Alguns comentários não entram: confira Ignorar replies, lógica, tipo, diferenciação de caixa e valores do filtro.
Uma regex foi rejeitada: simplifique-a. Se você mudou o tipo para Regex depois de preencher a lista, remova e reinsira todos os valores para forçar a validação.
A DM privada não foi enviada: a ferramenta depende da decisão do agente e da aceitação da Meta; verifique se Permitir Private Reply (DM) está ligado e se o comentário público foi usado como fluxo normal.
As configurações voltaram aos padrões: não salve por cima. Uma falha de leitura é tratada pela interface como configuração ausente e pode permitir sobrescrever o JSON existente; recarregue e tente novamente. Registrado como BUG-TRG-186.
Token expirado ou conexão perdida: use Reconectar no cartão e repita o teste com outra conta.