Kirjaudu sisäänAloita ilmainen kokeilu
easyCoexistence Viralliset API:t

Facebook-sivun storyt API:n kautta

Metan Stories API julkaisee kuva- ja videostoryt Facebook-sivulle. Kuvastory vaatii kuvan, joka on ladattu julkaisemattomana published-kentän arvolla false, minkä jälkeen POST /{page-id}/photo_stories lähetetään photo_id:n kanssa. Videostory kulkee POST /{page-id}/video_stories -kutsujen kautta aloitus-, lataus- ja viimeistelyvaiheissa. Videostoryt voivat olla enintään 60 sekuntia pitkiä ja kuvat enintään 10 MB.

easyCoexistence julkaisee Facebook-sivun postaukset publish_facebook_post-työkalulla Claudesta, ChatGPT:stä tai omasta koodistasi: tekstit, linkit, kuvat ja videot.

60 seconds

Pisin videostory, jonka Meta sallii Facebook-sivulla.

10 MB

Suurin kuvastorylle sallittu tiedostokoko (JPEG, BMP, PNG, GIF tai TIFF).

9 x 16

Videostoryn kuvasuhde: suositeltu 1080 x 1920 pikseliä, vähintään 540 x 960.

PUBLISHED, ARCHIVED

Tilat, jotka GET /{page-id}/stories palauttaa; arkistoidut storyt näkyvät vain, kun sivun storyarkisto on päällä.

Miten kuvastory julkaistaan?

Kahdessa kutsussa. Lataa kuva POST /{page-id}/photos-kutsulla, jossa published on asetettu arvoon false. Se palauttaa kuvan ID:n. Lähetä sen jälkeen POST /{page-id}/photo_stories, jossa photo_id on tämä ID. Meta vastaa arvolla success true ja post_id, eli storyn julkaisun ID.

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

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

Miten videostory julkaistaan?

Kolmessa vaiheessa, samalla rakenteella kuin Reel. POST /{page-id}/video_stories, jossa upload_phase on start, palauttaa video_id:n ja upload_url-osoitteen osoitteessa rupload.facebook.com. Video lähetetään sinne tiedoston tavuina offset- ja file_size-otsikoilla tai file_url-otsikolla hostatulle tiedostolle. Sen jälkeen POST /{page-id}/video_stories, jossa ovat video_id ja upload_phase arvolla finish, julkaisee videon ja palauttaa post_id:n.

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

Mitä mediaa storyssä voi käyttää?

Metan Stories-ohje antaa erikseen kuva- ja videomäärittelyn. Kuvat ovat .jpeg-, .bmp-, .png-, .gif- tai .tiff-tiedostoja, enintään 10 MB, ja PNG-tiedosto kannattaa pitää alle 1 MB:ssa. Videot noudattavat Reels-määrittelyä, mutta enimmäispituus on lyhyempi:

  • Tiedosto: suositeltavasti .mp4, 9 x 16 kuvasuhteella.
  • Resoluutio: suositeltavasti 1080 x 1920 pikseliä, vähintään 540 x 960.
  • Kuvataajuus: 24–60 kuvaa sekunnissa, kiinteä, progressiivisena.
  • Pituus: videostory saa olla enintään 60 sekuntia.
  • Koodekit: H.264 tai H.265, lisäksi tuki VP9:lle ja AV1:lle; ääni AAC Low Complexity -muodossa, 48 kHz, stereo, vähintään 128 kbps.

Mitä mediaa storyyn ei voi käyttää?

Kuvaa tai videota, joka on jo käytetty aiemmin julkaistussa postauksessa, sillä Metan mukaan storyyn ladattu media ei saa olla sellaista. Hostatun videon täytyy myös olla tavoitettavissa, sillä Meta hylkää tiedostot sivustoilta, joiden robots.txt estää facebookexternalhit/1.1-käyttäjäagentin, sekä tiedostot Metan omasta CDN:stä, kuten fbcdn-URL-osoitteet.

Miten sivun storyt listataan?

