Conectați-văÎncepeți perioada de probă gratuită
easyCoexistence API-uri oficiale

Story-urile paginilor de Facebook prin API

API-ul Stories al Meta publică story-uri foto și video pe o pagină de Facebook. Un story foto pornește de la o fotografie încărcată cu published setat la false, apoi POST /{page-id}/photo_stories cu photo_id setat la ID-ul fotografiei; un story video trece prin apelurile start, încărcare și finish pe /{page-id}/video_stories. Story-urile video durează cel mult 60 de secunde, iar fotografiile pot avea până la 10 MB.

easyCoexistence publică postările unei pagini Facebook cu publish_facebook_post din Claude, ChatGPT sau din codul propriu: text, linkuri, fotografii și videoclipuri.

60 seconds

Cel mai lung story video pe care Meta îl permite pe o pagină de Facebook.

10 MB

Cel mai mare fișier foto pentru un story foto, în format JPEG, BMP, PNG, GIF sau TIFF.

9 x 16

Raportul de aspect al story-ului video, cu 1080 x 1920 pixeli recomandați și cel puțin 540 x 960.

PUBLISHED, ARCHIVED

Statusurile pe care GET /{page-id}/stories le raportează; story-urile arhivate apar doar când arhiva de story-uri a paginii este activată.

Cum se publică un story foto?

În doi pași. Încărcați fotografia la POST /{page-id}/photos cu published setat la false, ceea ce returnează ID-ul fotografiei, apoi trimiteți POST /{page-id}/photo_stories cu photo_id setat la acesta. Meta răspunde cu success setat la true și cu post_id, ID-ul postării story-ului.

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

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

Cum se publică un story video?

În trei pași, aceeași structură ca la un Reel. POST /{page-id}/video_stories cu upload_phase setat la start returnează un video_id și un upload_url pe rupload.facebook.com. Videoclipul se trimite acolo, ca octeții fișierului cu antetele offset și file_size, sau ca antet file_url pentru un fișier găzduit. Apoi POST /{page-id}/video_stories cu video_id și upload_phase setat la finish îl publică și returnează 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

Ce materiale media poate folosi un story?

Ghidul Stories al Meta oferă o specificație pentru fotografii și una pentru videoclipuri. Fotografiile sunt fișiere .jpeg, .bmp, .png, .gif sau .tiff de până la 10 MB, cu PNG-urile de preferat sub 1 MB. Videoclipurile urmează specificația Reels, cu un plafon mai scurt:

  • Fișier: .mp4 recomandat, cu raport de aspect 9 x 16.
  • Rezoluție: 1080 x 1920 pixeli recomandați, cel puțin 540 x 960.
  • Rată de cadre: între 24 și 60 de cadre pe secundă, fixă, cu scanare progresivă.
  • Durată: cel mult 60 de secunde pentru un story video.
  • Codecuri: H.264 sau H.265, VP9 și AV1 fiind de asemenea acceptate; audio în AAC Low Complexity, la 48 kHz, stereo, 128 kbps sau mai mult.

Ce materiale media nu pot fi folosite pentru un story?

O fotografie sau un videoclip deja folosit într-o postare publicată anterior: regula Meta este că materialul încărcat pentru un story nu trebuie să fi fost deja folosit. Un videoclip găzduit trebuie, de asemenea, să fie accesibil, deoarece Meta respinge fișierele de pe site-urile al căror robots.txt blochează user agentul facebookexternalhit/1.1, precum și fișierele de pe propriul CDN, cum sunt URL-urile fbcdn.

Cum listați story-urile unei pagini?

GET /{page-id}/stories returnează un obiect pentru fiecare story, iar lista poate fi filtrată după status sau după dată, cu since și until. Fiecare obiect conține:

  • post_id: ID-ul postării story-ului.
  • status: PUBLISHED sau ARCHIVED; story-urile arhivate necesită ca arhiva de story-uri a paginii să fie activată.
  • creation_time: marca de timp UNIX a momentului publicării story-ului.
  • media_type și media_id: foto sau video și ID-ul acelui material.
  • url: adresa story-ului pe Facebook, sub facebook.com/stories/.

Ce permisiuni sunt necesare?

Un token al paginii de la cineva care poate îndeplini sarcina CREATE_CONTENT pe pagină, prin Facebook Login sau Facebook Login for Business, cu pages_manage_posts, pages_read_engagement și pages_show_list acordate. Cererile făcute ca utilizator de sistem al unei firme necesită și business_management. Sunt aceleași trei permisiuni pe care le cere și publicarea în fluxul paginii.

Când apare un story?

Atunci când se face apelul photo_stories sau apelul finish pe video_stories. API-ul Stories al Meta nu acceptă o oră de publicare: photo_stories primește un photo_id, iar apelul finish primește video_id, upload_phase și indicatorul opțional is_ai_generated. Un story programat pentru mai târziu necesită un apel făcut în acel moment, dintr-un planificator propriu.

Cum publicați un story prin easyCoexistence?

Încă nu se poate. publish_facebook_post publică postări, nu story-uri, iar easyCoexistence nu are un tool pentru photo_stories sau video_stories; token-urile paginii nu sunt predate, așa că apelurile nu pot rula nici din codul dumneavoastră pe conexiunea sa. Publicați story-urile din Facebook sau din Meta Business Suite.

Greșeli frecvente

  • Refolosirea unei fotografii dintr-o postare anterioară. Materialul pentru un story nu poate proveni dintr-o postare publicată anterior, deci încărcați-l din nou cu published setat la false.
  • Transformarea unui Reel de 90 de secunde într-un story. Reels pot dura până la 90 de secunde, dar un story video se oprește la 60.
  • Așteptarea story-urilor arhivate în listă. Ele apar în GET /{page-id}/stories doar când arhiva de story-uri a paginii este activată.
  • Trimiterea videoclipului către graph.facebook.com. Încărcarea trebuie făcută la upload_url de pe rupload.facebook.com; apelurile start, finish și status rămân pe graph.facebook.com.
Faceți acest lucru cu EasyCoexistence

Nu are un tool pentru API-ul Stories, așa că story-urile se publică din Facebook sau din Meta Business Suite. Între US$ 9 și US$ 0,75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.

Întrebări frecvente

Poate un Reel să fie distribuit ca story pe o pagină de Facebook?

Da, dacă durează 60 de secunde sau mai puțin: specificația Meta spune că un Reel publicat ca story pe o pagină nu poate depăși această durată.

Poate un story video să fie etichetat ca fiind realizat cu AI?

Da. Setați is_ai_generated la true în apelul finish pe video_stories; implicit este false.

Ce se întâmplă dacă încărcarea videoclipului unui story se întrerupe?

Trimiteți încărcarea din nou cu offset setat la 0 pentru a reporni, sau cu offset setat la valoarea bytes_transfered dintr-o verificare de status pentru a relua.

Cât costă easyCoexistence pentru o pagină de Facebook?

Între US$ 9 și US$ 0,75 pe conexiune pe lună, cu primele 3 zile gratuite. Fiecare pagină este o conexiune, iar prețul pe conexiune scade pe măsură ce adăugați mai multe.

Continuați să citiți

Conectați primul canal în două minute.

Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.

  • 3 zile gratuit
  • Anulați oricând
  • Doar API-uri oficiale
  • Monitorizat 24/7

Verificat la