Uma chamada REST basta: post to Facebook via API

Envie uma requisição autenticada para /social-posts e publique no Facebook via API: texto, uma foto, um vídeo, um carrossel de 2-10 imagens, um Reel ou um Story em vídeo em uma Facebook Page que você conectou.

Requisição da API do AdaptlyPost publicando em uma Facebook Page, mostrando o campo de conexão pageIds, o postType em facebookConfigs e o resultado de publicação por plataforma

A Confiança de Criadores e Equipes

Veja como criadores, profissionais de marketing e pequenas empresas usam o AdaptlyPost para manter a consistência e economizar horas toda semana.

Sou engenheiro de software, não marketeiro. Minha parceira tem uma página no TikTok, então ajudo agendando os posts dela, preparo tudo de uma vez e deixo a IA cuidar das legendas. Agora me toma uns 20 minutos por semana.

Denys Zinych
Denys Zinych

Engenheiro de Software

Eu gerencio minha página de nail art e uma marca pessoal. Agendar ambas de um único painel mudou tudo, agora publico de forma consistente e meu engajamento subiu bastante em um mês.

Irena
Irena

Criadora de Conteúdo

Sou SWE e, sinceramente, péssimo em postar com consistência. Só organizo uma semana de atualizações para a minha marca pessoal quando tenho um tempinho livre, e a IA escreve as legendas por plataforma para eu não ter que reescrever a mesma coisa de cinco formas diferentes.

Dorian Opacki
Dorian Opacki

Engenheiro de Software

Sou engenheiro de software, não marketeiro. Minha parceira tem uma página no TikTok, então ajudo agendando os posts dela, preparo tudo de uma vez e deixo a IA cuidar das legendas. Agora me toma uns 20 minutos por semana.

Denys Zinych
Denys Zinych

Engenheiro de Software

Eu gerencio minha página de nail art e uma marca pessoal. Agendar ambas de um único painel mudou tudo, agora publico de forma consistente e meu engajamento subiu bastante em um mês.

Irena
Irena

Criadora de Conteúdo

Sou SWE e, sinceramente, péssimo em postar com consistência. Só organizo uma semana de atualizações para a minha marca pessoal quando tenho um tempinho livre, e a IA escreve as legendas por plataforma para eu não ter que reescrever a mesma coisa de cinco formas diferentes.

Dorian Opacki
Dorian Opacki

Engenheiro de Software

Sou engenheiro de software, não marketeiro. Minha parceira tem uma página no TikTok, então ajudo agendando os posts dela, preparo tudo de uma vez e deixo a IA cuidar das legendas. Agora me toma uns 20 minutos por semana.

Denys Zinych
Denys Zinych

Engenheiro de Software

Eu gerencio minha página de nail art e uma marca pessoal. Agendar ambas de um único painel mudou tudo, agora publico de forma consistente e meu engajamento subiu bastante em um mês.

Irena
Irena

Criadora de Conteúdo

Sou SWE e, sinceramente, péssimo em postar com consistência. Só organizo uma semana de atualizações para a minha marca pessoal quando tenho um tempinho livre, e a IA escreve as legendas por plataforma para eu não ter que reescrever a mesma coisa de cinco formas diferentes.

Dorian Opacki
Dorian Opacki

Engenheiro de Software

Não sou pessoa de redes sociais mas preciso publicar meu trabalho em algum lugar. O escritor IA faz um rascunho decente, eu ajusto um pouco, agendo, pronto. Passei de postar uma vez por mês para três vezes por semana.

Denys Kholin
Denys Kholin

Designer Freelancer

Conectamos nosso agente OpenClaw ao AdaptlyPost e agora nossa IA publica atualizações de produto em todos os canais automaticamente. Parece futurista mas honestamente simplesmente funciona. A integração via API foi direta.

Taras Shynkarenko
Taras Shynkarenko

Fundador de Startup

Não sou pessoa de redes sociais mas preciso publicar meu trabalho em algum lugar. O escritor IA faz um rascunho decente, eu ajusto um pouco, agendo, pronto. Passei de postar uma vez por mês para três vezes por semana.

Denys Kholin
Denys Kholin

Designer Freelancer

Conectamos nosso agente OpenClaw ao AdaptlyPost e agora nossa IA publica atualizações de produto em todos os canais automaticamente. Parece futurista mas honestamente simplesmente funciona. A integração via API foi direta.

Taras Shynkarenko
Taras Shynkarenko

Fundador de Startup

Não sou pessoa de redes sociais mas preciso publicar meu trabalho em algum lugar. O escritor IA faz um rascunho decente, eu ajusto um pouco, agendo, pronto. Passei de postar uma vez por mês para três vezes por semana.

Denys Kholin
Denys Kholin

Designer Freelancer

Conectamos nosso agente OpenClaw ao AdaptlyPost e agora nossa IA publica atualizações de produto em todos os canais automaticamente. Parece futurista mas honestamente simplesmente funciona. A integração via API foi direta.

Taras Shynkarenko
Taras Shynkarenko

Fundador de Startup

