Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

Relacje strony Facebook przez API

Stories API Meta publikuje zdjęcia i wideo jako relacje na stronie Facebook. Relacja ze zdjęciem wymaga zdjęcia przesłanego z published ustawionym na false, a następnie POST /{page-id}/photo_stories z jego photo_id. Relację wideo tworzą wywołania start, upload i finish na /{page-id}/video_stories. Relacje wideo trwają do 60 sekund, a zdjęcia mogą mieć do 10 MB.

easyCoexistence publikuje posty strony na Facebooku za pomocą publish_facebook_post z Claude, ChatGPT lub własnego kodu: tekst, linki, zdjęcia i wideo.

60 seconds

Najdłuższa relacja wideo, jaką Meta dopuszcza na stronie Facebook.

10 MB

Największy rozmiar pliku zdjęcia do relacji, w formatach JPEG, BMP, PNG, GIF lub TIFF.

9 x 16

Proporcje relacji wideo, z zalecaną rozdzielczością 1080 x 1920 pikseli i minimum 540 x 960.

PUBLISHED, ARCHIVED

Statusy, które raportuje GET /{page-id}/stories; zarchiwizowane relacje pojawiają się tylko przy włączonym archiwum relacji strony.

Jak opublikować relację ze zdjęciem?

W dwóch wywołaniach. Prześlij zdjęcie do POST /{page-id}/photos z published ustawionym na false, co zwraca ID zdjęcia, a następnie wyślij POST /{page-id}/photo_stories z photo_id ustawionym na to ID. Meta odpowiada success ustawionym na true oraz post_id, czyli ID posta z relacją.

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

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

Jak opublikować relację wideo?

W trzech krokach, w tym samym schemacie co Reel. POST /{page-id}/video_stories z upload_phase ustawionym na start zwraca video_id i upload_url na rupload.facebook.com. Wideo wysyłasz tam jako bajty pliku z nagłówkami offset i file_size albo jako nagłówek file_url dla pliku hostowanego. Następnie POST /{page-id}/video_stories z video_id i upload_phase ustawionym na finish publikuje relację i zwraca 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

Jakich mediów może używać relacja?

Wytyczne Stories od Meta podają specyfikację dla zdjęć i dla wideo. Zdjęcia to pliki .jpeg, .bmp, .png, .gif lub .tiff o rozmiarze do 10 MB, przy czym PNG najlepiej trzymać poniżej 1 MB. Wideo podlega specyfikacji Reels, z krótszym limitem:

  • Plik: zalecany .mp4 w proporcji 9 x 16.
  • Rozdzielczość: zalecane 1080 x 1920 pikseli, minimum 540 x 960.
  • Liczba klatek: od 24 do 60 klatek na sekundę, stała, z skanowaniem progresywnym.
  • Długość: maksymalnie 60 sekund dla relacji wideo.
  • Kodeki: H.264 lub H.265, z obsługą VP9 i AV1; audio w AAC Low Complexity, 48 kHz, stereo, 128 kbps lub więcej.

Jakich mediów nie można użyć w relacji?

Zdjęcia lub wideo użyte już w opublikowanym wcześniej poście: zasada Meta mówi, że media przesłane do relacji nie mogą pochodzić z takiego posta. Hostowane wideo musi być też osiągalne, bo Meta odrzuca pliki na stronach, których robots.txt blokuje agenta użytkownika facebookexternalhit/1.1, oraz pliki z własnej sieci CDN, na przykład adresy fbcdn.

Jak wyświetlić listę relacji strony?

GET /{page-id}/stories zwraca jeden obiekt na relację, a listę można filtrować według statusu lub daty za pomocą since i until. Każdy obiekt zawiera:

  • post_id: ID posta z relacją.
  • status: PUBLISHED lub ARCHIVED; zarchiwizowane relacje wymagają włączonego archiwum relacji strony.
  • creation_time: znacznik czasu UNIX z chwili opublikowania relacji.
  • media_type i media_id: photo lub video oraz ID tego medium.
  • url: adres relacji na Facebooku, pod facebook.com/stories/.

Jakich uprawnień to wymaga?

Potrzebny jest token Strony, wystawiony przez osobę, która może wykonać zadanie CREATE_CONTENT na stronie, przez Facebook Login lub Facebook Login for Business, z przyznanymi uprawnieniami pages_manage_posts, pages_read_engagement i pages_show_list. Żądania wykonywane jako użytkownik systemowy firmy wymagają też business_management. To te same trzy uprawnienia, o które prosi publikowanie na tablicy strony.

Kiedy relacja zostaje opublikowana?

W chwili wykonania wywołania photo_stories albo finish na video_stories. Stories API Meta nie przyjmuje czasu publikacji: photo_stories przyjmuje photo_id, a wywołanie finish przyjmuje video_id, upload_phase i opcjonalną flagę is_ai_generated. Relację na później trzeba wywołać w odpowiednim momencie, z własnego harmonogramu.

Jak opublikować relację przez easyCoexistence?

Jeszcze nie. publish_facebook_post publikuje posty, a nie relacje, a easyCoexistence nie ma narzędzia do photo_stories ani video_stories; tokeny Strony nie są udostępniane, więc wywołania nie mogą też działać z Twojego własnego kodu na jego połączeniu. Publikuj relacje z Facebooka lub Meta Business Suite.

Typowe błędy

  • Ponowne użycie zdjęcia z wcześniejszego posta. Media do relacji nie mogą pochodzić z już opublikowanego posta, więc prześlij je ponownie z published ustawionym na false.
  • Zamiana Reel o długości 90 sekund w relację. Reels mogą trwać do 90 sekund, ale relacja wideo kończy się na 60.
  • Oczekiwanie zarchiwizowanych relacji na liście. Pojawiają się one w GET /{page-id}/stories tylko przy włączonym archiwum relacji strony.
  • Wysyłanie wideo na graph.facebook.com. Przesłanie musi trafić pod upload_url na rupload.facebook.com, a wywołania start, finish i status zostają na graph.facebook.com.
Z EasyCoexistence zrobisz to

Nie ma narzędzia do Stories API, więc relacje publikuje się z Facebooka lub Meta Business Suite. Od US$ 9 do US$ 0,75 za połączenie miesięcznie, cena spada wraz z kolejnymi połączeniami, a pierwsze 3 dni są bezpłatne.

Najczęściej zadawane pytania

Czy Reel można udostępnić jako relację na stronie Facebook?

Tak, jeśli trwa 60 sekund lub krócej: specyfikacja Meta mówi, że Reel opublikowany jako relacja na stronie nie może przekraczać tego limitu.

Czy relację wideo można oznaczyć jako wygenerowaną przez AI?

Tak. Ustaw is_ai_generated na true w wywołaniu finish na video_stories; domyślnie ma wartość false.

Co zrobić, gdy przesyłanie wideo do relacji zostanie przerwane?

Wyślij przesyłanie ponownie z offset ustawionym na 0, aby zacząć od nowa, albo z offset ustawionym na wartość bytes_transfered z kontroli statusu, aby wznowić.

Ile kosztuje easyCoexistence dla strony na Facebooku?

Od US$ 9 do US$ 0,75 za połączenie miesięcznie, z pierwszymi 3 dniami bezpłatnie. Każda strona to jedno połączenie, a cena za połączenie spada wraz z dodawaniem kolejnych.

Czytaj dalej

Połącz pierwszy kanał w dwie minuty.

Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.

  • 3 dni za darmo
  • Rezygnacja w każdej chwili
  • Tylko oficjalne API
  • Monitorowanie 24/7

Zweryfikowano w