Публикация Stories на Facebook-странице через API
Stories API от Meta публикует фото- и видеоистории на Facebook-странице. Фотоистория публикуется из фото, загруженного с параметром published, равным false, затем POST /{page-id}/photo_stories с photo_id этого фото. Видеоистория проходит через вызовы start, upload и finish к /{page-id}/video_stories. Видеоистории длятся до 60 секунд, фото весят до 10 МБ.
easyCoexistence публикует посты страницы Facebook через publish_facebook_post из Claude, ChatGPT или вашего кода: текст, ссылки, фото и видео.
Самая длинная видеоистория, которую Meta разрешает на Facebook-странице.
Максимальный размер файла фотоистории в JPEG, BMP, PNG, GIF или TIFF.
Соотношение сторон видеоистории: рекомендуется 1080 x 1920 пикселей, минимум 540 x 960.
Статусы, которые возвращает GET /{page-id}/stories; архивные истории появляются только при включённом архиве историй страницы.
Как публикуется фотоистория?
В два вызова. Загрузите фото в POST /{page-id}/photos с published, равным false: в ответе придёт ID фото. Затем отправьте POST /{page-id}/photo_stories с photo_id этого фото. Meta ответит success: true и post_id, ID поста с историей.
POST /{page-id}/photo_stories
{
"photo_id": "<PHOTO_ID>"
}
200 OK
{
"success": true,
"post_id": "<STORY_POST_ID>"
}Как публикуется видеоистория?
В три шага, как и для Reels. POST /{page-id}/video_stories с upload_phase: start возвращает video_id и upload_url на rupload.facebook.com. Видео отправляется туда как байты файла с заголовками offset и file_size или как заголовок file_url для размещённого файла. Затем POST /{page-id}/video_stories с video_id и upload_phase: finish публикует видео и возвращает post_id.
Какие медиа может использовать история?
В руководстве Meta по Stories описаны спецификации фото и видео. Фото: файлы .jpeg, .bmp, .png, .gif или .tiff размером до 10 МБ; PNG желательно держать меньше 1 МБ. Видео следуют спецификации Reels, но с меньшим пределом:
- Файл: рекомендуется .mp4 с соотношением сторон 9 x 16.
- Разрешение: рекомендуется 1080 x 1920 пикселей, минимум 540 x 960.
- Частота кадров: от 24 до 60 кадров в секунду, постоянная, с прогрессивной разверткой.
- Длина: не более 60 секунд для видеоистории.
- Кодеки: H.264 или H.265; также поддерживаются VP9 и AV1. Аудио в AAC Low Complexity, 48 кГц, стерео, 128 кбит/с и выше.
Какие медиа нельзя использовать для истории?
Фото или видео, уже использованные в ранее опубликованном посте: правило Meta в том, что медиа, загруженное для истории, не может быть взято из ранее опубликованного поста. Размещённое видео также должно быть доступно, так как Meta отклоняет файлы на сайтах, где robots.txt блокирует user agent facebookexternalhit/1.1, а также файлы с собственного CDN, например URL fbcdn.
Как получить список историй страницы?
GET /{page-id}/stories возвращает по одному объекту на историю; список можно фильтровать по статусу или по дате с помощью since и until. Каждый объект содержит:
post_id: ID поста с историей.- status: PUBLISHED или ARCHIVED; архивные истории требуют включённого архива историй страницы.
creation_time: UNIX-метка времени публикации истории.media_typeиmedia_id: photo или video, и ID этого медиа.- url: адрес истории на Facebook, в разделе facebook.com/stories/.
Какие разрешения нужны?
Токен страницы от пользователя, который может выполнять задачу CREATE_CONTENT на странице, через Facebook Login или Facebook Login for Business, с выданными pages_manage_posts, pages_read_engagement и pages_show_list. Запросы от имени системного пользователя бизнеса также требуют business_management. Это те же три разрешения, что нужны для публикации в ленту страницы.
Когда история выходит в эфир?
В момент вызова photo_stories или finish-вызова video_stories. У Stories API от Meta нет параметра времени публикации: photo_stories принимает photo_id, а finish-вызов принимает video_id, upload_phase и необязательный флаг is_ai_generated. Историю на потом нужно отправить в нужный момент из собственного планировщика.
Как опубликовать историю через easyCoexistence?
Пока нельзя. publish_facebook_post публикует посты, а не истории, а в easyCoexistence нет инструмента для photo_stories или video_stories; токены страницы не выдаются, поэтому эти вызовы нельзя выполнить и из вашего кода на его подключении. Публикуйте истории на Facebook или в Meta Business Suite.
Распространённые ошибки
- Повторное использование фото из более раннего поста. Медиа для истории не может быть взято из ранее опубликованного поста, поэтому загрузите его заново с published, равным false.
- Превращение 90-секундного Reels в историю. Reels могут длиться до 90 секунд, а видеоистория ограничена 60.
- Ожидание архивных историй в списке. Они появляются в GET /{page-id}/stories только при включённом архиве историй страницы.
- Отправка видео на graph.facebook.com. Загрузка идёт на upload_url на rupload.facebook.com; вызовы start, finish и status остаются на graph.facebook.com.
Инструмента для Stories API у него нет, поэтому истории публикуются на Facebook или в Meta Business Suite. US$ 9 до US$ 0,75 за подключение в месяц, цена снижается по мере добавления подключений, первые 3 дня бесплатно.
Часто задаваемые вопросы
Можно ли опубликовать Reels как историю Facebook-страницы?
Да, если он длится 60 секунд или меньше: спецификация Meta говорит, что Reels, опубликованный как история на странице, не может превышать этот предел.
Можно ли пометить видеоисторию как созданную с помощью ИИ?
Да. Установите is_ai_generated в true в finish-вызове video_stories; по умолчанию значение false.
Что делать, если загрузка видео истории прервалась?
Отправьте загрузку заново с offset, равным 0, чтобы начать сначала, или с offset, равным значению bytes_transfered из проверки статуса, чтобы продолжить.
Сколько стоит easyCoexistence для Facebook-страницы?
US$ 9 до US$ 0,75 за подключение в месяц, первые 3 дня бесплатно. Каждая страница считается одним подключением, и цена за подключение снижается по мере добавления новых.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на