AccediInizia la prova gratuita
easyCoexistence API ufficiali

Storie di una Pagina Facebook tramite l'API

L'API Stories di Meta pubblica storie foto e video su una Pagina Facebook. Una storia foto richiede una foto caricata con published impostato su false, poi POST /{page-id}/photo_stories con il suo photo_id; una storia video passa per le chiamate start, upload e finish su /{page-id}/video_stories. Le storie video durano fino a 60 secondi e le foto fino a 10 MB.

easyCoexistence pubblica i post di una Pagina Facebook con publish_facebook_post da Claude, ChatGPT o dal tuo codice: testo, link, foto e video.

60 seconds

La durata massima di una storia video che Meta consente su una Pagina Facebook.

10 MB

Il file foto più grande per una storia foto, in JPEG, BMP, PNG, GIF o TIFF.

9 x 16

Proporzioni della storia video, con 1080 x 1920 pixel consigliati e almeno 540 x 960.

PUBLISHED, ARCHIVED

Gli stati che GET /{page-id}/stories riporta; le storie archiviate compaiono solo con l'archivio storie della Pagina attivo.

Come si pubblica una storia foto?

In due chiamate. Carica la foto su POST /{page-id}/photos con published impostato su false, che restituisce l'ID della foto, poi invia POST /{page-id}/photo_stories con photo_id impostato su quell'ID. Meta risponde con success impostato su true e post_id, l'ID del post della storia.

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

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

Come si pubblica una storia video?

In tre passaggi, con la stessa struttura di un Reel. POST /{page-id}/video_stories con upload_phase impostato su start restituisce un video_id e un upload_url su rupload.facebook.com. Il video va inviato lì, come byte del file con gli header offset e file_size, oppure come header file_url per un file ospitato. Poi POST /{page-id}/video_stories con video_id e upload_phase impostato su finish lo pubblica e restituisce 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

Quali media può usare una storia?

La guida Stories di Meta fornisce una specifica per le foto e una per i video. Le foto sono file .jpeg, .bmp, .png, .gif o .tiff fino a 10 MB, con i PNG meglio sotto 1 MB. I video seguono la specifica dei Reel, con un limite più basso:

  • File: .mp4 consigliato, con proporzioni 9 x 16.
  • Risoluzione: 1080 x 1920 pixel consigliati, almeno 540 x 960.
  • Frequenza dei fotogrammi: da 24 a 60 fotogrammi al secondo, fissa, con scansione progressiva.
  • Durata: 60 secondi al massimo per una storia video.
  • Codec: H.264 o H.265, con supporto anche per VP9 e AV1; audio in AAC Low Complexity a 48 kHz, stereo, 128 kbps o più.

Quali media non possono essere usati per una storia?

Una foto o un video già usati in un post pubblicato in precedenza: la regola di Meta è che i media caricati per una storia non possono essere già stati pubblicati in un post. Anche un video ospitato deve essere raggiungibile, perché Meta rifiuta i file su siti il cui robots.txt blocca lo user agent facebookexternalhit/1.1, e i file sulla propria CDN, come gli URL fbcdn.

Come si elencano le storie di una Pagina?

GET /{page-id}/stories restituisce un oggetto per storia, e l'elenco può essere filtrato per stato o per data con since e until. Ogni oggetto contiene:

  • post_id: l'ID del post della storia.
  • status: PUBLISHED o ARCHIVED; le storie archiviate richiedono l'archivio storie della Pagina attivo.
  • creation_time: il timestamp UNIX di quando la storia è stata pubblicata.
  • media_type e media_id: foto o video, e l'ID di quel media.
  • url: l'indirizzo Facebook della storia, sotto facebook.com/stories/.

Di quali permessi ha bisogno?

Un token della Pagina di qualcuno che può eseguire l'attività CREATE_CONTENT sulla Pagina, tramite Facebook Login o Facebook Login for Business, con pages_manage_posts, pages_read_engagement e pages_show_list concessi. Le richieste fatte come utente di sistema dell'azienda richiedono anche business_management. Sono gli stessi tre permessi richiesti per pubblicare nel feed della Pagina.

Quando va online una storia?

Quando viene effettuata la chiamata photo_stories o la chiamata finish di video_stories. L'API Stories di Meta non accetta un orario di pubblicazione: photo_stories richiede un photo_id, e la chiamata finish richiede video_id, upload_phase e il flag facoltativo is_ai_generated. Una storia da pubblicare più tardi richiede una chiamata effettuata in quel momento, da un proprio scheduler.

Come si pubblica una storia tramite easyCoexistence?

Non ancora. publish_facebook_post pubblica post e non storie, ed easyCoexistence non ha uno strumento per photo_stories o video_stories; i token della Pagina non vengono consegnati, quindi le chiamate non possono partire nemmeno dal tuo codice sulla sua connessione. Pubblica le storie da Facebook o da Meta Business Suite.

Errori comuni

  • Riutilizzare una foto di un post precedente. I media per una storia non possono provenire da un post già pubblicato, quindi caricala di nuovo con published impostato su false.
  • Trasformare un Reel di 90 secondi in una storia. I Reel possono durare fino a 90 secondi, ma una storia video si ferma a 60.
  • Aspettarsi storie archiviate nell'elenco. Compaiono in GET /{page-id}/stories solo quando l'archivio storie della Pagina è attivo.
  • Inviare il video a graph.facebook.com. Il caricamento va all'upload_url su rupload.facebook.com; le chiamate start, finish e status restano su graph.facebook.com.
Farlo con EasyCoexistence

Non ha uno strumento per l'API Stories, quindi le storie si pubblicano da Facebook o da Meta Business Suite. Da US$ 9 a US$ 0,75 per connessione al mese, con il prezzo che scende man mano che aggiungi connessioni, e con i primi 3 giorni di prova gratuita.

Domande frequenti

Un Reel si può condividere come storia di una Pagina Facebook?

Sì, se dura 60 secondi o meno: la specifica di Meta dice che un Reel pubblicato come storia su una Pagina non può superare quella durata.

Una storia video può essere etichettata come creata con l'AI?

Sì. Imposta is_ai_generated su true nella chiamata finish di video_stories; il valore predefinito è false.

Cosa succede se il caricamento del video di una storia si interrompe?

Invia di nuovo il caricamento con offset impostato su 0 per ricominciare, oppure con offset impostato al valore bytes_transfered di un controllo dello stato per riprendere.

Quanto costa easyCoexistence per una Pagina Facebook?

Da US$ 9 a US$ 0,75 per connessione al mese, con i primi 3 giorni di prova gratuita. Ogni Pagina è una connessione, e il prezzo per connessione scende man mano che ne aggiungi altre.

Continua a leggere

Collega il tuo primo canale in due minuti.

Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.

  • 3 giorni gratis
  • Disdici quando vuoi
  • Solo API ufficiali
  • Monitorato 24/7

Verificato il