Integração com Make.com

Make.com (ex-Integromat) é a alternativa principal ao n8n e Zapier pra automação visual. Como no n8n, usamos o módulo HTTP padrão pra chamar a API do Fala Cheese.

Setup inicial

1. Criar uma connection HTTP reutilizável

Em Make, Connections → Add → escolhe HTTP → Custom auth (ou só passa o header diretamente no módulo). Mais simples é passar header em cada chamada.

2. Configurar HTTP module

• URL: https://app.falacheese.com.br/api/v1/posts
• Method: POST
• Headers:
  • Authorization = Bearer fc_live_<tua_chave>
  • Content-Type = application/json
• Body type: Raw
• Content type: JSON (application/json)
• Request content: o JSON do post

Cenário 1: Google Sheets → Fala Cheese

Cenário: você mantém planilha de posts no Google Sheets e quer que cada linha vire um post agendado.

Modules:

1. Google Sheets — Watch Rows (trigger por nova linha)
2. HTTP — Make a request (POST pra Fala Cheese)

JSON body com mapeamento das colunas:

{
  "body": "{{1.texto}}",
  "socialAccountIds": ["{{1.platforma_id}}"],
  "scheduledAt": "{{formatDate(1.data; 'YYYY-MM-DDTHH:mm:ssZ')}}",
  "firstComment": "{{1.primeiro_comentario}}"
}

Cenário 2: Airtable → IG carrossel

Cenário: você cria carrosséis no Airtable (uma coluna por slide) e quer publicar via Fala Cheese.

Modules:

1. Airtable — Watch Records com filtro "Status = Pronto pra publicar"
2. HTTP — Make a request pra criar draft no Fala Cheese (não publica auto)
3. Airtable — Update Record marca status como "Enviado pra revisão"

Você revisa em /app/drafts, ajusta e publica manualmente.

Cenário 3: Webhook genérico → Cross-post

Cenário: outra ferramenta dispara webhook (Typeform, ConvertKit, etc.) e você quer cross-post pra LinkedIn + Instagram juntos.

Modules:

1. Webhooks — Custom webhook (Make gera URL)
2. HTTP — Make a request com socialAccountIds contendo 2 IDs (LI + IG):

{
  "body": "{{webhook.body.texto}}",
  "socialAccountIds": ["acc_li", "acc_ig"],
  "publishNow": true
}

Iterators pra processar lote

Make tem Array Aggregator e Iterator úteis quando você precisa criar N posts a partir de array:

1. Source retorna array (ex. resultado de scrape)
2. Iterator itera item por item
3. HTTP chama Fala Cheese pra cada item
4. Wait 3s entre chamadas (respeita rate limit 30/min)
5. Array Aggregator junta resultados pra log

Error handling

Make tem Error handler routes que disparam quando módulo falha. Boas práticas:

• Adiciona error handler no HTTP module
• Se response = 429 (rate limit), Sleep 60s + Retry
• Se response = 401 ou 403, manda email pra você (chave inválida ou expirada)
• Se response = 500, registra em planilha pra debug depois

Sample blueprint export

O repo do app tem 3 cenários prontos em docs/integrations/make.md. Cada um vem como blueprint JSON.

Pra importar:

1. Make → Scenarios → Create new → Import Blueprint
2. Cola o JSON
3. Ajusta as connections (a sua API key)
4. Ativa

Rate limits e custo Make

Make conta cada module execution. Workflow simples (Sheets → HTTP) ~3 ops por post. Em volume alto, vira custo. Pra > 500 posts/mês via Make, considera workflow direto em n8n self-hosted ou script próprio.

Quando NÃO usar Make

• Você já paga n8n self-hosted — usa lá, custo zero
• Lógica muito complexa (Make travaliza com if/else aninhado)
• Precisa de async/await fino (Make é sync por padrão)