Facebook-pagina stories via de API
Met de Stories API van Meta publiceer je foto- en videostories op een Facebook-pagina. Een fotostory vraagt een foto die je uploadt met published op false, waarna je POST /{page-id}/photo_stories aanroept met de photo_id. Een videostory loopt via de aanroepen start, upload en finish op /{page-id}/video_stories. Videostories duren maximaal 60 seconden en foto's mogen tot 10 MB zijn.
easyCoexistence publiceert de posts van een Facebook-pagina met publish_facebook_post vanuit Claude, ChatGPT of je eigen code: tekst, links, foto's en video's.
De langste videostory die Meta op een Facebook-pagina toestaat.
Het grootste fotobestand voor een fotostory, in JPEG, BMP, PNG, GIF of TIFF.
De aspectverhouding van een videostory, met 1080 x 1920 pixels aanbevolen en minimaal 540 x 960.
De statussen die GET /{page-id}/stories rapporteert; gearchiveerde stories verschijnen alleen als het storyarchief van de pagina is ingeschakeld.
Hoe wordt een fotostory gepubliceerd?
In twee aanroepen. Upload de foto naar POST /{page-id}/photos met published op false; dat geeft het ID van de foto terug. Stuur daarna POST /{page-id}/photo_stories met photo_id ingesteld op dat ID. Meta antwoordt met success op true en post_id, het ID van de storypost.
POST /{page-id}/photo_stories
{
"photo_id": "<PHOTO_ID>"
}
200 OK
{
"success": true,
"post_id": "<STORY_POST_ID>"
}Hoe wordt een videostory gepubliceerd?
In drie stappen, net als bij een Reel. POST /{page-id}/video_stories met upload_phase op start geeft een video_id en een upload_url op rupload.facebook.com terug. De video gaat daarheen, als de bytes van het bestand met offset- en file_size-headers, of als file_url-header voor een gehost bestand. Daarna publiceert POST /{page-id}/video_stories met de video_id en upload_phase op finish de video en geeft post_id terug.
Welke media kan een story gebruiken?
De Stories-gids van Meta geeft een specificatie voor foto's en een voor video. Foto's zijn .jpeg-, .bmp-, .png-, .gif- of .tiff-bestanden van maximaal 10 MB, waarbij PNG bij voorkeur onder 1 MB blijft. Video's volgen de Reels-specificatie, met een lagere limiet:
- Bestand: .mp4 aanbevolen, met een aspectverhouding van 9 x 16.
- Resolutie: 1080 x 1920 pixels aanbevolen, minimaal 540 x 960.
- Framesnelheid: 24 tot 60 frames per seconde, vast, met progressive scan.
- Lengte: maximaal 60 seconden voor een videostory.
- Codecs: H.264 of H.265, met VP9 en AV1 ook ondersteund; audio in AAC Low Complexity op 48 kHz, stereo, 128 kbps of meer.
Welke media kunnen niet voor een story worden gebruikt?
Een foto of video die al in een eerder gepubliceerde post is gebruikt: volgens de regel van Meta mag media die voor een story is geüpload daar niet eerder voor gebruikt zijn. Een gehoste video moet ook bereikbaar zijn, want Meta weigert bestanden op sites waarvan robots.txt de user agent facebookexternalhit/1.1 blokkeert, en bestanden op de eigen CDN van Meta, zoals fbcdn-URL's.
Hoe laat je de stories van een pagina zien?
GET /{page-id}/stories geeft één object per story terug, en de lijst kan worden gefilterd op status of op datum met since en until. Elk object bevat:
post_id: het ID van de storypost.- status: PUBLISHED of ARCHIVED; gearchiveerde stories vereisen dat het storyarchief van de pagina is ingeschakeld.
creation_time: de UNIX-tijdstempel van het moment van publiceren.media_typeenmedia_id: foto of video, en het ID van die media.- url: het Facebook-adres van de story, onder facebook.com/stories/.
Welke machtigingen zijn nodig?
Een Page-token van iemand die de taak CREATE_CONTENT op de pagina mag uitvoeren, via Facebook Login of Facebook Login for Business, met pages_manage_posts, pages_read_engagement en pages_show_list toegekend. Verzoeken die als zakelijke systeemgebruiker worden gedaan, hebben ook business_management nodig. Het zijn dezelfde drie machtigingen die het publiceren naar de feed van de pagina vraagt.
Wanneer gaat een story online?
Op het moment dat de aanroep photo_stories of de finish-aanroep van video_stories wordt gedaan. De Stories API van Meta kent geen publicatietijd: photo_stories neemt een photo_id, en de finish-aanroep neemt video_id, upload_phase en de optionele vlag is_ai_generated. Een story voor later vraagt een aanroep op dat moment, vanuit een eigen scheduler.
Hoe publiceer je een story via easyCoexistence?
Dat kan nog niet. publish_facebook_post publiceert posts en geen stories, en easyCoexistence heeft geen tool voor photo_stories of video_stories; Page-tokens worden niet verstrekt, dus de aanroepen kunnen ook niet vanuit je eigen code op die verbinding draaien. Publiceer stories vanuit Facebook of Meta Business Suite.
Veelgemaakte fouten
- Een foto van een eerdere post hergebruiken. Media voor een story mag niet uit een eerder gepubliceerde post komen, dus upload die opnieuw met published op false.
- Een Reel van 90 seconden omzetten naar een story. Reels mogen tot 90 seconden duren, maar een videostory stopt bij 60.
- Gearchiveerde stories in de lijst verwachten. Ze verschijnen in GET /{page-id}/stories alleen als het storyarchief van de pagina is ingeschakeld.
- De video naar graph.facebook.com sturen. De upload hoort op de upload_url op rupload.facebook.com; de start-, finish- en statusaanroepen blijven op graph.facebook.com.
Het heeft geen tool voor de Stories API, dus stories publiceer je vanuit Facebook of Meta Business Suite. Van US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met de eerste 3 dagen gratis.
Veelgestelde vragen
Kan een Reel als Facebook-paginastory worden gedeeld?
Ja, als hij 60 seconden of korter is: de specificatie van Meta zegt dat een Reel die als story op een pagina wordt gepubliceerd die lengte niet mag overschrijden.
Kan een videostory als door AI gemaakt worden gemarkeerd?
Ja. Zet is_ai_generated op true in de finish-aanroep op video_stories; de standaardwaarde is false.
Wat als de video-upload van een story wordt onderbroken?
Stuur de upload opnieuw met offset op 0 om opnieuw te beginnen, of met offset op de waarde bytes_transfered uit een statuscontrole om te hervatten.
Hoeveel kost easyCoexistence voor een Facebook-pagina?
Van US$ 9 tot US$ 0,75 per verbinding per maand, met de eerste 3 dagen gratis. Elke pagina is één verbinding, en de prijs per verbinding daalt naarmate je er meer toevoegt.
Lees verder
Koppel je eerste kanaal in twee minuten.
Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.
- 3 dagen gratis
- Op elk moment opzegbaar
- Alleen officiële API's
- 24/7 bewaakt
Geverifieerd op