For the complete documentation index, see llms.txt. This page is also available as Markdown.

Instagram

Visão Geral

O Componente de Integração e Recursos do Instagram é um nó de ação modular e multifuncional baseado no grafo de dados da API da Meta. Sua função principal é estender os recursos do chatbot para além das mensagens privadas, permitindo interagir diretamente com a linha do tempo, analisar métricas e realizar automações baseadas no comportamento social do usuário. Com ele, o fluxo consegue validar o status de relacionamento do contato (como verificar se ele segue a página) e interagir com mídias públicas e menções à marca.

Parâmetros de Configuração

A parametrização do componente é dinâmica e se adapta de acordo com o nível de ação escolhido pelo administrador do fluxo:

  • Credencial: Menu suspenso para selecionar o token de acesso ou conta institucional autenticada do Instagram Business que executará o comando na API.

  • Recurso: Define a categoria macro de dados que sofrerá a intervenção do componente. As opções listadas na interface em image_348b2b.png incluem:

    • Seguidores: Validações de vínculo e auditoria de base de usuários.

    • Publicações: Criação, monitoramento ou leitura de posts tradicionais do feed.

    • Comentários: Moderação ou respostas automáticas em posts públicos.

    • Reels: Publicação ou leitura de dados de vídeos do formato Reels.

    • Stories: Postagem e monitoramento de mídias temporárias.

    • Insights: Coleta de métricas e relatórios de performance de engajamento.

    • Menções: Rastreamento de postagens de terceiros que citam o @ da marca.

  • Operação: Campo contextualizado que exibe ações específicas dependendo do recurso selecionado. Conforme exemplificado na image_3477eb.png (quando o recurso está definido como Menções), as operações abrangem:

    • Obter postagens em que você foi mencionado

    • Obter dados de um comentário em que você foi mencionado

    • Obter dados de um post em que você foi mencionado

    • Comentar em um post em que você foi mencionado

    • Responder um comentário em que você foi mencionado

Construtor Visual

A interface gráfica deste componente opera sob um modelo de formulário em cascata altamente responsivo:

  • Layout Cascata Inteligente: Os campos de configuração aparecem de forma condicional. Selecionar o item Recurso destrava instantaneamente o menu Operação. Se o usuário escolher uma operação de postagem (como "Criar um Reel"), o formulário expande para exibir os campos obrigatórios de upload de arquivo e digitação de legenda (caption).

  • Mapeamento de Retornos Condicionais: Caso a operação selecionada seja de consulta (como obter dados de um post), o nó adiciona metadados de saída ao editor de fluxos, permitindo que os blocos subsequentes consumam os textos ou IDs retornados pela Graph API.

Operadores Especiais

As propriedades lógicas deste componente lidam com auditorias transacionais e gatilhos de engajamento público:

  • Validador de Status de Engajamento (Follower Check): Quando configurado no recurso Seguidores, o motor realiza uma chamada síncrona para checar se o ID do usuário que iniciou o chat pertence à lista de followers da marca. O componente gera duas saídas booleanas, permitindo, por exemplo, liberar cupons de desconto apenas para quem já segue o perfil de forma ativa.

  • Interpolação de Strings em Comentários e Legendas: Nos blocos focados em responder ou criar conteúdo, os campos aceitam o uso de chaves duplas {{...}} para que o bot publique textos dinâmicos de forma automatizada no feed (ex: "Obrigado pelo carinho, {{nome}}!").

Exemplos Práticos

A tabela abaixo demonstra cenários clássicos de como utilizar este componente modular em estratégias de marketing e atendimento automatizado:

Recurso Selecionado

Operação Escolhida

Variável / Payload Destino

Caso de Uso Prático

Seguidores

Verificar se usuário é seguidor

Saída condicional binária

O cliente solicita um brinde no chat. O bot valida se ele segue a página; se sim, entrega o link, se não, pede para ele seguir primeiro.

Menções

Responder um comentário em que você foi mencionado

Texto fixo com tags dinâmicas

Um influenciador menciona a marca em um comentário de um post. O bot detecta o webhook e envia uma resposta pública automática de agradecimento.

Reels

Criar uma publicação de Reel

{{video_url}} + legenda

Ao finalizar o processamento de um vídeo promocional em um sistema externo, o fluxo do robô faz a publicação automática no feed do Instagram.

Insights

Obter métricas de engajamento

Variável dados_metricas

Um fluxo programado por tempo (Cron) roda o componente toda madrugada para extrair as métricas de alcance e enviar um relatório resumido para o grupo interno.

Atualizado

Isto foi útil?