📘📸

Facebook & Instagram

Meta Graph API

Guia completo para configurar a Graph API da Meta e automatizar publicações, mensagens e análise de dados.

🎯

Visão Geral

Facebook e Instagram são gerenciados pela mesma API: Meta Graph API. Você cria um app no Meta for Developers e obtém acesso a ambas as plataformas.

📘 Facebook
  • → Publicar em páginas
  • → Ler comentários e mensagens
  • → Responder automaticamente
  • → Gerenciar anúncios
  • → Insights e métricas
📸 Instagram
  • → Publicar fotos e vídeos
  • → Reels e Stories (limitado)
  • → Responder comentários e DMs
  • → Insights de conta profissional
  • → Menções e hashtags

⚠️ Requisitos

  • → Facebook: Precisa de uma Página (não perfil pessoal)
  • → Instagram: Precisa de conta Profissional/Business conectada à Página Facebook
1

Criar App no Meta for Developers

1.1 Acessar o Portal

  1. → Acesse developers.facebook.com
  2. → Faça login com sua conta Facebook
  3. → Clique em "My Apps" → "Create App"

1.2 Configurar o App

  1. 1. Tipo: "Business"
  2. 2. Nome: N8N Social Bot
  3. 3. Email de contato do app
  4. 4. Business Account: selecione sua conta business
  5. 5. Clique "Create App"

1.3 Adicionar Produtos

Na página do app, adicione os produtos necessários:

Para Facebook:

Adicione "Facebook Login for Business"

Para Instagram:

Adicione "Instagram Basic Display" ou "Instagram Graph API"

2

Configurar Permissões

⚠️ Sobre Permissões da Meta

A Meta tem um sistema rigoroso de permissões. Algumas precisam de aprovação e verificação de negócio. Comece com as permissões básicas que são aprovadas automaticamente.

Permissões Básicas (Aprovação Automática)

// Facebook - Disponíveis sem aprovação: pages_show_list // Listar páginas pages_read_engagement // Ler engajamento pages_manage_posts // Gerenciar posts (após app review) // Instagram - Disponíveis sem aprovação: instagram_basic // Acesso básico instagram_content_publish // Publicar (após app review) instagram_manage_comments // Comentários (após app review)

Como Solicitar Permissões

  1. 1. No app, vá em "App Review" → "Permissions and Features"
  2. 2. Encontre a permissão desejada
  3. 3. Clique em "Request"
  4. 4. Preencha os detalhes solicitados (como vai usar, screenshots, etc.)
  5. 5. Aguarde aprovação (pode levar dias/semanas)
3

Gerar Access Token

3.1 Usando o Graph API Explorer (Mais Fácil)

  1. 1. Acesse developers.facebook.com/tools/explorer
  2. 2. Selecione seu app no dropdown
  3. 3. Clique em "Generate Access Token"
  4. 4. Selecione as permissões necessárias
  5. 5. Autorize o app

⚠️ Este token é temporário e expira em ~1 hora. Veja o passo 3.3 para token de longa duração.

3.2 Obter Page Access Token

Para postar em páginas, você precisa do token da PÁGINA, não do usuário:

// No Graph API Explorer, faça esta requisição: GET /me/accounts // Resposta: { "data": [ { "access_token": "EAAG...token_da_pagina...", "id": "123456789", "name": "Minha Página" } ] } // Use o access_token da página específica

3.3 Converter para Token de Longa Duração (60 dias)

// Requisição para estender o token: GET /oauth/access_token ?grant_type=fb_exchange_token &client_id={APP_ID} &client_secret={APP_SECRET} &fb_exchange_token={TOKEN_CURTO} // O token resultante dura ~60 dias // Para token PERMANENTE de página: // Use o Page Token obtido com um User Token de longa duração // Page Tokens derivados de User Tokens de longa duração não expiram!
4

Configurar Instagram

📸 Requisitos para Instagram API

  • → Conta Instagram deve ser Profissional (Creator ou Business)
  • → Deve estar conectada a uma Página do Facebook
  • → Você deve ser admin da Página

