Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Publicar vídeos numa Página do Facebook através da API

Um vídeo chega a uma Página do Facebook através de POST /{page-id}/videos, com file_url, um URL que a Meta transfere por si própria, ou com um ficheiro que a aplicação carrega primeiro para a Meta. title dá nome ao vídeo, e description é o texto que a Meta pode mostrar com a publicação. Depois, a Meta processa o ficheiro, e GET /{video-id}?fields=status indica video_status como processing até mostrar ready.

A easyCoexistence publica vídeos em Páginas do Facebook com publish_facebook_post a partir do Claude, do ChatGPT ou do seu próprio código, já ou agendados até 90 dias à frente.

389

Código de erro quando a Meta não consegue obter o ficheiro de vídeo a partir do URL indicado em file_url.

382

Código de erro para um ficheiro de vídeo demasiado pequeno para carregar; a Meta pede um ficheiro maior.

10 min to 6 months

Janela para scheduled_publish_time na edge videos, contada a partir do momento em que o vídeo é publicado.

0 to 100

Intervalo de processing_progress, a parte do processamento do vídeo já concluída, indicada junto de video_status.

graph.facebook.com

Servidor para carregamentos de vídeo, segundo a visão geral da Video API da Meta, que marca graph-video.facebook.com como obsoleto para esse fim.

h

O identificador de ficheiro devolvido por um carregamento, passado a /{page-id}/videos como fbuploader_video_file_chunk para publicar o vídeo.

Como se publica um vídeo numa Página?

Com POST /{page-id}/videos e um token de acesso da Página. O ficheiro chega à Meta de duas formas: file_url, um URL acessível do vídeo que a Meta obtém por si própria, ou um carregamento, em que a aplicação envia primeiro os bytes. file_url não pode ser combinado com upload_phase, o parâmetro do carregamento por partes, pelo que um pedido usa uma forma ou outra.

file_urlUploaded file
Where the video isAt a URL Meta can reachOn your own system
On /{page-id}/videosfile_urlfbuploader_video_file_chunk with the upload's handle
Before publishingNothing: Meta fetches the fileAn upload session, then the bytes
If it failsError 389 when Meta cannot fetch itResume from the offset Meta reports

Como funciona o carregamento de um ficheiro que não está online?

O guia de publicação de vídeos da Meta usa a Resumable Upload API. POST /{app-id}/uploads, com file_name, file_length e file_type, abre uma sessão, e POST /upload:{session-id}, com um cabeçalho file_offset e os bytes, devolve um identificador, h. O vídeo é depois publicado com POST /{page-id}/videos e fbuploader_video_file_chunk definido com esse identificador, juntamente com title e description. Estes pedidos de carregamento usam um token de acesso de utilizador.

  • Um carregamento interrompido retoma a partir do file_offset que GET /upload:{session-id} devolve.
  • A referência de vídeos também documenta um carregamento por partes na mesma edge: upload_phase start, transfer e finish, com start_offset, file_size e video_file_chunk.

Para que servem title e description?

title é o título do vídeo. description é, nas palavras da Meta, o texto que descreve uma publicação que pode ser mostrada numa story sobre ela, por isso é aqui que vai o texto da publicação. Ambos são opcionais na edge videos, e publish_facebook_post envia a sua message como description e deixa title por definir.

Como se sabe quando o vídeo está pronto?

A Meta processa um vídeo depois de chegar. GET /{video-id}?fields=status devolve video_status, que indica processing enquanto a Meta trabalha, ready quando o vídeo está carregado, codificado e com as miniaturas, ou error se o processamento falhar, com processing_progress a indicar a parte concluída, de 0 a 100. A Meta pode também comunicar o estado de publicação através de webhooks da Página no campo videos, que a easyCoexistence não subscreve.

Qual o tamanho e a duração máximos do vídeo?

A referência de vídeos da Página e o guia de publicação da Meta não indicam tamanho nem duração máximos; a regra de tamanho que referem é o erro 382, para um ficheiro demasiado pequeno para carregar. Os guias de Reels e de Stories da Meta definem durações próprias: de 3 a 90 segundos para um Reel e, no máximo, 60 para um vídeo de story. Quando a easyCoexistence agenda um vídeo, copia o ficheiro nesse momento e recusa um com mais de 1 GB.

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

