EntrarComeçar teste grátis
easyCoexistence APIs oficiais

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.

30 a day

Reels publicados pela API por Página em um período 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 em uma Página não pode passar de 60 segundos.

540 x 960

Resolução mínima do Reel; a Meta recomenda 1080 x 1920 pixels com 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 à frente, com video_state SCHEDULED.

1363128

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.

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 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.

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 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_url aceita 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.
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 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.
Fazendo isso com o EasyCoexistence

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