Como funciona

Passo 1

Crie um token e liste suas Pages

Gere uma chave em Settings > API Tokens (ela começa com adaptly_) e envie-a como Authorization: Bearer em toda chamada. Depois use GET /social-accounts: cada Facebook Page que você conectou no painel volta como uma conta própria, com um campo pageId. Perfis pessoais e Grupos nunca aparecem - a publicação no Facebook aqui é só para Pages, e o OAuth acontece no painel, não pela API.

Passo 2

POST /social-posts com pageIds

Chame POST https://post.adaptlypost.com/post/api/v1/social-posts com text, platforms: ["FACEBOOK"], um timezone como Europe/Berlin (ambos obrigatórios) e pageIds contendo exatamente uma Page - duas conexões de Page no mesmo array são rejeitadas com um 400. Adicione scheduledAt para agendar em vez de publicar na hora. facebookConfigs aceita apenas postType e videoTitle, e postType REEL ou STORY só é aplicado quando contentType é VIDEO: um payload IMAGE com postType STORY sai silenciosamente como uma foto normal no feed.

Passo 3

Leia o resultado do Facebook

GET /social-posts/:id/results retorna a entrada do Facebook com seu status e o platformPostId nativo - nenhum permalink é devolvido, então guarde esse ID vinculado à Page por conta própria. Erros de payload nunca aparecem aqui: um carrossel fora do intervalo de 2-10 imagens ou uma segunda Page em pageIds falham de forma síncrona com um 400 na chamada de criação, antes de existir qualquer registro de post, e tipos de arquivo não suportados são recusados antes disso, em POST /upload-urls. O que chega em errorMessage é o que o Facebook fez depois de aceitarmos e despacharmos o post - uma Page cujo acesso foi revogado (reconecte-a no painel, não existe endpoint de refresh de token) ou mídia que a Graph API recusou durante sua própria ingestão. Redispare apenas a entrada do Facebook com POST /social-posts/:id/retry ou registre um webhook: todo endpoint que você registrar recebe os quatro eventos - post.published, post.failed, post.partially_failed e post.scheduled.

Preços simples e transparentes

Escolha o plano perfeito para você

Creator

Perfeito para indivíduos e empreendedores

$19

/mês

  • 30 contas sociais conectadas

  • Posts agendados ilimitados

  • 1 membro de equipe

  • 3 espaços de trabalho

  • 150 créditos/mês

  • Legendas IA

  • Estúdio de imagens IA

  • Acesso à API e integração OpenClaw

  • Posts de imagem, vídeo e carrossel

Mais popular

Pro

Para profissionais e equipes em crescimento

$39

/mês

  • 60 contas sociais conectadas

  • Posts agendados ilimitados

  • 5 membros de equipe

  • 15 espaços de trabalho

  • 400 créditos/mês

  • Legendas IA

  • Estúdio de imagens IA

  • Acesso à API e integração OpenClaw

  • Posts de imagem, vídeo e carrossel

Enterprise

Para agências e empresas prontas para escalar

$89

/mês

  • 100 contas sociais conectadas

  • Posts agendados ilimitados

  • 20 membros de equipe

  • 50 espaços de trabalho

  • 1000 créditos/mês

  • Legendas IA

  • Estúdio de imagens IA

  • Acesso à API e integração OpenClaw

  • Posts de imagem, vídeo e carrossel

Todos os planos incluem teste gratuito de 7 dias

Quer ver a comparação completa de recursos? Ver página de preços

O que a API pode publicar em uma Facebook Page

Posts de texto no feed da Page

contentType TEXT envia o campo text direto para a timeline da Page. Não há controle de prévia de link, nem primeiro comentário, nem campo de @menção ou de localização, e nada de impulsionamento - o payload é o texto e nada mais.

Fotos e carrosséis de 2-10 imagens

Uma imagem, ou contentType CAROUSEL com 2 a 10 imagens em um único post da Page. Os arquivos precisam ser image/jpeg, image/png ou image/webp e ficar abaixo de 4MB cada (sem GIF, sem HEIC). Aponte mediaUrls para suas próprias URLs públicas ou envie os arquivos por POST /upload-urls para uploads pré-assinados.

Reels a partir de facebookConfigs.postType

Defina contentType VIDEO e facebookConfigs.postType = REEL para publicar um Reel do Facebook, com um videoTitle opcional. Os uploads aceitam video/mp4 e video/quicktime. postType e videoTitle são as duas únicas opções específicas do Facebook que a API expõe.

Stories em vídeo na Page

facebookConfigs.postType = STORY publica um Story da Page, mas apenas a partir de um vídeo - Stories com imagem não são possíveis pela API. Tudo vai para a única Page indicada em pageIds; distribuir o mesmo texto para uma segunda Page exige uma segunda chamada.

Pronto para publicar na sua Facebook Page via REST?

Conecte uma Page no painel, crie um token adaptly_ e envie sua primeira chamada POST /social-posts. A especificação OpenAPI 3.0.3 em /openapi.json é pública e não exige autenticação.