EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Stories de Página do Facebook pela API

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

O easyCoexistence publica os posts de uma Página do Facebook com publish_facebook_post a partir do Claude, do ChatGPT ou do seu próprio código: texto, links, fotos e vídeos.

60 seconds

Maior duração de Story de vídeo que a Meta permite em uma Página do Facebook.

10 MB

Maior arquivo de foto para um Story de foto, em JPEG, BMP, PNG, GIF ou TIFF.

9 x 16

Proporção do Story de vídeo, com 1080 x 1920 pixels recomendados e no mínimo 540 x 960.

PUBLISHED, ARCHIVED

Status que GET /{page-id}/stories informa; Stories arquivados aparecem apenas com o arquivo de Stories da Página ativado.

Como um Story de foto é publicado?

Em duas chamadas. Envie a foto para POST /{page-id}/photos com published definido como false, o que retorna 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 do Story.

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

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

Como um Story de vídeo é publicado?

Em três etapas, no mesmo formato de um Reel. POST /{page-id}/video_stories com upload_phase definido como start retorna um video_id e um upload_url em rupload.facebook.com. O vídeo é enviado para lá, como os bytes do arquivo com os cabeçalhos offset e file_size, ou como um cabeçalho file_url para um arquivo hospedado. Depois, POST /{page-id}/video_stories com o video_id e upload_phase definido como finish o publica e retorna 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

Quais mídias um Story pode usar?

A especificação de Stories da Meta traz uma especificação para foto e outra para vídeo. Fotos são arquivos .jpeg, .bmp, .png, .gif ou .tiff de até 10 MB, com PNG de preferência abaixo de 1 MB. Vídeos seguem a especificação de Reels, com um teto menor:

  • Arquivo: .mp4 recomendado, com proporção de 9 x 16.
  • Resolução: 1080 x 1920 pixels recomendados, no mínimo 540 x 960.
  • Taxa de quadros: de 24 a 60 quadros por segundo, fixa, com varredura progressiva.
  • Duração: no máximo 60 segundos para um 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.

Quais mídias não podem ser usadas em um Story?

Foto ou vídeo já usado em uma publicação anterior: a regra da Meta é que a mídia enviada para um Story não pode ter sido usada antes. Um vídeo hospedado também precisa estar acessível, pois a Meta rejeita arquivos em sites cujo robots.txt bloqueia o user agent facebookexternalhit/1.1, e arquivos da própria CDN, como URLs fbcdn.

Como listar os Stories de uma Página?

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

  • post_id: o ID da publicação do Story.
  • status: PUBLISHED ou ARCHIVED; Stories arquivados exigem o arquivo de Stories da Página ativado.
  • creation_time: o timestamp UNIX de quando o Story foi publicado.
  • media_type e media_id: foto ou vídeo, e o ID dessa mídia.
  • url: o endereço do Story no Facebook, em facebook.com/stories/.

Quais permissões são necessárias?

Um token de Página de alguém que pode executar a tarefa CREATE_CONTENT na Página, por meio de Facebook Login ou Facebook Login for Business, com pages_manage_posts, pages_read_engagement e pages_show_list concedidas. Requisições feitas como usuário de sistema de negócios também precisam de business_management. São as mesmas três permissões que a publicação no feed da Página exige.

Quando um Story vai ao ar?

Quando a chamada photo_stories ou a chamada finish de video_stories é feita. A API de Stories da Meta não aceita horário 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. Um Story para depois precisa de uma chamada feita naquele momento, a partir de um agendador próprio.

Como publicar um Story pelo easyCoexistence?

Ainda não é possível. publish_facebook_post publica posts, não Stories, e o easyCoexistence não tem ferramenta para photo_stories nem para video_stories; os tokens de Página não são fornecidos, então as chamadas também não podem ser feitas a partir do seu próprio código nessa conexão. Publique os Stories no Facebook ou no Meta Business Suite.

Erros comuns

  • Reaproveitar uma foto de uma publicação anterior. A mídia de um Story não pode vir de uma publicação já feita, então envie-a de novo com published definido como false.
  • Transformar um Reel de 90 segundos em Story. Reels podem ter até 90 segundos, mas um Story de vídeo para em 60.
  • Esperar Stories arquivados na lista. Eles aparecem em GET /{page-id}/stories apenas 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 status continuam em graph.facebook.com.
Fazendo isso com o EasyCoexistence

Ele não tem ferramenta para a API de Stories, então os Stories são publicados no Facebook ou no Meta Business Suite. 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 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

Um Reel pode ser compartilhado como Story de Página do Facebook?

Sim, se tiver 60 segundos ou menos: a especificação da Meta diz que um Reel publicado como Story em uma Página não pode passar disso.

Um Story de vídeo pode ser marcado como feito com IA?

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

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

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

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

De US$ 9 a US$ 0.75 por conexão por mês, com os primeiros 3 dias grátis. Cada Página é uma conexão, e o preço por conexão cai conforme você adiciona mais.

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