Facebook Reels API: publicando Reels em uma Página
A Facebook Reels API publica um Reel em uma Página em três etapas: POST /{page-id}/video_reels com upload_phase start retorna um video_id, o vídeo vai para rupload.facebook.com, e POST /{page-id}/video_reels com upload_phase finish e video_state PUBLISHED o publica. A especificação da Meta é um vídeo 9:16 de 3 a 90 segundos, e uma Página pode publicar 30 Reels pela API em 24 horas.
O easyCoexistence publica vídeos em uma Página do Facebook como publicações de vídeo comuns com publish_facebook_post, a partir do Claude, do ChatGPT ou do seu próprio código, ao lado de texto, links e fotos.
Reels publicados pela API por Página em um período 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 em uma Página não pode passar de 60 segundos.
Resolução mínima do Reel; a Meta recomenda 1080 x 1920 pixels com proporção de 9 x 16.
Data mais distante que scheduled_publish_time pode definir para um Reel, com pelo menos 10 minutos à frente, com video_state SCHEDULED.
Código de erro para um Reel cuja duração o Facebook não aceita; Reels precisam durar de 3 a 90 segundos.
Como a Reels API publica um Reel?
Em três etapas, em dois hosts. As chamadas de início e finalização vão para a edge video_reels da Página em graph.facebook.com, enquanto o vídeo em si vai para rupload.facebook.com, na upload_url que a chamada de início retorna. Uma verificação de status no ID do vídeo entre o envio e a finalização mostra se a Meta tem o arquivo inteiro e se já o processou.
Que vídeo um Reel precisa?
A Meta publica suas especificações de Reels no guia Reels Publishing, e um envio que não atenda a elas em proporção, resolução, duração ou taxa de quadros é recusado com um código de erro próprio. Um Reel destinado a story de uma Página também precisa ter no máximo 60 segundos.
Como o vídeo é enviado?
Com um POST para a upload_url em rupload.facebook.com, levando o token da Página no cabeçalho Authorization: OAuth. Um arquivo no seu computador vai como corpo da requisição, com o cabeçalho offset definido como 0 e file_size definido com seu tamanho em bytes. Um arquivo já online vai como cabeçalho file_url, e a Meta o busca; um envio bem-sucedido retorna success como true.
file_urlaceita endereços http ou https; URLs que exigem autenticação não são suportadas.- O host precisa permitir que o user agent facebookexternalhit/1.1 busque o arquivo, já que a Meta rejeita arquivos de sites que o bloqueiam no robots.txt.
- Arquivos da própria CDN da Meta, como URLs fbcdn, são rejeitados; a Meta indica o crossposting para reaproveitar um vídeo em outra 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 você verifica o status de um Reel?
Com GET /{video-id}?fields=status em graph.facebook.com. A resposta traz video_status, que pode ser uploading, upload_complete, processing, ready, upload_failed, expired ou error, e um objeto por fase: uploading_phase com bytes_transfered, processing_phase com eventual mensagem de erro, e publishing_phase com publish_status (draft, scheduled, published ou error) e publish_time. O status de cada fase é not_started, in_progress, completed ou error.
Como um envio interrompido é retomado?
Enviando de novo o POST de envio com o cabeçalho offset definido como uploading_phase.bytes_transfered de uma verificação de status, ou seja, os bytes que a Meta já tem. Um offset que a Meta não aceita retorna OffsetInvalidError, um corpo que não corresponde ao tamanho do arquivo retorna PartialRequestError, e quando reenviar não funciona, a orientação da Meta é recomeçar desde o primeiro passo.
O que a chamada de finalização recebe?
O video_id da chamada de início, upload_phase definido como finish e video_state definido como PUBLISHED, DRAFT ou SCHEDULED. description traz o texto e aceita hashtags. title e place (para uma Página com localização) e is_ai_generated, que informa 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 no máximo 29 dias à frente. A Meta responde com success como true.
Quantos Reels uma Página pode publicar pela API?
30 em um período móvel de 24 horas. A Meta aplica o limite em POST /{page_id}/video_reels no momento da publicação e recomenda que os apps também o apliquem, sobretudo os que permitem agendar publicações para depois. Convites de 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, chamadas para esta API excederam o limite de taxa.
Quais permissões e tarefa de Página são necessárias?
Um token de acesso de 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 pelo Facebook Login. A Meta também pede que os apps mostrem à pessoa uma divulgação de como seus Reels são usados no Facebook, com opções para controlá-la, e que ofereçam apenas o público Public, já que publicar em uma Página tem escopo público implícito.
Quais erros a Reels API retorna?
O código 100 significa que um parâmetro obrigatório está faltando, como upload_phase, e a mensagem da Meta lista os que faltam. Outros quatro códigos recusam um vídeo fora das especificações:
- 1363040: a proporção não é suportada; os vídeos precisam 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; Reels precisam durar de 3 a 90 segundos.
- 1363129: a taxa média de quadros não é suportada; Reels precisam de 24 a 60 quadros por segundo.
Como você lista os Reels de uma Página?
Com GET /{page-id}/video_reels, que retorna os Reels publicados da Página com seus IDs, datas de atualização e descrições. since e until restringem a lista a datas informadas como today, yesterday, um timestamp UNIX ou yyyy-mm-dd, com until posterior a since. A referência de feed da Meta aponta para esta edge para os Reels publicados em uma Página.
Como publicar um Reel pelo easyCoexistence?
Não como Reel, hoje. publish_facebook_post envia vídeos para a edge videos da Página, como publicações de vídeo comuns, e o easyCoexistence não tem ferramenta para as chamadas video_reels; tokens de Página não são entregues, então as três etapas também não podem rodar no seu próprio código pela conexão dele. Publique o Reel pelo Facebook ou pelo Meta Business Suite, ou publique o vídeo como uma publicação de vídeo comum.
Erros comuns
- Enviar o arquivo para graph.facebook.com. O vídeo vai para rupload.facebook.com com um cabeçalho Authorization: OAuth; só as chamadas de início, finalização e status usam graph.facebook.com.
- Hospedar o arquivo onde a Meta não consegue buscá-lo. Um file_url atrás de login, em um site cujo robots.txt bloqueia facebookexternalhit/1.1 ou em fbcdn é rejeitado.
- Recomeçar após um envio interrompido. Consulte o status primeiro: uploading_phase.bytes_transfered é o offset de onde retomar, e uma nova sessão é a última opção.
- Colocar na fila mais de 30 Reels para uma Página em um dia. A Meta conta os Reels publicados pela API em um período móvel de 24 horas, então espalhe os agendados.
Ele não tem ferramenta para a Reels API, então um Reel é publicado pelo Facebook ou pelo Meta Business Suite. De US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os 3 primeiros 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
Dá para publicar um Reel em um perfil ou grupo do Facebook pela API?
Não. A API de publicação de Reels da Meta publica Reels em Páginas do Facebook, e faz crossposting deles apenas para Páginas.
publish_facebook_post publica Reels?
Não. Ele publica texto, links, fotos e vídeos na Página. Um Reel usa as chamadas video_reels, que as ferramentas do easyCoexistence não fazem.
Como verifico um Reel quanto a correspondências de direitos autorais?
Consulte GET /{video-id}?fields=copyright_check_information com pages_read_engagement. A Meta roda a verificação no envio, ela pode levar alguns minutos, e só o dono vê as correspondências.
Outra Página pode publicar meu Reel também?
Sim, como colaborador. POST /{video-id}/collaborators com target_id definido como o ID da Página dele envia um convite, e quando ele aceita, o Reel aparece também na Página dele.
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