Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Publicar videos en una Página de Facebook mediante la API

Un video llega a una Página de Facebook mediante POST /{page-id}/videos, con file_url, una URL que Meta descarga directamente, o con un archivo que la app sube primero a Meta. title nombra el video, y description es el texto que Meta puede mostrar con la publicación. Luego Meta procesa el archivo, y GET /{video-id}?fields=status muestra video_status como processing hasta que cambia a ready.

easyCoexistence publica videos en Páginas de Facebook con publish_facebook_post desde Claude, ChatGPT o tu propio código, ahora o programados con hasta 90 días de antelación.

389

Código de error cuando Meta no puede obtener el archivo de video desde la URL indicada en file_url.

382

Código de error para un archivo de video demasiado pequeño para subirlo; Meta pide un archivo más grande.

10 min to 6 months

Ventana para scheduled_publish_time en el edge de videos, contada desde el momento en que el video se publica.

0 to 100

Rango de processing_progress, la proporción del procesamiento del video que está completada, que se informa junto a video_status.

graph.facebook.com

Host para subidas de video, según la descripción general de la API de Video de Meta, que marca graph-video.facebook.com como obsoleto para ellas.

h

El identificador de archivo que devuelve una subida, que se pasa a /{page-id}/videos como fbuploader_video_file_chunk para publicar el video.

¿Cómo se publica un video en una Página?

Con POST /{page-id}/videos y un token de acceso de la Página. El archivo llega a Meta de dos maneras: file_url, una URL accesible del video que Meta descarga directamente, o una subida, en la que la app envía primero los bytes. file_url no se puede combinar con upload_phase, el parámetro de la subida fragmentada, así que una petición usa una vía u otra.

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

¿Cómo funciona la subida de un archivo que no está en línea?

La guía de publicación de video de Meta usa la API de Subida Reanudable. POST /{app-id}/uploads con file_name, file_length y file_type abre una sesión, y POST /upload:{session-id} con un encabezado file_offset y los bytes devuelve un identificador, h. Luego el video se publica con POST /{page-id}/videos y fbuploader_video_file_chunk con ese identificador, junto con title y description. Estas llamadas de subida usan un token de acceso de usuario.

  • Una subida interrumpida se reanuda desde el file_offset que devuelve GET /upload:{session-id}.
  • La referencia de videos también documenta una subida fragmentada en el mismo edge: upload_phase start, transfer y finish, con start_offset, file_size y video_file_chunk.

¿Qué hacen title y description?

title es el título del video. description es, en palabras de Meta, el texto que describe una publicación y que puede mostrarse en una historia sobre ella, así que ahí van las palabras de la publicación. Ambos son opcionales en el edge de videos, y publish_facebook_post envía su message como description y deja title sin definir.

¿Cómo se sabe cuándo el video está listo?

Meta procesa un video después de recibirlo. GET /{video-id}?fields=status devuelve video_status, que indica processing mientras Meta trabaja, ready cuando el video está subido, codificado y tiene sus miniaturas, o error si el procesamiento falló, con processing_progress que indica la proporción completada de 0 a 100. Meta también puede informar el estado de publicación mediante webhooks de la Página en el campo videos, a los que easyCoexistence no se suscribe.

¿Qué tamaño y duración puede tener el video?

La referencia de videos de la Página y la guía de publicación de video de Meta no indican un tamaño máximo de archivo ni una duración máxima; la regla de tamaño que sí nombran es el error 382, para un archivo demasiado pequeño para subirlo. Las guías de Reels e historias de Meta fijan duraciones propias: de 3 a 90 segundos para un Reel y 60 como máximo para un video de historia. Cuando easyCoexistence programa un video, copia el archivo en ese momento y rechaza uno de más de 1 GB.

¿Qué permisos y tarea de la Página necesita?

