Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Stories de Páginas do Facebook através da API

A API de Stories da Meta publica Stories de foto e vídeo numa Página do Facebook. Uma Story de foto usa uma foto enviada com published definido como false e depois POST /{page-id}/photo_stories com o seu photo_id; uma Story de vídeo passa pelas chamadas start, upload e finish em /{page-id}/video_stories. As Stories de vídeo podem ter até 60 segundos, e as fotos até 10 MB.

A easyCoexistence publica as publicações de uma Página do Facebook com publish_facebook_post a partir do Claude, do ChatGPT ou do seu próprio código: texto, ligações, fotos e vídeos.

60 seconds

Duração máxima de uma Story de vídeo que a Meta permite numa Página do Facebook.

10 MB

Maior ficheiro de foto para uma Story de foto, em JPEG, BMP, PNG, GIF ou TIFF.

9 x 16

Proporção de uma Story de vídeo, com 1080 x 1920 pixels recomendados e pelo menos 540 x 960.

PUBLISHED, ARCHIVED

Estados que GET /{page-id}/stories devolve; as Stories arquivadas só aparecem com o arquivo de Stories da Página ativado.

Como se publica uma Story de foto?

Em duas chamadas. Carregue a foto para POST /{page-id}/photos com published definido como false, o que devolve o ID da foto, e depois envie POST /{page-id}/photo_stories com photo_id definido com esse ID. A Meta responde com success definido como true e post_id, o ID da publicação da Story.

Publishing a photo story
POST /{page-id}/photo_stories
{
  "photo_id": "<PHOTO_ID>"
}

200 OK
{
  "success": true,
  "post_id": "<STORY_POST_ID>"
}

Como se publica uma Story de vídeo?

Em três passos, da mesma forma que um Reel. POST /{page-id}/video_stories com upload_phase definido como start devolve um video_id e um upload_url em rupload.facebook.com. O vídeo é enviado para lá, como os bytes do ficheiro com os cabeçalhos offset e file_size, ou como cabeçalho file_url para um ficheiro alojado. Depois, POST /{page-id}/video_stories com o video_id e upload_phase definido como finish publica-o e devolve post_id.

1StartPOST /{page-id}/video_stories, upload_phase start
2UploadThe bytes or a file_url, sent to the upload_url
3StatusGET /{video-id}?fields=status
4Finishupload_phase finish with video_id: returns post_id

Que conteúdo multimédia pode usar uma Story?

A especificação de Stories da Meta tem uma parte para fotos e outra para vídeos. As fotos são ficheiros .jpeg, .bmp, .png, .gif ou .tiff até 10 MB, sendo preferível manter os PNG abaixo de 1 MB. Os vídeos seguem a especificação dos Reels, com um limite mais curto:

  • Ficheiro: .mp4 recomendado, com proporção de 9 x 16.
  • Resolução: 1080 x 1920 pixels recomendados, pelo menos 540 x 960.
  • Taxa de imagens: de 24 a 60 fotogramas por segundo, fixa, com varrimento progressivo.
  • Duração: no máximo 60 segundos numa Story de vídeo.
  • Codecs: H.264 ou H.265, com VP9 e AV1 também suportados; áudio em AAC Low Complexity a 48 kHz, estéreo, 128 kbps ou mais.

Que conteúdo multimédia não pode ser usado numa Story?

Uma foto ou um vídeo já usado numa publicação anterior: a regra da Meta é que o conteúdo enviado para uma Story não pode ter sido usado antes. Um vídeo alojado também tem de estar acessível, porque a Meta rejeita ficheiros em sites cujo robots.txt bloqueia o user agent facebookexternalhit/1.1, e ficheiros na sua própria CDN, como URLs fbcdn.

Como se listam as Stories de uma Página?

GET /{page-id}/stories devolve um objeto por Story, e a lista pode ser filtrada por estado ou por data com since e until. Cada objeto contém:

  • post_id: o ID da publicação da Story.
  • status: PUBLISHED ou ARCHIVED; as Stories arquivadas exigem o arquivo de Stories da Página ativado.
  • creation_time: o timestamp UNIX de quando a Story foi publicada.
  • media_type e media_id: foto ou vídeo, e o ID desse conteúdo.
  • url: o endereço da Story no Facebook, em facebook.com/stories/.

Que permissões são necessárias?

Um token de Página de alguém que possa executar a tarefa CREATE_CONTENT na Página, através do Facebook Login ou do Facebook Login for Business, com pages_manage_posts, pages_read_engagement e pages_show_list concedidas. Os pedidos feitos como utilizador de sistema da empresa também precisam de business_management. São as mesmas três permissões que a publicação no feed da Página pede.

Quando é que a Story é publicada?

Quando é feita a chamada photo_stories ou a chamada finish de video_stories. A API de Stories da Meta não aceita hora de publicação: photo_stories recebe um photo_id, e a chamada finish recebe video_id, upload_phase e a flag opcional is_ai_generated. Uma Story para mais tarde precisa de uma chamada feita nesse momento, a partir de um agendador próprio.

Como se publica uma Story através da easyCoexistence?

Ainda não é possível. publish_facebook_post publica publicações, e não Stories, e a easyCoexistence não tem nenhuma tool para photo_stories nem para video_stories; os tokens de Página não são entregues, por isso as chamadas também não podem ser feitas a partir do seu próprio código na ligação dela. Publique os Stories no Facebook ou no Meta Business Suite.

Erros comuns

  • Reutilizar uma foto de uma publicação anterior. O conteúdo de uma Story não pode vir de uma publicação já publicada, por isso carregue-o de novo com published definido como false.
  • Transformar um Reel de 90 segundos numa Story. Os Reels podem ter até 90 segundos, mas uma Story de vídeo acaba nos 60.
  • Esperar encontrar Stories arquivadas na lista. Estas só aparecem em GET /{page-id}/stories quando o arquivo de Stories da Página está ativado.
  • Enviar o vídeo para graph.facebook.com. O upload pertence ao upload_url em rupload.facebook.com; as chamadas start, finish e de estado continuam em graph.facebook.com.
Fazer isto com a EasyCoexistence

Não tem nenhuma tool para a API de Stories, por isso os Stories publicam-se no Facebook ou no Meta Business Suite. US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que acrescenta ligações, e os primeiros 3 dias grátis.

Perguntas frequentes

Um Reel pode ser partilhado como Story numa Página do Facebook?

Sim, se tiver 60 segundos ou menos: a especificação da Meta diz que um Reel publicado como Story numa Página não pode exceder esse limite.

Uma Story de vídeo pode ser identificada como feita com IA?

Sim. Defina is_ai_generated como true na chamada finish de video_stories; o valor por omissão é false.

E se o upload do vídeo de uma Story for interrompido?

Envie o upload de novo com offset definido como 0 para recomeçar, ou com offset definido com o valor bytes_transfered de uma verificação de estado para retomar.

Quanto custa a easyCoexistence para uma Página do Facebook?

US$ 9 a US$ 0.75 por ligação por mês, com os primeiros 3 dias grátis. Cada Página é uma ligação, e o preço por ligação desce à medida que adiciona mais.

Continue a ler

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorizado 24/7

Verificado em