EntrarComeçar teste grátis
easyCoexistence APIs oficiais

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.

10 MB

Maior arquivo de foto aceito pelo endpoint de fotos; a Meta sugere manter arquivos PNG abaixo de 1 MB para evitar pixelização.

About 24 hours

Por quanto tempo fotos não publicadas permanecem nos servidores da Meta; as que não forem publicadas nesse prazo são excluídas.

324

Código de erro do endpoint de fotos para um arquivo de imagem ausente ou inválido.

temporary

Parâmetro para fotos em uma publicação agendada: published deve ser false, e a própria foto não recebe scheduled_publish_time.

post_id

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.

Publishing a photo from a URL
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_time define 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.

1UploadPOST /{page-id}/photos with url and published false, once per photo
2CollectKeep the id each upload returns
3PostPOST /{page-id}/feed with message and attached_media
4ResultOne Page post ID for the photos together

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.
Fazendo isso com o EasyCoexistence

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