pages_manage_posts, pages_read_engagement e pages_show_list, com um token da Página de alguém que possa executar a tarefa CREATE_CONTENT, segundo a referência de vídeos e o guia de publicação. A visão geral da Video API da Meta é mais exigente: a pessoa deve poder executar tarefas equivalentes às de administrador na Página, ou ter uma função de Admin atribuída através do Business Manager.

Que erros pode devolver uma publicação de vídeo?

A referência de vídeos da Meta lista estes para POST /{page-id}/videos:

  • 389: não foi possível obter o ficheiro de vídeo a partir do URL.
  • 382: o ficheiro de vídeo é demasiado pequeno; volte a tentar com um ficheiro maior.
  • 6000: problema ao carregar o ficheiro de vídeo; volte a tentar com outro ficheiro.
  • 6001: problema ao carregar o vídeo; volte a tentar.
  • 368: a ação foi considerada abusiva ou está de outro modo não permitida.
  • 100: parâmetro inválido; 200: erro de permissões; 190: token de acesso OAuth 2.0 inválido.

Como publica publish_facebook_post um vídeo?

Recebe video_url, um URL HTTPS público para o ficheiro, e message, e envia-os para /{page-id}/videos como file_url e description, para que a Meta obtenha o vídeo por si própria. Uma publicação tem um só vídeo, e uma ligação enviada junto é recusada, por isso coloque o URL na message. O resultado post_id guarda o identificador devolvido pela Meta, que, no caso de um vídeo, é o próprio identificador do vídeo.

Como se agenda uma publicação de vídeo?

Indique a publish_facebook_post um scheduled_at em ISO 8601 com fuso horário, de 1 minuto a 90 dias à frente. A easyCoexistence copia o vídeo quando a publicação é agendada e publica-o na Página nesse momento; list_scheduled_posts mostra-a, update_scheduled_post move-a ou altera o texto, e cancel_scheduled_post cancela-a. O scheduled_publish_time próprio da edge videos da Meta permite de 10 minutos a 6 meses.

Erros comuns

  • Apontar file_url para um endereço que mostra o vídeo num leitor em vez do próprio ficheiro. A Meta obtém o endereço por si própria, e um que não consiga obter falha com o erro 389.
  • Carregar para graph-video.facebook.com. A visão geral da Video API da Meta marca esse servidor como obsoleto para vídeos e pede graph.facebook.com.
  • Anunciar o vídeo antes de estar pronto. Verifique o estado até video_status indicar ready, pois o processamento continua depois de a chamada de publicação devolver a resposta.
  • Enviar uma ligação junto com o vídeo. publish_facebook_post recusa uma ligação ao lado de um ficheiro; escreva o URL na message.
Fazer isto com a EasyCoexistence

A sua plataforma pode fazer o mesmo com POST /channels/:id/posts na Partner API. De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias gratuitos.

Perguntas frequentes

Posso carregar um vídeo do meu computador para uma Página do Facebook através da API?

Sim, através da Resumable Upload API da Meta, que devolve um identificador para /{page-id}/videos, ou do carregamento por partes nessa edge. publish_facebook_post recebe, em vez disso, um URL HTTPS público, por isso aloje primeiro o ficheiro.

Um vídeo pode ser carregado sem aparecer no feed da Página?

Sim. published definido como false retém a publicação, no_story suprime a story no feed e na cronologia, e secret mantém o vídeo fora do Facebook e das pesquisas.

Um mesmo vídeo pode ser publicado em várias Páginas?

Sim, por crosspost: um vídeo publicado pode sair em outras Páginas que a pessoa administra sem ser carregado de novo, e fica com um identificador de vídeo próprio em cada Página.

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

De US$ 9 a US$ 0.75 por ligação por mês, conforme o número total de ligações, com os primeiros 3 dias gratuitos. Cada Página é uma ligação.

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