Facebook BulkPublish

API do Facebook

Publique, agende e gerencie o Facebook a partir do seu próprio código. Uma API REST e uma chave cobrem o Facebook e todas as outras redes que você conectar, então você escreve a integração uma vez só.

Obter uma chave de API grátis Ler a referência da API

Integração do Facebook com o BulkPublish

O que a API do Facebook cobre

Tudo abaixo faz parte da API publicada e já funciona com o Facebook.

Recurso	Endpoint
Criar, agendar, editar e publicar posts	`POST /api/posts`
Enviar imagens e vídeos	`POST /api/media`
Encontrar o próximo horário livre da sua fila	`GET /api/posts/queue-slot`
Criar agendamentos recorrentes	`POST /api/schedules`
Publicar novos itens de um feed RSS	`POST /api/rss-feeds`
Publicar um primeiro comentário automaticamente	`platformSpecific._firstComment`
Publicar um post como Story	`POST /api/posts/{id}/story`
Ler as métricas de cada post	`GET /api/posts/{id}/metrics`
Ler e responder comentários de posts publicados	`GET /api/posts/{id}/engagement, POST /api/posts/{id}/comments/reply`
Ler e responder mensagens diretas	`GET /api/inbox/conversations, POST /api/inbox/conversations/{id}/messages`
Ler e responder avaliações	`GET /api/inbox/conversations, POST /api/inbox/conversations/{id}/messages`
Verificar se a conexão está saudável	`GET /api/channels/{id}/health`
Consultar o uso do seu plano	`GET /api/quotas/usage`

Tipos de post que você pode publicar no Facebook

Escolha o tipo com postTypeOverrides. Um tipo que o Facebook não oferece é recusado antes de qualquer coisa entrar na fila.

Tipo de publicação	Mídia
`post` Post	Opcional, até 10 imagens ou vídeos
`reel` Reel	Obrigatório: 1 vídeo
`story` Story	Obrigatório: 1 imagem ou vídeo

Agende um post do Facebook com curl

Três requisições: encontre seu canal, envie o arquivo se o post tiver um e crie o post. Troque a chave por uma de Configurações, depois Chaves de API, e o 12 pelo id do seu próprio canal.

1. Liste seus canais e anote o id da sua conta do Facebook.

curl https://app.bulkpublish.com/api/channels \
  -H "Authorization: Bearer bp_your_key_here"

2. Envie o arquivo. A resposta traz o id da mídia, usado como mediaFiles abaixo.

curl -X POST https://app.bulkpublish.com/api/media \
  -H "Authorization: Bearer bp_your_key_here" \
  -F "file=@photo.jpg"

3. Crie o post.

curl -X POST https://app.bulkpublish.com/api/posts \
  -H "Authorization: Bearer bp_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "content": "Our spring range is in the shop today",
  "channels": [{ "channelId": 12 }],
  "status": "scheduled",
  "scheduledAt": "2026-12-01T09:00:00Z",
  "mediaFiles": [101],
  "platformSpecific": {
    "facebook": {
      "shareToStory": true
    }
  }
}'

A resposta é o post criado, com seu id e status. Busque-o depois com GET /api/posts/{id} para ver como foi.

Opções do Facebook

Envie estas opções dentro de platformSpecific, na chave do Facebook.

Opção	O que faz	Aceita
`shareToStory`	Compartilhar também em um Story	verdadeiro ou falso
`thumbnailUrl`	Imagem de capa, a partir de uma URL pública	texto

Análises do Facebook pela API

Estas métricas voltam para cada post do Facebook em GET /api/posts/{id}/metrics, com registros ao longo do tempo.

Impressões
Alcance
Curtidas
Comentários
Compartilhamentos
Cliques
Visualizações de vídeo
Taxa de engajamento

Comentários e mensagens

Pela API você pode ler e responder comentários de posts publicados, ler e responder mensagens diretas e ler e responder avaliações.

No Facebook, as respostas são aceitas até 24 horas depois da última mensagem da pessoa.

Ler comentários funciona em todos os planos. Responder comentários exige um plano pago, e a caixa de entrada faz parte do Pro e do Business. Enquanto um recurso não estiver ativado na sua conta, a API responde 403 com um código que você pode verificar.

Acesso à API em todos os planos

Todos os planos incluem chaves de API, inclusive o Free. Veja o que cada um permite.

Plano	Chaves de API	Requisições por dia
Free	1	30
Pro	5	5.000
Business	10	50.000

Construir direto no Facebook ou usar o BulkPublish

Ir direto é uma escolha válida, principalmente se você precisa de algo que o BulkPublish não oferece. Isto é o que Graph API for Pages exige de você, conferido com a documentação em outubro de 2026.

Você precisa registrar um app de desenvolvedor no Facebook antes de poder publicar.
Publicar como Página exige um token de acesso da Página ou uma função nessa Página.
A própria API pode agendar um post, dentro dos limites definidos pela plataforma.

O BulkPublish cuida da conexão por você: renova os tokens, confere cada post com as regras do Facebook antes de entrar na fila e informa no post qual destino falhou, então seu código faz uma única requisição.

Ler a documentação oficial

Prefere pedir a um assistente?

Claude, ChatGPT e Cursor fazem o mesmo pelo servidor MCP do Facebook, com comandos em vez de código.

Ver o servidor MCP do Facebook

Prefere um calendário a código?

A mesma conta do Facebook pode ser agendada pelo app, com calendário de conteúdo e envio em massa.

Ver o agendador do Facebook

Perguntas frequentes

Dúvidas comuns sobre a API do Facebook.

Existe uma API do Facebook que eu possa usar sem construir a integração sozinho?

Sim. O BulkPublish oferece o Facebook por meio da sua API REST. Conecte sua conta do Facebook uma vez e depois publique, agende e gerencie com uma chave. A mesma chave funciona em todas as outras redes que você conectar.

O que posso publicar no Facebook pela API?

Os tipos de post são Post, Reel e Story. Cada um é conferido com as regras de mídia do Facebook antes de entrar na fila, então uma requisição que o Facebook recusaria falha na hora, com um erro claro.

Posso agendar posts do Facebook pela API?

Sim. Envie o status "scheduled" com um horário em scheduledAt e um timezone, ou peça antes o próximo horário livre da sua fila. Agendamentos recorrentes e feeds RSS também estão disponíveis.

Posso ler as análises do Facebook pela API?

Sim. As métricas por post incluem Impressões, Alcance, Curtidas, Comentários, Compartilhamentos, Cliques, Visualizações de vídeo e Taxa de engajamento, com registros ao longo do tempo.

Posso ler e responder comentários ou mensagens do Facebook pela API?

Sim. Você pode ler e responder comentários de posts publicados, ler e responder mensagens diretas e ler e responder avaliações. Responder comentários exige um plano pago, e a caixa de entrada faz parte do Pro e do Business.

A API do Facebook custa algo a mais?

Não. O acesso à API está em todos os planos. O Free inclui 1 chave e 30 requisições por dia, o Pro 5 chaves e 5.000 por dia, o Business 10 chaves e 50.000 por dia.

Preciso de uma conta de desenvolvedor do Facebook ou de uma revisão de app?

Não para usar o BulkPublish. Você conecta sua conta do Facebook na página Canais e publica com uma chave do BulkPublish. Se preferir construir direto na API do Facebook, a seção acima lista o que ela exige de você.

Um assistente de IA também consegue fazer isso?

Sim. A página do servidor MCP do Facebook mostra como conectar Claude, ChatGPT ou Cursor e o que pedir.

A mesma chave e o mesmo formato de requisição funcionam em 15 redes.