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.
Quick start
3 passos do zero ao primeiro post via API.
- 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. 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 (formatofc_live_...). A key só aparece uma vez — guarde num gerenciador de senhas. - 3. Faça seu primeiro requestcurlbash
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 / fetchjavascriptconst 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 }Pythonpythonimport 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())
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
FALACHEESE_API_KEY).Endpoints
Os 6 que você vai usar no dia a dia.
/api/v1/postsCria 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
}/api/v1/postsLista posts do user — drafts, agendados, publicados, falhados. Filtros via query string.
/api/posts/{id}/replyResponde a um comentário recebido no inbox. Útil pra auto-resposta via fluxo externo.
/api/ai/textGera 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"]
}/api/ai/hashtagsSugere 3-5 hashtags adaptadas pra plataforma (5-cap aware do Instagram desde Dez/2025).
/api/openapiOpenAPI 3.1 spec completa do endpoint. Cola direto no ChatGPT Custom GPT Builder, Swagger, Postman, n8n.
Integrações prontas
Sem código: n8n, Make, ChatGPT, Claude.
n8n
HTTP Request node + sample workflows3 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 prontosScenarios: Google Sheets → Post, Trello card → Schedule, Calendly invitee → auto-promo no LinkedIn.
Ver docs →ChatGPT Custom GPT
OpenAPI 3.1 ActionsCole 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 nativoAdd 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).
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.
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_accountsLista contas sociais conectadas + plataforma + handle
create_postCria + agenda/publica post em uma ou várias plataformas
list_scheduledLista posts agendados + status atual
search_mediaBusca na biblioteca de mídia do user
// Settings → Connectors → Add Custom Connector
{
"name": "Fala Cheese",
"url": "https://app.falacheese.com.br/api/mcp",
"auth": {
"type": "bearer",
"token": "fc_live_xxxxxxxxxxxx"
}
}Rate limits e quotas
O que tu pode esperar.
| Plano | API access | Posts/mês | Créditos IA | Rate limit |
|---|---|---|---|---|
| Free | ❌ | 0 | 0 | — |
| Trial 7d | ❌ | — | 30 text / 20 img / 3 vid | — |
| Starter (R$ 99) | ❌ | 200 | 1.250 | — |
| Criador (R$ 297) | ✅ | 1.000 | 5.000 | 60 req/min |
| Agência (R$ 1.497) | ✅ | ∞ | 28.000 | 300 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.