pages_manage_posts, pages_read_engagement y pages_show_list, con un token de la Página de alguien que pueda realizar la tarea CREATE_CONTENT, según la referencia de videos y la guía de publicación. La descripción general de la API de Video de Meta lo expresa de forma más estricta: la persona debe poder realizar tareas equivalentes a las de administrador en la Página, o tener un rol de Administrador otorgado mediante Business Manager.

¿Qué errores puede devolver una publicación de video?

La referencia de videos de Meta enumera estos para POST /{page-id}/videos:

  • 389: no se puede obtener el archivo de video desde la URL.
  • 382: el archivo de video es demasiado pequeño; reintenta con un archivo más grande.
  • 6000: un problema al subir el archivo de video; reintenta con otro archivo.
  • 6001: un problema al subir el video; reintenta.
  • 368: la acción se consideró abusiva o está prohibida de otro modo.
  • 100: parámetro no válido; 200: error de permisos; 190: token de acceso OAuth 2.0 no válido.

¿Cómo publica un video publish_facebook_post?

Recibe video_url, un enlace HTTPS público al archivo, y message, y los envía a /{page-id}/videos como file_url y description, de modo que Meta descarga el video directamente. Una publicación contiene un video, y un enlace enviado junto con él se rechaza, así que pon la URL en el message. El post_id del resultado guarda el ID que devolvió Meta, que para un video es el ID propio del video.

¿Cómo se programa una publicación de video?

Indica a publish_facebook_post un scheduled_at en ISO 8601 con zona horaria, de 1 minuto a 90 días en el futuro. easyCoexistence copia el video al programar la publicación y lo publica en la Página a esa hora; list_scheduled_posts la muestra, update_scheduled_post la mueve o cambia su texto, y cancel_scheduled_post la detiene. El scheduled_publish_time propio de Meta en el edge de videos permite de 10 minutos a 6 meses.

Errores comunes

  • Apuntar file_url a una página que reproduce el video en lugar de al archivo. Meta descarga esa dirección directamente, y una que no puede obtener falla con el error 389.
  • Subir a graph-video.facebook.com. La descripción general de la API de Video de Meta marca ese host como obsoleto para subidas de video y pide graph.facebook.com.
  • Anunciar el video antes de que esté listo. Consulta el estado hasta que video_status indique ready, porque el procesamiento continúa después de que la llamada de publicación regresa.
  • Enviar un enlace junto con el video. publish_facebook_post rechaza un enlace junto a un archivo; escribe la URL en el message.
Hacerlo con EasyCoexistence

Tu plataforma puede hacer lo mismo con POST /channels/:id/posts en la Partner API. De US$ 9 a US$ 0.75 por conexión al mes, con un precio que baja a medida que añades conexiones, y los primeros 3 días gratis.

Preguntas frecuentes

¿Puedo subir un video desde mi computadora a una Página de Facebook mediante la API?

Sí, mediante la API de Subida Reanudable de Meta, que devuelve un identificador para /{page-id}/videos, o la subida fragmentada de ese edge. publish_facebook_post recibe en cambio una URL HTTPS pública, así que aloja el archivo primero.

¿Puede subirse un video sin que aparezca en el feed de la Página?

Sí. published en false retiene la publicación, no_story suprime la historia del feed y de la línea de tiempo, y secret mantiene el video fuera de Facebook y de las búsquedas.

¿Se puede publicar un mismo video en varias Páginas?

Sí, mediante crossposting: un video publicado puede difundirse en otras Páginas que la persona administra sin volver a subirlo, y obtiene su propio ID de video en cada Página.

¿Cuánto cuesta easyCoexistence para una Página de Facebook?

De US$ 9 a US$ 0.75 por conexión al mes, según el total de conexiones que tengas, con los primeros 3 días gratis. Cada Página es una conexión.

Sigue leyendo

Conecta tu primer canal en dos minutos.

Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.

  • 3 días gratis
  • Cancela cuando quieras
  • Solo APIs oficiales
  • Monitorizado 24/7

Verificado el