Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

API de Reels do Facebook: publicar Reels numa Página

A API de Reels do Facebook publica um Reel numa Página em três passos: POST /{page-id}/video_reels com upload_phase start devolve um video_id, o vídeo é enviado para rupload.facebook.com, e POST /{page-id}/video_reels com upload_phase finish e video_state PUBLISHED publica-o. A especificação da Meta exige um vídeo na proporção 9:16 com 3 a 90 segundos, e uma Página pode publicar 30 Reels através da API em 24 horas.

A easyCoexistence publica vídeos numa Página do Facebook como publicações de vídeo normais com publish_facebook_post, a partir do Claude, do ChatGPT ou do seu próprio código, junto com texto, hiperligações e fotografias.

30 a day

Reels publicados através da API por Página, numa janela móvel de 24 horas, aplicado em POST /{page_id}/video_reels.

3 to 90 s

Duração de Reel que a Meta aceita; um Reel publicado como story numa Página não pode exceder 60 segundos.

540 x 960

Resolução mínima do Reel; a Meta recomenda 1080 x 1920 pixels com uma proporção de 9 x 16.

29 days

Data mais distante que scheduled_publish_time pode definir para um Reel, com pelo menos 10 minutos de antecedência e video_state SCHEDULED.

1363128

Código de erro para um Reel cuja duração o Facebook não suporta; os Reels têm de durar entre 3 e 90 segundos.

Como é que a API de Reels publica um Reel?

Em três passos, através de dois domínios. As chamadas de início e de conclusão vão para o endpoint video_reels da Página em graph.facebook.com, enquanto o vídeo em si vai para rupload.facebook.com, para o upload_url que a chamada de início devolve. Uma verificação do estado do ID do vídeo entre o envio e a conclusão mostra se a Meta tem o ficheiro completo e se o processou.

1StartPOST /{page-id}/video_reels, upload_phase start: returns video_id and upload_url
2UploadPOST to rupload.facebook.com with the bytes or a file_url header
3CheckGET /{video-id}?fields=status until processing completes
4FinishPOST /{page-id}/video_reels, upload_phase finish, video_state PUBLISHED

Que vídeo é necessário para um Reel?

A Meta publica as suas especificações de Reels no guia de publicação de Reels, e um envio que não cumpra a proporção, a resolução, a duração ou a taxa de fotogramas é recusado com um código de erro próprio. Um Reel destinado a um story de Página também tem de manter-se dentro de 60 segundos.

File.mp4 recommended
Aspect ratio9 x 16
Resolution1080 x 1920 recommended, 540 x 960 at least
Frame rate24 to 60 fps, fixed, progressive scan
Duration3 to 90 seconds
VideoH.264 or H.265 (VP9 and AV1 also supported), 4:2:0, closed GOP of 2 to 5 s
AudioAAC Low Complexity, 48 kHz, stereo, 128 kbps or more

Como é que o vídeo é enviado?

Com um POST para o upload_url em rupload.facebook.com, com o token da Página no cabeçalho Authorization: OAuth. Um ficheiro no seu computador segue como corpo do pedido, com o cabeçalho offset definido como 0 e file_size definido com o seu tamanho em bytes. Um ficheiro já online segue, em vez disso, num cabeçalho file_url, e a Meta vai buscá-lo; um envio bem-sucedido devolve success com o valor true.

  • file_url aceita endereços http ou https; URLs que exigem autenticação não são suportadas.
  • O sítio tem de permitir que o agente de utilizador facebookexternalhit/1.1 obtenha o ficheiro, pois a Meta rejeita ficheiros em sítios que o bloqueiam no robots.txt.
  • Ficheiros no CDN da Meta, como URLs fbcdn, são rejeitados; a Meta aponta para a publicação cruzada para reutilizar um vídeo noutra Página.
Uploading a hosted video
# <UPLOAD_URL> is the upload_url the start call returned
curl -X POST "<UPLOAD_URL>" \
  -H "Authorization: OAuth <PAGE_ACCESS_TOKEN>" \
  -H "file_url: https://example.com/reel.mp4"

Como se verifica o estado de um Reel?

Com GET /{video-id}?fields=status em graph.facebook.com. A resposta inclui video_status, que indica uploading, upload_complete, processing, ready, upload_failed, expired ou error, e um objeto por fase: uploading_phase com bytes_transfered, processing_phase com qualquer mensagem de erro, e publishing_phase com publish_status (draft, scheduled, published ou error) e publish_time. O estado de cada fase é not_started, in_progress, completed ou error.

Como se retoma um envio interrompido?

Ao enviar de novo o POST de envio com o cabeçalho offset definido como uploading_phase.bytes_transfered de uma verificação do estado, ou seja, os bytes que a Meta já tem. Um offset que a Meta não aceita devolve OffsetInvalidError, um corpo cujo comprimento não corresponde ao do ficheiro devolve PartialRequestError, e quando voltar a enviar não resulta, a recomendação da Meta é recomeçar desde o primeiro passo.

