● Developers

API & Integrações.

REST API, MCP server pra Claude, sample workflows pra n8n + Make, OpenAPI 3.1 spec pronta pra ChatGPT Custom GPT Actions. Construa em cima do Fala Cheese sem dor de cabeça.

RESTOpenAPI 3.1MCP (Claude)n8n + MakeBearer authJSON
01

Quick start

3 passos do zero ao primeiro post via API.

  1. 1. Crie uma conta + assinatura paga

    API só está disponível nos planos Criador e Agência. Trial 7 dias não inclui API (limitação intencional pra evitar abuso). Faça login em falacheese.com.br e ative o plano em Cobrança.

  2. 2. Gere uma API key

    Em /app/settings, seção API Keys → botão Nova key. Dê um nome (ex: “n8n produção”) e copie o valor (formato fc_live_...). A key só aparece uma vez — guarde num gerenciador de senhas.

  3. 3. Faça seu primeiro request
    curlbash
    curl -X POST https://app.falacheese.com.br/api/v1/posts \
      -H "Authorization: Bearer fc_live_xxxxxxxxxxxx" \
      -H "Content-Type: application/json" \
      -d '{
        "body": "Meu primeiro post via API 🚀",
        "platforms": ["linkedin", "instagram"],
        "publishNow": true
      }'
    Node.js / fetchjavascript
    const res = await fetch("https://app.falacheese.com.br/api/v1/posts", {
      method: "POST",
      headers: {
        Authorization: "Bearer fc_live_xxxxxxxxxxxx",
        "Content-Type": "application/json",
      },
      body: JSON.stringify({
        body: "Meu primeiro post via API 🚀",
        platforms: ["linkedin", "instagram"],
        publishNow: true,
      }),
    });
    const data = await res.json();
    console.log(data); // { ok: true, postId: "cm...", published: 2, failed: 0 }
    Pythonpython
    import requests
    
    res = requests.post(
        "https://app.falacheese.com.br/api/v1/posts",
        headers={"Authorization": "Bearer fc_live_xxxxxxxxxxxx"},
        json={
            "body": "Meu primeiro post via API 🚀",
            "platforms": ["linkedin", "instagram"],
            "publishNow": True,
        },
    )
    print(res.json())
02

Autenticação

Bearer token. Simples e seguro.

Todo request precisa do header Authorization: Bearer fc_live_....

  • Tokens começam com fc_live_ seguido de 64 chars hex
  • Armazenados como SHA-256 hash no DB — não dá pra recuperar plaintext (gere outra se perder)
  • Revogue qualquer key em /app/settings → efeito imediato
  • Tokens são scoped ao workspace ativo no momento de criação
Importante: nunca commit o token no Git. Se vazar, revogue imediato e gere outro. Use variáveis de ambiente (FALACHEESE_API_KEY).
03

Endpoints

Os 6 que você vai usar no dia a dia.

POST/api/v1/posts

Cria um post, agenda ou publica imediato. Aceita platforms (nome) OU socialAccountIds (ID específico), texto, mídia URLs públicas (a gente baixa e salva).

{
  "body": "texto do post",
  "platforms": ["linkedin", "instagram", "whatsapp"],
  "mediaUrls": ["https://cdn.exemplo.com/imagem.jpg"],
  "scheduledAt": "2026-05-25T14:00:00Z",
  "publishNow": false
}
GET/api/v1/posts

Lista posts do user — drafts, agendados, publicados, falhados. Filtros via query string.

POST/api/posts/{id}/reply

Responde a um comentário recebido no inbox. Útil pra auto-resposta via fluxo externo.

POST/api/ai/text

Gera texto adaptado por plataforma na voz da marca do user. Use pra integrar com seu fluxo de conteúdo.

{
  "topic": "Como aplicar IA em vendas B2B",
  "platforms": ["linkedin"]
}
POST/api/ai/hashtags

Sugere 3-5 hashtags adaptadas pra plataforma (5-cap aware do Instagram desde Dez/2025).

GET/api/openapi

OpenAPI 3.1 spec completa do endpoint. Cola direto no ChatGPT Custom GPT Builder, Swagger, Postman, n8n.

Spec interativa: baixe a OpenAPI em https://app.falacheese.com.br/api/openapi e importe no Swagger Editor pra teste interativo.
04

Integrações prontas

Sem código: n8n, Make, ChatGPT, Claude.

n8n

HTTP Request node + sample workflows

3 workflows JSON prontos pra importar: RSS → Post, Notion → Schedule, Webhook genérico → multi-rede. Custom node oficial em desenvolvimento.

Ver docs →

Make.com

HTTP module + scenarios prontos

Scenarios: Google Sheets → Post, Trello card → Schedule, Calendly invitee → auto-promo no LinkedIn.

Ver docs →

ChatGPT Custom GPT

OpenAPI 3.1 Actions

Cole a spec OpenAPI no GPT Builder → adiciona Auth (Bearer) → seu GPT customizado consegue postar no LinkedIn/IG/WhatsApp do user direto.

Ver docs →

Claude Desktop / Code

MCP server nativo

Add Custom Connector em Settings → URL https://app.falacheese.com.br/api/mcp → Claude passa a ter 4 tools (list_accounts, create_post, list_scheduled, search_media).

Ver docs →

Zapier

Em desenvolvimento (V2)

App oficial Zapier no pipeline. Por enquanto: HTTP webhook → /api/v1/posts.

Notion

Em desenvolvimento (V2)

Sync nativo Notion ↔ Fala Cheese (drafts em Notion → posted) no roadmap.

05

MCP server

Claude Desktop, Code e Cowork conectam direto.

MCP (Model Context Protocol) é o padrão Anthropic pra LLMs conectarem a ferramentas externas. Nosso servidor MCP fala JSON-RPC 2.0 e expõe 4 tools:

list_accounts

Lista contas sociais conectadas + plataforma + handle

create_post

Cria + agenda/publica post em uma ou várias plataformas

list_scheduled

Lista posts agendados + status atual

search_media

Busca na biblioteca de mídia do user

Setup no Claude Desktopjson
// Settings → Connectors → Add Custom Connector
{
  "name": "Fala Cheese",
  "url": "https://app.falacheese.com.br/api/mcp",
  "auth": {
    "type": "bearer",
    "token": "fc_live_xxxxxxxxxxxx"
  }
}
06

Rate limits e quotas

O que tu pode esperar.

PlanoAPI accessPosts/mêsCréditos IARate limit
Free00
Trial 7d30 text / 20 img / 3 vid
Starter (R$ 99)2001.250
Criador (R$ 297)1.0005.00060 req/min
Agência (R$ 1.497)28.000300 req/min

Rate limit é por API key. 429 retornado quando exceder, com header Retry-After em segundos.

Bora construir.

Entra na lista de espera. Quem chegar antes ganha 30 dias grátis no plano Criador (com API) no lançamento.