Integração com n8n

n8n é uma plataforma open-source de automação visual. O Fala Cheese não tem node oficial ainda — você usa o HTTP Request node padrão do n8n pra chamar nossa API REST.

Setup inicial

1. Criar credencial reutilizável

Em n8n, Credentials → New → Header Auth:

• Name: Fala Cheese API
• Header Name: Authorization
• Header Value: Bearer fc_live_<tua_chave>

Salva. Daqui em diante, qualquer HTTP Request node referencia essa credencial.

2. Configurar HTTP Request node

• Method: POST
• URL: https://app.falacheese.com.br/api/v1/posts
• Authentication: Predefined Credential Type → Header Auth → escolhe a credencial criada
• Body Content Type: JSON
• Specify Body: Using JSON

Body JSON exemplo:

{
  "body": "{{$json[\"text\"]}}",
  "socialAccountIds": ["acc_xyz"],
  "publishNow": true
}

Workflow 1: RSS → LinkedIn

Cenário: você quer postar automaticamente quando um RSS do seu blog atualiza.

Nodes:

1. RSS Feed Read — URL do seu feed (ex. https://meublog.com/rss.xml)
2. Schedule Trigger — roda a cada 1h
3. IF — só prossegue se item é novo (compara com banco do n8n)
4. HTTP Request (Fala Cheese) — POST /api/v1/posts com:

   {
     "body": "Novo no blog: {{$json[\"title\"]}}\n\n{{$json[\"link\"]}}",
     "socialAccountIds": ["acc_linkedin"],
     "publishNow": true
   }
   

Workflow 2: Notion → IG + LinkedIn

Cenário: você tem uma base no Notion onde registra ideias. Marca uma propriedade "Publicar?" como ✓ e o n8n cria draft no Fala Cheese pra revisar.

Nodes:

1. Notion Trigger — quando "Publicar" muda pra ✓
2. HTTP Request (Fala Cheese) — POST /api/v1/posts com publishNow: false (vira draft)
3. Notion Update — marca propriedade "Status" como "Draft enviado"

Você revisa em /app/drafts e publica manualmente quando achar bom.

Workflow 3: Webhook → Fala Cheese

Cenário: outra ferramenta dispara webhook (Zapier alternative, form de site, etc.) e você quer que vire post automaticamente.

Nodes:

1. Webhook trigger — n8n gera URL https://n8n.seu.dominio/webhook/...
2. HTTP Request (Fala Cheese) — POST /api/v1/posts com payload mapeado:

   {
     "body": "{{$json[\"body\"][\"texto\"]}}",
     "socialAccountIds": ["{{$json[\"body\"][\"plataforma_id\"]}}"],
     "scheduledAt": "{{$json[\"body\"][\"horario\"]}}"
   }
   

Sample JSON exports

O repo do app tem 3 workflows JSON prontos em docs/integrations/n8n.md. Pra importar no seu n8n:

1. Abre n8n → Workflows → Import from File
2. Cola o JSON
3. Ajusta a credencial Fala Cheese
4. Roda

Limites e dicas

• Rate limit: 30 req/min na nossa API → se o n8n disparar burst, adiciona node Wait entre chamadas
• Idempotência: nossa API NÃO é idempotente. Se o n8n retry após timeout, pode duplicar post. Use Conditional no n8n pra checar response antes de retry
• Logs: cada execução do n8n fica no histórico — bom pra debugar quando algo falha

Quando NÃO usar n8n

• Fluxo simples (1 webhook → 1 post) — REST direto sem n8n é mais simples
• Volume alto (>1000 posts/dia) — n8n hospedado próprio fica caro, considera worker próprio
• Trigger não suportado pelo n8n (BlueSky polls, etc.) — pode ficar mais fácil escrever script Python que usa nossa API