Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Historias de la Página de Facebook mediante la API

La API de historias de Meta publica historias de foto y video en una Página de Facebook. Una historia de foto parte de una foto subida con published en false y luego POST /{page-id}/photo_stories con su photo_id; una historia de video pasa por las llamadas start, upload y finish a /{page-id}/video_stories. Las historias de video duran hasta 60 segundos, y las fotos hasta 10 MB.

easyCoexistence publica las publicaciones de una Página de Facebook con publish_facebook_post desde Claude, ChatGPT o tu propio código: texto, enlaces, fotos y videos.

60 seconds

La duración más larga de una historia de video que Meta permite en una Página de Facebook.

10 MB

El archivo de foto más grande para una historia de foto, en JPEG, BMP, PNG, GIF o TIFF.

9 x 16

Relación de aspecto de la historia de video, con 1080 x 1920 píxeles recomendados y 540 x 960 como mínimo.

PUBLISHED, ARCHIVED

Estados que informa GET /{page-id}/stories; las historias archivadas aparecen solo con el archivo de historias de la Página activado.

¿Cómo se publica una historia de foto?

En dos llamadas. Sube la foto a POST /{page-id}/photos con published en false, lo que devuelve el ID de la foto, y luego envía POST /{page-id}/photo_stories con photo_id igual a ese ID. Meta responde con success en true y post_id, el ID de la publicación de la historia.

Publishing a photo story
POST /{page-id}/photo_stories
{
  "photo_id": "<PHOTO_ID>"
}

200 OK
{
  "success": true,
  "post_id": "<STORY_POST_ID>"
}

¿Cómo se publica una historia de video?

En tres pasos, con la misma forma que un Reel. POST /{page-id}/video_stories con upload_phase en start devuelve un video_id y un upload_url en rupload.facebook.com. El video se envía allí, como los bytes del archivo con los encabezados offset y file_size, o como un encabezado file_url para un archivo alojado. Después, POST /{page-id}/video_stories con video_id y upload_phase en finish la publica y devuelve post_id.

1StartPOST /{page-id}/video_stories, upload_phase start
2UploadThe bytes or a file_url, sent to the upload_url
3StatusGET /{video-id}?fields=status
4Finishupload_phase finish with video_id: returns post_id

¿Qué medios puede usar una historia?

La guía de historias de Meta da una especificación para foto y otra para video. Las fotos son archivos .jpeg, .bmp, .png, .gif o .tiff de hasta 10 MB, y conviene que los PNG pesen menos de 1 MB. Los videos siguen la especificación de los Reels, con un límite más corto:

  • Archivo: .mp4 recomendado, con relación de aspecto 9 x 16.
  • Resolución: 1080 x 1920 píxeles recomendados, 540 x 960 como mínimo.
  • Velocidad de fotogramas: de 24 a 60 fotogramas por segundo, fija, con escaneo progresivo.
  • Duración: 60 segundos como máximo para una historia de video.
  • Códecs: H.264 o H.265, con VP9 y AV1 también admitidos; audio en AAC Low Complexity a 48 kHz, estéreo, 128 kbps o más.

¿Qué medios no pueden usarse en una historia?

Una foto o video que ya se usó en una publicación anterior: la regla de Meta es que los medios subidos para una historia no pueden haber sido publicados antes. Un video alojado también tiene que ser accesible, porque Meta rechaza los archivos de sitios cuyo robots.txt bloquea el agente de usuario facebookexternalhit/1.1, y los archivos de su propia CDN, como las URL de fbcdn.

¿Cómo se listan las historias de una Página?

GET /{page-id}/stories devuelve un objeto por historia, y la lista puede filtrarse por estado o por fecha con since y until. Cada objeto contiene:

  • post_id: el ID de la publicación de la historia.
  • status: PUBLISHED o ARCHIVED; las historias archivadas requieren tener activado el archivo de historias de la Página.
  • creation_time: la marca de tiempo UNIX de cuando se publicó la historia.
  • media_type y media_id: foto o video, y el ID de ese medio.
  • url: la dirección de la historia en Facebook, bajo facebook.com/stories/.

¿Qué permisos necesita?

Un token de la Página de alguien que pueda realizar la tarea CREATE_CONTENT en la Página, mediante Facebook Login o Facebook Login for Business, con pages_manage_posts, pages_read_engagement y pages_show_list concedidos. Las peticiones hechas como usuario del sistema de negocio también necesitan business_management. Son los mismos tres permisos que pide publicar en el feed de la Página.

¿Cuándo sube una historia?

Cuando se hace la llamada a photo_stories o la llamada finish a video_stories. La API de historias de Meta no admite hora de publicación: photo_stories recibe un photo_id, y la llamada finish recibe video_id, upload_phase y la marca opcional is_ai_generated. Una historia para más tarde necesita una llamada hecha en ese momento, desde un programador de tareas propio.

¿Cómo se publica una historia a través de easyCoexistence?

Todavía no. publish_facebook_post publica publicaciones, no historias, y easyCoexistence no tiene una herramienta para photo_stories ni video_stories; los tokens de la Página no se entregan, así que las llamadas tampoco pueden ejecutarse desde tu propio código en su conexión. Publica las historias desde Facebook o Meta Business Suite.

Errores comunes

  • Reutilizar una foto de una publicación anterior. Los medios de una historia no pueden venir de una publicación ya publicada, así que súbela de nuevo con published en false.
  • Convertir un Reel de 90 segundos en historia. Los Reels pueden durar hasta 90 segundos, pero una historia de video se queda en 60.
  • Esperar historias archivadas en la lista. Aparecen en GET /{page-id}/stories solo cuando el archivo de historias de la Página está activado.
  • Enviar el video a graph.facebook.com. La subida va a upload_url en rupload.facebook.com; las llamadas start, finish y de estado se quedan en graph.facebook.com.
Hacerlo con EasyCoexistence

No tiene una herramienta para la API de historias, así que las historias se publican desde Facebook o Meta Business Suite. De US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que añades conexiones, con los primeros 3 días gratis.

Preguntas frecuentes

¿Se puede compartir un Reel como historia de una Página de Facebook?

Sí, si dura 60 segundos o menos: la especificación de Meta dice que un Reel publicado como historia en una Página no puede superarlo.

¿Se puede marcar una historia de video como hecha con IA?

Sí. Pon is_ai_generated en true en la llamada finish a video_stories; por defecto es false.

¿Qué pasa si se interrumpe la subida del video de una historia?

Vuelve a enviar la subida con offset en 0 para empezar de nuevo, o con offset igual al valor de bytes_transfered de una comprobación de estado para reanudarla.

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

De US$ 9 a US$ 0.75 por conexión al mes, con los primeros 3 días gratis. Cada Página es una conexión, y el precio por conexión baja a medida que añades más.

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