GET /{page-id}/stories palauttaa yhden olion jokaista storya kohden, ja listaa voi suodattaa tilan tai päivämäärän mukaan since- ja until-parametreilla. Jokainen olio sisältää:

  • post_id: storyn julkaisun ID.
  • status: PUBLISHED tai ARCHIVED; arkistoidut storyt vaativat sivun storyarkiston käyttöön ottamisen.
  • creation_time: UNIX-aikaleima, jolloin story julkaistiin.
  • media_type ja media_id: kuva tai video sekä kyseisen median ID.
  • url: storyn Facebook-osoite, alkaen facebook.com/stories/.

Mitä oikeuksia tarvitaan?

Sivun token henkilöltä, joka voi suorittaa CREATE_CONTENT-tehtävän sivulla, Facebook Login- tai Facebook Login for Business -kirjautumisen kautta, ja oikeudet pages_manage_posts, pages_read_engagement ja pages_show_list myönnettyinä. Yritysjärjestelmäkäyttäjänä tehtyjen pyyntöjen täytyy lisäksi sisältää business_management. Ne ovat samat kolme oikeutta, joita julkaisu sivun syötteeseen vaatii.

Milloin story menee julkaisuun?

Kun photo_stories-kutsu tai video_stories-viimeistelykutsu tehdään. Metan Stories API ei ota vastaan julkaisuaikaa: photo_stories ottaa photo_id:n, ja viimeistelykutsu ottaa video_id:n, upload_phase-kentän ja valinnaisen is_ai_generated-lipun. Myöhemmin julkaistava story vaatii kutsun juuri silloin, omasta ajastimesta käsin.

Miten storyn julkaistaan easyCoexistencen kautta?

Ei vielä voi. publish_facebook_post julkaisee postauksia, ei storyja, eikä easyCoexistencessa ole työkalua photo_stories- tai video_stories-kutsuille; sivun tokeneita ei luovuteta, joten kutsuja ei voi ajaa myöskään omasta koodistasi sen yhteyden kautta. Julkaise storyt Facebookissa tai Meta Business Suitessa.

Yleiset virheet

  • Aiemman postauksen kuvan uudelleenkäyttö. Storyn media ei voi tulla aiemmin julkaistusta postauksesta, joten lataa se uudelleen julkaisemattomana, published-arvolla false.
  • 90 sekunnin Reelin muuttaminen storyksi. Reelit voivat olla 90 sekuntia, mutta videostory päättyy 60 sekuntiin.
  • Arkistoitujen storyjen odottaminen listassa. Ne näkyvät GET /{page-id}/stories -listassa vain, kun sivun storyarkisto on päällä.
  • Videon lähettäminen osoitteeseen graph.facebook.com. Lataus kuuluu upload_url-osoitteeseen rupload.facebook.com-palvelimella; aloitus-, viimeistely- ja tilakutsut pysyvät osoitteessa graph.facebook.com.
Näin teet tämän EasyCoexistencen avulla

Siinä ei ole työkalua Stories API:lle, joten storyt julkaistaan Facebookissa tai Meta Business Suitessa. Hinta alkaen US$ 9 per yhteys kuukaudessa, laskien US$ 0,75:een lisättäessä yhteyksiä, ensimmäiset 3 päivää ilmaiseksi.

Usein kysytyt kysymykset

Voiko Reelin jakaa Facebook-sivun storynä?

Kyllä, jos se on enintään 60 sekuntia pitkä: Metan määrittelyn mukaan sivulla storynä julkaistu Reel ei voi ylittää tätä.

Voiko videostoryn merkitä tekoälyllä tehdyksi?

Kyllä. Aseta is_ai_generated arvoon true video_stories-viimeistelykutsussa; oletusarvo on false.

Mitä jos storyn videolataus keskeytyy?

Lähetä lataus uudelleen offset-arvolla 0 aloittaaksesi alusta, tai offset-arvolla, joka on tilatarkistuksen bytes_transfered-arvo, jatkaaksesi.

Mitä easyCoexistence maksaa Facebook-sivulle?

Hinta alkaen US$ 9 per yhteys kuukaudessa, laskien US$ 0,75:een lisättäessä yhteyksiä, ensimmäiset 3 päivää ilmaiseksi. Jokainen sivu on yksi yhteys, ja yhteyden hinta laskee lisättäessä enemmän.

Lue lisää

Yhdistä ensimmäinen kanavasi kahdessa minuutissa.

Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.

  • 3 päivää ilmaiseksi
  • Peruuta milloin tahansa
  • Vain viralliset API:t
  • Valvottu 24/7

Vahvistettu