Publicar fotos em uma Página do Facebook: posts com uma ou várias fotos
Uma foto chega a uma Página do Facebook por POST /{page-id}/photos, com url apontando para uma imagem já publicada na internet ou com o arquivo anexado como dados de formulário multipart, e caption como texto. Várias fotos formam um único post quando cada uma é enviada com published definido como false e seus IDs vão para POST /{page-id}/feed em attached_media, como entradas media_fbid.
O easyCoexistence publica uma foto em uma Página do Facebook com publish_facebook_post a partir do Claude, do ChatGPT ou do seu próprio código, agora ou agendada até 90 dias à frente, uma foto por publicação; uma publicação com várias fotos é feita no Facebook ou no Meta Business Suite.
Maior arquivo de foto aceito pelo endpoint de fotos; a Meta sugere manter arquivos PNG abaixo de 1 MB para evitar pixelização.
Por quanto tempo fotos não publicadas permanecem nos servidores da Meta; as que não forem publicadas nesse prazo são excluídas.
Código de erro do endpoint de fotos para um arquivo de imagem ausente ou inválido.
Parâmetro para fotos em uma publicação agendada: published deve ser false, e a própria foto não recebe scheduled_publish_time.
Retornado junto com o id da foto quando ela é publicada: o ID do post da Página que a contém.
Como publicar uma foto em uma Página?
Envie POST /{page-id}/photos com url definido para uma foto já disponível na internet, ou anexe o arquivo como multipart/form-data, campo que historicamente se chama source. caption é o texto da foto e aceita emoji. A Meta responde com dois IDs: id, da foto, e post_id, do post da Página que a contém.
POST /{page-id}/photos
{
"url": "https://example.com/flyer.jpg",
"caption": "Doors open at 9 on Saturday."
}
200 OK
{
"id": "<PHOTO_ID>",
"post_id": "<PAGE_POST_ID>"
}Quais parâmetros de foto a Meta documenta?
Além de url e caption, a referência de fotos lista opções que definem como uma foto é publicada:
- published: true por padrão; false envia a foto sem publicá-la.
no_story: true suprime a história no feed que a Meta gera quando um app envia uma foto.alt_text_custom: uma descrição alternativa acessível da imagem.scheduled_publish_time: quando uma foto não publicada deve ir ao ar, somente em Páginas.- place: o ID de uma Página para a localização;
backdated_timedefine um horário de criação anterior. - message: marcado como obsoleto, com caption no seu lugar.
Quais arquivos de imagem a Meta aceita?
JPEG, BMP, PNG, GIF e TIFF, até 10 MB por arquivo. A Meta recomenda manter arquivos PNG abaixo de 1 MB, pois arquivos maiores podem ficar pixelizados. Antes de publicar, o Facebook remove os metadados de localização da imagem e a redimensiona para várias dimensões de exibição, e um arquivo ausente ou ilegível falha com o erro 324.
Como publicar várias fotos em um único post?
Em duas etapas. Envie cada foto para POST /{page-id}/photos com published definido como false, o que devolve seu ID sem publicar nada. Depois envie POST /{page-id}/feed com message e attached_media, um media_fbid por foto, e a Meta retorna o ID de um único post que mostra as fotos juntas. Fotos não publicadas permanecem nos servidores da Meta por cerca de 24 horas, então faça a chamada ao feed dentro desse prazo.
Como uma publicação com várias fotos é agendada?
Com o agendamento nativo da Meta. Envie as fotos com published definido como false e temporary definido como true, depois faça a chamada ao feed com published como false, scheduled_publish_time e unpublished_content_type definido como SCHEDULED. O guia de Páginas da Meta define o horário de publicação entre 10 minutos e 30 dias após a requisição, e a Meta mantém o post até lá.
O que publish_facebook_post recebe para uma foto?
account_id, image_url, um link HTTPS público para uma imagem, e message, o texto do post. Um post comporta uma imagem, e um link passado junto é recusado, então a URL vai na message. Sem scheduled_at, a foto sai imediatamente; com ele, de 1 minuto a 90 dias à frente em ISO 8601 com fuso horário, o easyCoexistence copia a imagem no momento do agendamento e a publica então. O limite de 10 MB do Facebook para uma foto continua valendo, embora a etapa de cópia aceite imagens de até 30 MB.
Como publicar várias fotos pelo easyCoexistence?
Ainda não é possível. publish_facebook_post recebe uma image_url, e o easyCoexistence não tem uma ferramenta para a chamada em duas etapas que a Meta documenta: um POST para <PAGE_ID>/photos por imagem, com url e published definido como false, e depois os IDs retornados publicados juntos em <PAGE_ID>/feed. Publique o álbum no Facebook ou no Meta Business Suite, ou publique as fotos como posts separados.
Erros comuns
- Publicar várias fotos uma chamada por vez. Com published mantido como true, cada chamada a /photos cria seu próprio post; envie-as sem publicar e anexe-as a um único post no feed.
- Esperar mais de um dia para anexar fotos não publicadas. A Meta as mantém por cerca de 24 horas e depois as exclui.
- Deixar temporary desligado em uma foto de post agendado. A Meta exige temporary como true, com published como false, nas fotos anexadas a um post agendado.
- Editar o id da foto em vez do post. O endpoint de fotos retorna id para a foto e post_id para o post; alterações no texto vão para o post_id.
De US$ 9 a US$ 0.75 por conexão por mês, com redução conforme você adiciona conexões, e os primeiros 3 dias são 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
Uma publicação de foto no Facebook pode ter texto alternativo?
Sim. alt_text_custom em /{page-id}/photos define uma descrição acessível da imagem. publish_facebook_post não recebe esse campo, então adicione a descrição no Facebook depois que a foto for publicada.
O Facebook mantém os dados de localização de uma foto?
Não. A Meta remove os metadados de localização antes de publicar; para mostrar um lugar, defina place como o ID de uma Página com essa localização.
Uma publicação com uma única foto pode ser agendada?
Sim. publish_facebook_post com scheduled_at a mantém na fila do easyCoexistence, de 1 minuto a 90 dias à frente. Do lado da Meta, published como false com scheduled_publish_time também a agenda.
Quanto custa o easyCoexistence para uma Página do Facebook?
Cada Página que você conecta é uma conexão, de US$ 9 a US$ 0.75 por conexão por mês conforme a quantidade que você tiver, e os primeiros 3 dias são grátis.
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