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.
Reels publicados através da API por Página, numa janela móvel de 24 horas, aplicado em POST /{page_id}/video_reels.
Duração de Reel que a Meta aceita; um Reel publicado como story numa Página não pode exceder 60 segundos.
Resolução mínima do Reel; a Meta recomenda 1080 x 1920 pixels com uma proporção de 9 x 16.
Data mais distante que scheduled_publish_time pode definir para um Reel, com pelo menos 10 minutos de antecedência e video_state SCHEDULED.
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.
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.
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_urlaceita 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.
# <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.
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