EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Publicar vídeos em uma Página do Facebook pela API

Um vídeo chega a uma Página do Facebook por POST /{page-id}/videos, seja com file_url, uma URL que a própria Meta baixa, seja com um arquivo que o app envia antes para a Meta. title nomeia o vídeo, e description é o texto que a Meta pode exibir junto da publicação. Em seguida a Meta processa o arquivo, e GET /{video-id}?fields=status informa video_status como processing até mostrar ready.

O 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, agora ou agendado com até 90 dias de antecedência.

389

Código de erro quando a Meta não consegue buscar o arquivo de vídeo na URL informada em file_url.

382

Código de erro para um arquivo de vídeo pequeno demais para envio; a Meta pede um arquivo maior.

10 min to 6 months

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

0 to 100

Faixa de processing_progress, a parcela do processamento do vídeo concluída, informada ao lado de video_status.

graph.facebook.com

Host para envio de vídeos, segundo a visão geral da Video API da Meta, que marca graph-video.facebook.com como descontinuado para isso.

h

O identificador de arquivo que um envio retorna, passado a /{page-id}/videos como fbuploader_video_file_chunk para publicar o vídeo.

Como um vídeo é publicado em uma Página?

Com POST /{page-id}/videos e um token de acesso da Página. O arquivo chega à Meta de duas formas: file_url, uma URL acessível do vídeo que a própria Meta busca, ou um upload, em que o app envia os bytes antes. file_url não pode ser combinado com upload_phase, o parâmetro do upload em partes, então uma requisição usa uma forma ou a 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 upload de um arquivo que não está online?

O guia de publicação de vídeo 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 retorna um identificador, h. O vídeo é então publicado com POST /{page-id}/videos e fbuploader_video_file_chunk definido com esse identificador, junto de title e description. Essas chamadas de upload usam um token de acesso de usuário.

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

O que title e description fazem?

title é o título do vídeo. description é, nas palavras da Meta, o texto que descreve uma publicação e que pode ser exibido em um story sobre ela, então é ali que vai o texto da publicação. Ambos são opcionais na edge de vídeos, e publish_facebook_post envia sua mensagem como description e deixa title sem definir.

Como saber quando o vídeo está pronto?

A Meta processa um vídeo depois que ele chega. GET /{video-id}?fields=status retorna video_status, que mostra processing enquanto a Meta trabalha, ready quando o vídeo foi enviado, codificado e tem suas miniaturas, ou error se o processamento falhou, com processing_progress indicando a parcela concluída de 0 a 100. A Meta também pode informar o status de publicação por webhooks de Página no campo videos, que o easyCoexistence não assina.

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 informam tamanho máximo de arquivo nem duração; a regra de tamanho que citam é o erro 382, para um arquivo pequeno demais para envio. Os guias de Reels e Stories da Meta definem durações próprias: de 3 a 90 segundos para um Reel e no máximo 60 para um story em vídeo. Quando o easyCoexistence agenda um vídeo, ele copia o arquivo naquele momento e recusa um acima de 1 GB.

Quais 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 emitido para 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 estrita: a pessoa deve poder executar tarefas equivalentes às de administrador na Página, ou ter um papel de Admin concedido pelo Business Manager.

Quais erros uma publicação de vídeo pode retornar?

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

  • 389: não foi possível buscar o arquivo de vídeo na URL.
  • 382: o arquivo de vídeo é pequeno demais; repita com um arquivo maior.
  • 6000: problema ao enviar o arquivo de vídeo; repita com outro arquivo.
  • 6001: problema ao enviar o vídeo; repita.
  • 368: a ação foi considerada abusiva ou é de outra forma não permitida.
  • 100: parâmetro inválido; 200: erro de permissão; 190: token de acesso OAuth 2.0 inválido.

Como publish_facebook_post publica um vídeo?

Ele recebe video_url, um link HTTPS público para o arquivo, e message, e os envia para /{page-id}/videos como file_url e description, para que a Meta busque o vídeo por conta própria. Uma publicação tem um vídeo, e um link enviado junto dele é recusado, então coloque a URL na mensagem. O post_id do resultado guarda o ID devolvido pela Meta, que para um vídeo é o próprio ID do vídeo.

Como agendar a publicação de um vídeo?

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

Erros comuns

  • Apontar file_url para uma página que reproduz o vídeo, e não para o arquivo. A Meta baixa o endereço por conta própria, e um endereço que ela não consegue buscar falha com o erro 389.
  • Enviar para graph-video.facebook.com. A visão geral da Video API da Meta marca esse host como descontinuado para envio de vídeos e pede graph.facebook.com.
  • Anunciar o vídeo antes de ele estar pronto. Verifique o status até que video_status mostre ready, pois o processamento continua depois que a chamada de publicação retorna.
  • Enviar um link junto do vídeo. publish_facebook_post recusa um link ao lado de um arquivo; escreva a URL na mensagem.
Fazendo isso com o EasyCoexistence

Sua plataforma pode fazer o mesmo com POST /channels/:id/posts na Partner API. De US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, e 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

Posso enviar um vídeo do meu computador para uma Página do Facebook pela API?

Sim, pela Resumable Upload API da Meta, que retorna um identificador para /{page-id}/videos, ou pelo upload em partes nessa edge. publish_facebook_post recebe uma URL HTTPS pública, então hospede o arquivo primeiro.

Dá para enviar um vídeo sem que ele apareça no feed da Página?

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

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

Sim, por crosspost: um vídeo publicado pode ir para outras Páginas que a pessoa administra sem ser enviado de novo, e recebe seu próprio ID de vídeo em cada Página.

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

De US$ 9 a US$ 0.75 por conexão por mês, definido pelo total de conexões, com os 3 primeiros dias grátis. Cada Página é uma conexão.

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