O que recebe a chamada de conclusão?

O video_id da chamada de início, upload_phase definido como finish e video_state definido como PUBLISHED, DRAFT ou SCHEDULED. description transporta o texto e aceita hashtags. title, place para uma Página de localização e is_ai_generated, que divulga que o Reel foi criado ou editado com IA, são opcionais. Um Reel agendado acrescenta scheduled_publish_time, um timestamp UNIX com mais de 10 minutos e até 29 dias de antecedência. A Meta responde com success definido como true.

Quantos Reels pode uma Página publicar através da API?

30 numa janela móvel de 24 horas. A Meta aplica o limite em POST /{page_id}/video_reels quando um Reel é publicado e recomenda que as aplicações o apliquem também por si próprias, sobretudo as que permitem às pessoas agendar publicações para mais tarde. Os convites a colaboradores têm um limite próprio, de 10 por Página em 24 horas, e a referência de video_reels lista o erro 613, as chamadas a esta API excederam o limite de pedidos.

Que permissões e tarefa de Página são necessárias?

Um token de acesso à Página de alguém que possa executar a tarefa CREATE_CONTENT na Página, com pages_show_list, pages_read_engagement e pages_manage_posts concedidas através do Facebook Login. A Meta pede também às aplicações que mostrem à pessoa uma divulgação de como os seus Reels são usados no Facebook, com opções para o controlar, e que ofereçam apenas a audiência «Público», já que a publicação numa Página tem âmbito público implícito.

Que erros devolve a API de Reels?

O código 100 indica que falta um parâmetro obrigatório, como upload_phase, e a mensagem da Meta lista os que faltam. Mais quatro códigos recusam um vídeo fora das especificações:

  • 1363040: a proporção não é suportada; os vídeos têm de estar entre 16x9 e 9x16.
  • 1363127: a resolução não é suportada; o mínimo é 540 x 960 pixels.
  • 1363128: a duração não é suportada; os Reels têm de durar de 3 a 90 segundos.
  • 1363129: a taxa média de fotogramas não é suportada; os Reels precisam de 24 a 60 fotogramas por segundo.

Como se listam os Reels de uma Página?

Com GET /{page-id}/video_reels, que devolve os Reels publicados da Página com os seus IDs, datas de atualização e descrições. since e until limitam a lista a datas indicadas como today, yesterday, um timestamp UNIX ou yyyy-mm-dd, com until posterior a since. A referência de feed da Meta aponta para este endpoint para os Reels publicados numa Página.

Como se publica um Reel através da easyCoexistence?

Não como Reel, por agora. publish_facebook_post envia os vídeos para o endpoint videos da Página, como publicações de vídeo normais, e a easyCoexistence não tem ferramenta para as chamadas de video_reels; os tokens da Página não são entregues, por isso os três passos também não podem ser executados a partir do seu próprio código na sua ligação. Publique o Reel a partir do Facebook ou do Meta Business Suite, ou publique o vídeo como publicação de vídeo normal.

Erros comuns

  • Enviar o vídeo para graph.facebook.com. O vídeo vai para rupload.facebook.com com um cabeçalho Authorization: OAuth; só as chamadas de início, conclusão e verificação do estado usam graph.facebook.com.
  • Alojar o ficheiro onde a Meta não o consegue obter. Um file_url protegido por início de sessão, num sítio cujo robots.txt bloqueia facebookexternalhit/1.1, ou em fbcdn, é rejeitado.
  • Recomeçar após um envio interrompido. Verifique primeiro o estado: uploading_phase.bytes_transfered é o offset a partir do qual retomar, e uma nova sessão é o último recurso.
  • Pôr em fila mais de 30 Reels para uma Página num dia. A Meta conta os Reels publicados pela API numa janela móvel de 24 horas, por isso distribua os agendados.
Fazer isto com a EasyCoexistence

Não tem ferramenta para a API de Reels, por isso um Reel é publicado a partir do Facebook ou do Meta Business Suite. De US$ 9 a US$ 0.75 por número ligado por mês, descendo à medida que acrescenta números, com os primeiros 3 dias grátis.

Perguntas frequentes

Pode um Reel ser publicado num perfil ou grupo do Facebook através da API?

Não. A API de publicação de Reels da Meta publica Reels em Páginas do Facebook, e só os partilha por publicação cruzada com outras Páginas.

A função publish_facebook_post publica Reels?

Não. Publica texto, hiperligações, fotografias e vídeos na Página. Um Reel usa as chamadas de video_reels, que as ferramentas da easyCoexistence não fazem.

Como posso verificar um Reel quanto a correspondências de direitos de autor?

Consulte GET /{video-id}?fields=copyright_check_information com pages_read_engagement. A Meta faz a verificação no envio, pode demorar alguns minutos, e só o proprietário vê as correspondências.

Pode outra Página publicar também o meu Reel?

Sim, como colaboradora. POST /{video-id}/collaborators com target_id definido como o ID da outra Página envia um convite, e, quando este for aceite, o Reel aparece também nessa Página.

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