4.1 Conectar Instagram ao Facebook

  1. 1. No Instagram, vá em Configurações → Conta → Mudar para conta profissional
  2. 2. Conecte à sua Página do Facebook
  3. 3. No Facebook, vá na sua Página → Configurações → Instagram
  4. 4. Confirme a conexão

4.2 Obter Instagram Business Account ID

// No Graph API Explorer: GET /{page-id}?fields=instagram_business_account // Resposta: { "instagram_business_account": { "id": "17841400000000000" // Este é o ID do Instagram }, "id": "123456789" } // Use este ID para operações no Instagram
5

Configurar no N8N

5.1 Credencial Facebook Graph API

  1. 1. No N8N, vá em Credenciais → Adicionar
  2. 2. Pesquise: "Facebook Graph API"
  3. 3. Cole o Page Access Token de longa duração

5.2 Alternativa: HTTP Request

Para mais controle, use HTTP Request diretamente:

// URL Base: https://graph.facebook.com/v18.0/ // Headers: Authorization: Bearer {PAGE_ACCESS_TOKEN} // Ou via query parameter: ?access_token={PAGE_ACCESS_TOKEN}
📋

Exemplos Práticos

📘 Publicar Post no Facebook

// Node: HTTP Request // Method: POST URL: https://graph.facebook.com/v18.0 /{page-id}/feed Body (JSON): { "message": "Novidade chegando! 🚀", "access_token": "{{ $credentials.token }}" } // Para post com imagem: URL: /{page-id}/photos Body: { "url": "https://exemplo.com/img.jpg", "caption": "Legenda da imagem" }

📸 Publicar no Instagram

// Instagram requer 2 etapas: // 1. Criar container de mídia POST /{ig-user-id}/media { "image_url": "https://exemplo.com/img.jpg", "caption": "Legenda #hashtag", "access_token": "..." } // Resposta: { "id": "container_id" } // 2. Publicar o container POST /{ig-user-id}/media_publish { "creation_id": "{{ container_id }}", "access_token": "..." }

💬 Ler Comentários

// Facebook - comentários de um post: GET /{post-id}/comments ?fields=from,message,created_time // Instagram - comentários: GET /{media-id}/comments ?fields=text,username,timestamp

↩️ Responder Comentário

// Facebook: POST /{comment-id}/comments { "message": "Obrigado pelo comentário!" } // Instagram: POST /{comment-id}/replies { "message": "@usuario Obrigado! 🙏" }

🔔 Receber Webhooks

// Configure no Meta App Dashboard: // Webhooks → Page → Subscribe // Eventos disponíveis: - feed (posts, comentários) - messages (Messenger) - mention (menções) - ratings (avaliações) // Payload recebido no N8N: { "entry": [{ "changes": [{ "field": "feed", "value": { ... } }] }] }

📊 Obter Insights

// Facebook Page Insights: GET /{page-id}/insights ?metric=page_impressions, page_engaged_users &period=day // Instagram Insights: GET /{ig-user-id}/insights ?metric=impressions,reach, profile_views &period=day
🔧

Troubleshooting

❌ "(#200) Requires extended permission"

Causa: Falta permissão para a ação.

Solução: Solicite a permissão específica em App Review → Permissions.

❌ "Error validating access token"

Causa: Token expirado ou inválido.

Solução: Gere um novo token. Use tokens de longa duração para produção.

❌ Instagram "Media creation failed"

Causa: URL da imagem não acessível ou formato inválido.

Solução: A URL da imagem deve ser pública (HTTPS) e acessível pelos servidores da Meta. Formatos aceitos: JPEG, PNG.

❌ "App not authorized for this business"

Causa: App não associado à conta business correta.

Solução: Em business.facebook.com, vá em Settings → Business Info → Connected Apps e adicione seu app.

Facebook & Instagram Configurados!

Agora você pode automatizar suas redes sociais com N8N.

Próximo: Slack → Ver Todas as Conexões