📱 n8n Instagram Automation Pro

Nó community para n8n - Automação completa do Instagram com API oficial da Meta.

✨ Features

• ✅ Webhook Inteligente - Recebe mensagens, comentários e menções automaticamente
• ✅ Enviar Mensagens DM - Texto, imagem, vídeo, áudio, posts
• ✅ Responder Comentários - Automaticamente
• ✅ Publicar Conteúdo - Posts, Stories, Reels
• ✅ Detalhes Automáticos - Link e título da postagem, username
• ✅ 6 Saídas no Webhook - Mensagens, comentários, menções, reações...

🚀 Instalação Rápida

No n8n:

1. Settings → Community Nodes → Install
2. Digite: n8n-nodes-instagram-automation-pro
3. Reinicie o n8n

Ou via npm:

npm install n8n-nodes-instagram-automation-pro

📋 Pré-requisitos

1. App no Meta for Developers (criar aqui)
2. Access Token do Instagram
3. Instagram User ID (sua página/perfil business)
4. Webhook configurado

Permissões necessárias:

• instagram_basic
• instagram_manage_messages
• instagram_manage_comments
• instagram_content_publish (para publicar)

🎯 Uso Básico

Exemplo: Auto-Resposta a Comentários

Instagram Webhook → Instagram Automation (Reply Comment)

Configuração:

• Comment ID: {{ $json.replyToCommentId }}
• Resposta: Obrigado @{{ $json.fromUsername }}! ❤️

Resultado: Responde automaticamente todos os comentários!

Exemplo: Resposta com Detalhes da Postagem

// O webhook já traz:
{
  fromUsername: "joaosilva",
  text: "Adorei!",
  mediaUrl: "https://...",          // Link da foto
  mediaPermalink: "https://...",    // Link público
  mediaCaption: "Minha foto...",    // Título
  mediaLikeCount: 247               // Curtidas
}

// Use na resposta:
"Obrigado @{{ $json.fromUsername }}!
Esta postagem já tem {{ $json.mediaLikeCount }} curtidas! 🎉"

📊 O que o Webhook Traz Automaticamente

Mensagens DM:

• ✅ Username
• ✅ Texto da mensagem
• ✅ User ID
• ✅ Anexos

Comentários:

• ✅ Username
• ✅ Texto do comentário
• ✅ Link da foto comentada
• ✅ Título da postagem
• ✅ Curtidas e comentários
• ✅ Tipo de mídia (IMAGE/VIDEO)

Sem precisar de nós extras! Tudo vem direto no webhook.

⚠️ Limitações

❌ Não é possível obter:

• Foto de perfil do usuário - API do Instagram não fornece
• Nome completo - Requer permissão especial (retorna null)
• Bio/descrição - Limitação de privacidade da API

✅ Sempre disponível:

• Username (@joaosilva)
• User ID
• Texto
• Foto da postagem (não do usuário)
• Legenda da postagem

Use username - sempre funciona! 😊

🎨 Nós Disponíveis

| Nó | Descrição | |----|-----------| | Instagram Webhook | Recebe eventos (mensagens, comentários, menções) | | Instagram Automation | Envia mensagens, responde comentários, lista conversas | | Instagram Publish | Publica posts, stories, reels | | Instagram Test | Testa credenciais e conexão |

📚 Documentação Completa

Veja o GUIA-COMPLETO.md para:

• Configuração detalhada
• Exemplos avançados
• Troubleshooting
• Todas as limitações da API

🔧 Quick Start

1. Configurar Credenciais

No n8n:

• Access Token: (do Meta for Developers)
• Instagram User ID: (ID da sua página)
• Webhook Verify Token: (qualquer string segura)

2. Ativar Webhook

• Adicione nó Instagram Webhook
• Copie a URL
• Configure no Meta for Developers
• Inscreva nos eventos: messages, comments

3. Criar Workflow

Instagram Webhook → Instagram Automation

Pronto! Comece a automatizar! 🚀

📖 Exemplos

Responder "Olá" automaticamente

Webhook → IF (text = "olá") → Reply "Olá! Como posso ajudar?"

Enviar DM após comentário

Webhook → Send Message "Obrigado pelo comentário! 😊"

Resposta por palavra-chave

Webhook → Match Keyword ("preço") → Reply "Confira: www.exemplo.com"

🐛 Troubleshooting

Webhook não recebe eventos?

1. Verifique URL no Meta
2. Verify Token correto
3. Eventos inscritos
4. Workflow ativado

Erro "User consent required"?

• Normal! Limitação da API do Instagram
• Use fromUsername (sempre funciona)
• fromName pode retornar null

Resposta não é enviada?

1. Comment ID correto
2. Não é reply de reply
3. Token válido
4. Permissões ativas

📞 Suporte

• 📧 Email: [email protected]
• 🌐 Web: developer.thiper.com
• 📦 NPM: n8n-nodes-instagram-automation-pro
• 🐛 Issues: GitHub Issues

📜 Changelog

[1.7.3] - 2024-11-09

• ✅ Webhook busca informações automaticamente
• ✅ Detalhes da mídia (link, título, curtidas)
• ✅ Tratamento gracioso de erros de permissão
• ✅ Username sempre disponível
• ✅ Logs informativos

Veja CHANGELOG.md para histórico completo.

📄 Licença

MIT © Thiago D'Arezzo

🎯 Resumo

Webhook já traz:

• ✅ Username
• ✅ Texto
• ✅ Link da foto
• ✅ Título da postagem

Não traz (limitação da API):

• ❌ Foto de perfil do usuário
• ⚠️ Nome completo (às vezes)

Solução: Use username - sempre funciona! 😊

🎩 Desenvolvido por Thiago D'Arezzo
📅 09/11/2024 - v1.7.3

⭐ Se gostou, deixe uma estrela no GitHub!