API de publicações na Página do Facebook: texto, links, fotos e vídeos
A Graph API publica quatro tipos de publicação de Página: texto e links por POST /{page-id}/feed, uma foto por /{page-id}/photos a partir de uma URL já disponível na internet, e um vídeo por /{page-id}/videos a partir de uma URL de arquivo acessível. As publicações aparecem com a voz da Página, exigem um token de acesso da Página com pages_manage_posts e podem ficar não publicadas à espera de um horário agendado.
O easyCoexistence publica em Páginas do Facebook com o publish_facebook_post a partir do Claude, do ChatGPT ou do seu próprio código: texto, link, foto ou vídeo, agora ou agendado em até 90 dias pela fila do easyCoexistence, e o list_social_posts lê as publicações de volta.
Maior arquivo de foto que a Meta aceita para uma Página; ela recomenda manter arquivos PNG abaixo de 1 MB para evitar pixelização.
Tipos de arquivo de foto que a Meta lista para fotos de Página: JPEG, BMP, PNG, GIF e TIFF.
Código de erro quando a Meta não consegue buscar o arquivo de vídeo na URL enviada para /{page-id}/videos.
Publicações ranqueadas e publicadas por ano que a API retorna ao ler o feed de uma Página, no máximo 100 por requisição.
O que uma publicação de Página pode conter?
Quatro tipos de conteúdo, por três endpoints da Página, e as publicações aparecem com a voz da Página. Texto e links compartilham o endpoint de feed, onde message ou link precisam estar presentes; foto e vídeo têm cada um um endpoint próprio:
Como o publish_facebook_post escolhe o endpoint?
Pelo que recebe. Um video_url vai para /videos com message como descrição; caso contrário, um image_url vai para /photos com message como texto; caso contrário, message e link vão para /feed. O link só viaja em publicação de texto, então, com foto ou vídeo, coloque a URL em message. Sem scheduled_at, a publicação sai na hora e o resultado traz post_id, o ID devolvido pela Meta, e url, o link dela no Facebook; com scheduled_at, o easyCoexistence mantém a publicação na sua fila, de 1 minuto a 90 dias à frente, e a publica nesse momento.
Onde a mídia precisa estar?
Em um endereço que a Meta consiga acessar, porque a própria Meta busca o arquivo. Para uma foto, url é uma foto já enviada à internet; para um vídeo, file_url é uma URL acessível do arquivo, e um vídeo que a Meta não consegue buscar falha com erro 389. Uma publicação com link falha quando o app não consegue ver a URL vinculada, e o erro 1609005 significa que a Meta não conseguiu extrair dados do link.
Quais arquivos de foto a Meta aceita?
Arquivos JPEG, BMP, PNG, GIF e TIFF de até 10 MB, segundo a referência de fotos da Meta, que recomenda manter arquivos PNG abaixo de 1 MB, pois os maiores podem ficar pixelizados. A Meta remove os metadados de localização antes de publicar e redimensiona as imagens para exibição em vários tamanhos. Uma imagem ausente ou inválida falha com erro 324.
O que uma publicação de vídeo precisa?
Um arquivo que a Meta consiga baixar de file_url, com o texto da publicação em description, que a Meta pode exibir junto da publicação; um título é opcional, e o publish_facebook_post o deixa sem valor. A visão geral da Video API da Meta diz que a pessoa por trás do token deve conseguir executar tarefas equivalentes às de administrador na Página, e sua Resumable Upload API cuida de arquivos grandes, retomando uploads interrompidos.
Como as publicações são lidas e editadas?
O list_social_posts retorna as publicações recentes da Página, 25 por padrão e até 100 por chamada, cada uma com seu ID, texto, data de criação, permalink e imagem. A referência da Meta limita a leitura do feed a 100 publicações por requisição e retorna aproximadamente 600 publicações ranqueadas e publicadas por ano. A API da Meta edita uma publicação com POST /{page-post-id} e a nova message, somente para publicações feitas pelo mesmo app; o easyCoexistence não tem ferramenta para isso, então uma publicação é editada no Facebook ou no Meta Business Suite.
Erros comuns
- Passar um link junto com foto ou vídeo. O publish_facebook_post recusa um link junto de um arquivo, então, quando a publicação tiver mídia, escreva a URL na message.
- Publicar o mesmo conteúdo duas vezes seguidas. A Meta recusa publicações duplicadas consecutivas com o erro 506, então altere o texto antes de repetir a publicação.
- Apontar para um arquivo atrás de login ou para um link prestes a expirar. A Meta busca a foto ou o vídeo pela própria URL, então o endereço precisa continuar público até a publicação estar no ar.
De US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os 3 primeiros dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
Dá para publicar uma foto em uma Página do Facebook a partir de uma URL?
Sim. O POST /{page-id}/photos recebe url, o endereço de uma foto que já está na internet, e a própria Meta a busca.
Por que uma publicação de Página do Facebook falha com o erro 506?
A Meta recusa publicações duplicadas consecutivas com o erro 506, então altere o texto antes de publicar de novo.
Uma publicação do Facebook pode ter várias fotos?
Não pelo easyCoexistence: o publish_facebook_post aceita uma foto. A Meta documenta publicações com várias fotos, montadas a partir de fotos enviadas sem publicação e anexadas a uma publicação do feed, e suas ferramentas não cobrem isso.
Dá para editar uma publicação de Página do Facebook pela API?
Sim, com POST para o ID da publicação, mas só para publicações feitas pelo mesmo app. O easyCoexistence não tem ferramenta para isso, então edite a publicação no Facebook ou no Meta Business Suite.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em