
Guias de integração
Guia da API do LinkedIn
Guia da API de e-mail
Guia da API do WhatsApp
Fale com vendas
Publique, edite, exclua e leia posts do Facebook por API em 2026, pela Pages API da Meta ou pelas próprias contas conectadas dos seus usuários.
posts
PATCHposts/{id}
DELETEposts/{id}
200 OK
Uma API de posts do Facebook permite que o seu app publique, edite, exclua e leia posts do Facebook com requisições HTTP. Há dois caminhos: a Pages API da Meta, que só publica em Páginas do Facebook por meio de um app da Meta e de Page access tokens, ou uma conta conectada, em que cada usuário vincula a própria conta do Facebook e o seu app publica como o perfil dele ou como uma Página que ele gerencia.
Para o panorama completo da plataforma da Meta, veja como as APIs do Facebook se encaixam.
Publique um post no Facebook em três etapas
Conecte a contaO seu usuário conecta a conta do Facebook, e as Páginas que gerencia, pelo Hosted Auth. Sem app da Meta, sem App Review.
Crie o postEnvie POST /v2/{account_id}/posts com a sua chave em X-API-KEY e um texto ou anexos.
Edite, exclua ou publique como PáginaChame PATCH ou DELETE no post, ou adicione post_as com o ID de uma Página ativada.
A Meta não tem nenhum produto chamado "Post API". Os posts do Facebook são objetos da Graph API, e os apps os publicam pela Pages API, que só escreve em Páginas do Facebook. Desde 2018, um app de terceiros não pode mais publicar no perfil pessoal de alguém.
Na prática, "API de posts do Facebook", ou o que os desenvolvedores chamam de API do Facebook para posts, significa chamadas da Graph API em um nó de post e no edge /feed de uma Página. Nós, edges e tokens: veja a nossa visão geral da Graph API do Facebook.
{page_id}_{post_id}O nó do post. O ID dele junta o ID do autor e o ID do post./{page_id}/feedO edge que lista os posts de uma Página e recebe os novos.messageO texto do post.created_timeQuando o post foi publicado./{page_id}/photosO edge dos posts com foto.Envie POST /{page_id}/feed com um message (e, opcionalmente, um link), usando um Page access token (veja o guia da API de Páginas do Facebook e o nosso guia sobre o token de acesso da API do Facebook). A Meta retorna o ID do novo post como {"id": "{page_post_id}"}.
Crie um app e adicione o Facebook Login for Business.
pages_show_listSolicite os direitos de publicação e depois passe pelo App Review.
pages_manage_postsObtenha o token de Página a partir do token de usuário.
GET /me/accountsPublique no feed da Página com o token de Página.
POST /{page_id}/feedpages_manage_posts, pages_read_engagement e pages_show_list, concedidas por alguém que possa executar a tarefa CREATE_CONTENT na Página.pages_manage_engagement e pages_read_user_engagement, com as tarefas CREATE_CONTENT, MANAGE e MODERATE.publish_video.A requisição e a resposta estão nas abas Meta cURL e Meta Python do bloco de código abaixo, ao lado da versão da Unipile.
| Parâmetro | O que faz |
|---|---|
message | O texto do post |
link | Uma URL exibida com prévia do link |
published | false para um post não publicado ou agendado |
scheduled_publish_time | Data de publicação, de 10 minutos a 30 dias à frente |
false para um post não publicado ou agendadoFotos e vídeo. Uma única foto vai para /{page_id}/photos. Para um post com várias fotos, envie cada foto para esse edge com published=false e depois publique todas juntas em /{page_id}/feed com attached_media e os IDs retornados; as fotos não publicadas são excluídas após 24 horas. Os vídeos passam pela Video API com publish_video.
Fonte da Meta: documentação de posts da Pages API, primeiros passos com a Pages API, a referência do feed de Página e a referência de fotos de Página (Graph API v27.0). Última verificação: 17 de novembro de 2026.
Três regras da Graph API definem qualquer projeto de publicação no Facebook: os apps não podem publicar em perfis pessoais, não podem publicar em Grupos e só podem atualizar os posts de Página que eles mesmos criaram.
A Meta retirou a permissão publish_actions dos apps em 1º de agosto de 2018. Detalhes nos limites da API oficial do Facebook.
A Groups API e a publish_to_groups foram descontinuadas com a Graph API v19.0 em 23 de janeiro de 2024.
"Um app só pode atualizar um post de Página se o post tiver sido feito com esse app."
O seu app não pode atualizar um post escrito no facebook.com ou por outra ferramenta, então um produto que edita posts precisa criá-los.
Os primeiros erros que você vai encontrar. Com a Graph API, o código 190 significa que o token de acesso expirou, os códigos 200 a 299 significam que uma permissão não foi concedida ou foi removida, e 4 ou 17 significam chamadas demais. Com a Unipile, publicar como uma Página não ativada retorna 403 api/insufficient_permissions.
Fontes da Meta: documentação de posts da Pages API, changelog do Facebook Login, anúncio da Graph API v19.0 e tratamento de erros da Graph API. Última verificação: 17 de novembro de 2026.
Com a Unipile, cada usuário conecta a conta do Facebook pelo Hosted Auth, e o seu app recebe um account_id. Você cria um post com POST /v2/{account_id}/posts, altera o texto com PATCH e o remove com DELETE. Um post excluído vai para a lixeira, onde o autor ainda pode lê-lo por 30 dias.
Sem app da Meta nem App Review do seu lado: cada chamada envia a sua chave de API em X-API-KEY e é executada em nome do usuário que conectou a conta. As abas Meta mostram a mesma publicação com a Graph API e um Page access token, para comparação.
const BASE = "https://api.unipile.com/v2";
const headers = {
"X-API-KEY": process.env.UNIPILE_API_KEY,
"content-type": "application/json"
};
// 1. Publish a text post from the connected account
await fetch(`${BASE}/${ACCOUNT_ID}/posts`, {
method: "POST", headers,
body: JSON.stringify({ text: "Our autumn menu starts Monday." })
});
// 2. Edit its text later (media and audience are kept)
await fetch(`${BASE}/${ACCOUNT_ID}/posts/${POST_ID}`, {
method: "PATCH", headers,
body: JSON.stringify({ text: "Our autumn menu starts Monday at 7am." })
});
import os, requests
BASE = "https://api.unipile.com/v2"
headers = {"X-API-KEY": os.environ["UNIPILE_API_KEY"]}
# 1. Publish a text post from the connected account
requests.post(f"{BASE}/{ACCOUNT_ID}/posts", headers=headers,
json={"text": "Our autumn menu starts Monday."})
# 2. Edit its text later (media and audience are kept)
requests.patch(f"{BASE}/{ACCOUNT_ID}/posts/{POST_ID}", headers=headers,
json={"text": "Our autumn menu starts Monday at 7am."})
# 1. Publish a text post from the connected account
curl --request POST \
--url "https://api.unipile.com/v2/{ACCOUNT_ID}/posts" \
--header "X-API-KEY: {YOUR_API_KEY}" \
--header "content-type: application/json" \
--data '{ "text": "Our autumn menu starts Monday." }'
# 2. Edit its text later (media and audience are kept)
curl --request PATCH \
--url "https://api.unipile.com/v2/{ACCOUNT_ID}/posts/{POST_ID}" \
--header "X-API-KEY: {YOUR_API_KEY}" \
--header "content-type: application/json" \
--data '{ "text": "Our autumn menu starts Monday at 7am." }'
# Meta Graph API: publish to a Page with a Page access token
curl -X POST "https://graph.facebook.com/v27.0/{PAGE_ID}/feed" \
-H "Content-Type: application/json" \
-d '{
"message": "Our autumn menu starts Monday.",
"link": "https://example.com/menu",
"access_token": "{PAGE_ACCESS_TOKEN}"
}'
# Response: the ID of the new Page post
{ "id": "{PAGE_POST_ID}" }
# Read that post back with the fields you need
curl -G "https://graph.facebook.com/v27.0/{PAGE_POST_ID}" \
-d "fields=id,message,created_time,permalink_url" \
-d "access_token={PAGE_ACCESS_TOKEN}"
import os, requests
GRAPH = "https://graph.facebook.com/v27.0"
TOKEN = os.environ["PAGE_ACCESS_TOKEN"]
# Meta Graph API: publish to a Page
r = requests.post(f"{GRAPH}/{PAGE_ID}/feed", data={
"message": "Our autumn menu starts Monday.",
"link": "https://example.com/menu",
"access_token": TOKEN,
})
post_id = r.json()["id"] # {"id": "{PAGE_POST_ID}"}
# Read that post back with the fields you need
post = requests.get(f"{GRAPH}/{post_id}", params={
"fields": "id,message,created_time,permalink_url",
"access_token": TOKEN,
}).json()
Os campos da requisição estão em Create posts, a edição e a lixeira em Edit and delete posts. As abas Meta seguem o guia de posts da Pages API e a referência de Post, v27.0, verificados em 17 de nov. de 2026.
| Campo ou caso | Regra |
|---|---|
text e attachments | Texto ou anexo obrigatório. Arquivos em base64, ou multipart para arquivos grandes |
| Imagens | Várias imagens formam um álbum |
| Vídeo | Um vídeo por post, nunca misturado com imagens |
quoted_post_id | Compartilha um post, sem anexos |
| Menções | @ mais um ID ou nome de usuário em text |
can_read | anyone (padrão) ou relations_only |
can_comment | Só anyone; caso contrário, 400 |
@ mais um ID ou nome de usuário em textanyone (padrão) ou relations_onlyanyone; caso contrário, 400Os seus usuários publicam a partir das próprias contas
A Unipile não é um produto da Meta nem um Meta Partner. Os seus usuários conectam as próprias contas, decidem o que é publicado e continuam sujeitos aos termos da Meta.
Adicione post_as com o ID de uma Página que a conta administra e que está ativada na conta. Não há uma conta separada para conectar: o mesmo account_id cobre o perfil do usuário e as Páginas dele.
PAGE_<page_id>_INBOX.403 api/insufficient_permissions.As etapas de configuração estão na documentação de Páginas do Facebook.
POST /v2/{account_id}/posts
{
"text": "Hello from our Page!",
"post_as": "1357020157484056"
}
Com a API da Meta, chame GET /{page_id}/feed com um Page access token. Com a Unipile, chame GET /v2/, em que user_id é me, o ID de uma Página ativada ou o ID de outra pessoa ou Página cujos posts a conta conectada já consegue ver no Facebook.
Uso típico: atividade recente em um CRM ou ferramenta social, para as contas que os seus usuários conectaram. A leitura dos posts de outra pessoa fica limitada ao que a conta conectada já vê no Facebook e acontece quando o usuário pede.
Animada para entrar no time de Lisboa no mês que vem!
Os slides da minha palestra sobre ferramentas de suporte já estão no ar.
Trilha de fim de semana com o time.
next_cursor: "QVFIUm..."v2/{ACCOUNT_ID}/users/{USER_ID}/posts
200 OK
/v2/{account_id}/users/{user_id}/posts me, o ID de uma Página ativada ou o ID de outra pessoa ou Página, limitado aos posts que a conta conectada já consegue ver/v2/{account_id}/posts/{post_id} <author id>_<post id>account_idO Facebook retorna até 3 posts por página, seja qual for o limit enviado. Siga next_cursor para obter a próxima página; não existe offset. Detalhes em List user posts.
A Pages API da Meta serve para um app que publica nas Páginas da própria empresa ou em Páginas de clientes que passam pelo seu app da Meta. Uma conta conectada serve para um produto SaaS em que cada usuário publica a partir do próprio perfil e das próprias Páginas, sem app da Meta do seu lado.
| Critério | Pages API da Meta | Conta conectada (Unipile) |
|---|---|---|
| Contas cobertas | Páginas que os usuários do seu app gerenciam | O perfil do usuário e as Páginas que ele gerencia |
| Configuração do seu lado | App da Meta, Facebook Login, App Review | Chave de API e Hosted Auth, sem App Review |
| Credenciais | Um token de Página por Página | Um account_id por usuário |
| Posts no perfil pessoal | Indisponível desde 2018 | Sim, como o usuário conectado |
| Edição de posts | Só os posts feitos com o seu app | Texto de um post, por post_id |
| Grupos | Descontinuada na v19.0 | Não suportado |
| Stories | Fora do escopo deste guia | Não suportado |
| Agendamento | scheduled_publish_time, de 10 minutos a 30 dias | Não documentado; use a sua própria fila de jobs |
| Outras redes | Só Páginas do Facebook | A mesma API para LinkedIn, Instagram, WhatsApp e outras |
account_id por usuáriopost_idscheduled_publish_time, de 10 minutos a 30 diasA mesma conexão cobre as conversas: veja a API do Facebook e do Messenger da Unipile, como conectar uma conta pessoal do Facebook e os preços da API do Facebook Messenger.
A API de posts do Facebook rende mais dentro dos produtos em que as pessoas já trabalham, com cada usuário publicando a partir das próprias contas.
Os community managers publicam e corrigem posts do perfil e das Páginas deles, ao lado das mensagens.
Quando o vendedor pede, uma ficha de contato mostra os posts mais recentes da pessoa, limitados ao que a conta conectada do vendedor já vê no Facebook.
Um agente redige um post, o usuário o aprova e só então o seu app envia o POST.
O mesmo modelo de posts funciona para outras redes: o nosso guia da API do Instagram cobre a outra rede da Meta.
Comece a publicar posts do Facebook a partir do seu app
Use a Pages API da Meta para as suas próprias Páginas. Quando cada usuário publica, edita e lê posts a partir do próprio perfil e das próprias Páginas, conecte as contas deles pela Unipile: uma única API REST.
Cada usuário conecta a própria conta, sem armazenamento de perfis. A Unipile não é Meta Partner. Saiba mais
Todos os endpoints da API do Facebook em um só lugar
Os posts são só uma parte do panorama. Veja todos os endpoints do Facebook disponíveis com a Unipile, de mensagens a perfis, ou leia o guia completo da API do Facebook.
Respostas rápidas sobre Páginas, fotos, agendamento, edições, Grupos, vídeo e leitura de posts.
Com a Pages API da Meta, envie POST /{page_id}/feed com um message, usando um Page access token e as permissões pages_manage_posts, pages_read_engagement e pages_show_list. Com a Unipile, o usuário conecta a conta do Facebook uma única vez e você chama POST /v2/{account_id}/posts com post_as definido como o ID de uma Página que ele gerencia e ativou.
Com a Unipile, várias imagens em um post são exibidas como um álbum, e um post pode levar um vídeo no lugar delas, nunca os dois. Com a Pages API da Meta, as fotos são publicadas pelo edge /{page_id}/photos.
A Pages API da Meta permite: crie o post com published definido como false e um scheduled_publish_time entre 10 minutos e 30 dias à frente, segundo o guia da Pages API (a referência do Page feed fala em 75 dias; teste na sua versão). A Unipile não documenta agendamento nativo, então guarde a data planejada na sua própria fila de jobs e chame POST /v2/{account_id}/posts na hora certa.
Sim. Com a API da Meta, um app só pode atualizar os posts de Página que ele criou e exclui um post com DELETE /{page_post_id}. Com a Unipile, PATCH /v2/{account_id}/posts/{post_id} altera o texto e DELETE move o post para a lixeira, onde o autor pode lê-lo por 30 dias.
Não. A Meta descontinuou a Groups API e a permissão publish_to_groups com a Graph API v19.0 em janeiro de 2024, e a Unipile também não oferece publicação em Grupos.
Você pode publicar um vídeo. Com a Unipile, um post leva um vídeo, que o Facebook processa de forma assíncrona. Os Reels não são documentados e os Stories não são suportados.
Com a Graph API da Meta, chame GET /{page_id}/feed com um Page access token e as permissões pages_read_engagement e pages_read_user_content; limit retorna no máximo 100 posts por requisição. Com a Unipile, chame GET /v2/{account_id}/users/{user_id}/posts com o ID de uma Página ativada e depois siga next_cursor para obter a próxima página.
Não. A Unipile é uma empresa independente, não um Meta Partner, e não é endossada, patrocinada nem aprovada pela Meta. Os posts que o seu app publica vêm das próprias contas e Páginas do Facebook dos seus usuários. Facebook é uma marca registrada da Meta Platforms, Inc.
Não. Para publicar ou ler posts pela Unipile, os seus usuários conectam a própria conta do Facebook, e as Páginas que gerenciam, pela autenticação hospedada. Você dispensa o app da Meta, as permissões de publicação e o App Review que o caminho da Pages API exige.
A Unipile foi projetada no espírito do Digital Markets Act: cada usuário conecta a própria conta e decide o que é publicado, e a Unipile age em nome dele sem armazenar perfis de usuários. Saiba mais na nossa página sobre o Digital Markets Act.
Sim. Cada post que o seu app publica ou lê passa por uma conta que continua sujeita aos Termos de Serviço da Meta. Mantenha-se em usos legítimos, como publicar o conteúdo dos próprios usuários e mostrar os posts que a conta deles já vê quando eles pedem; spam e automação não autorizada podem levar à restrição das contas.
Ainda tem dúvidas? Nossa equipe está aqui para ajudar.
Fale com um especialista