API постов Facebook-страницы: текст, ссылки, фото и видео
Graph API публикует четыре вида постов страницы: текст и ссылки через POST /{page-id}/feed, фото через /{page-id}/photos по URL, уже доступному в интернете, и видео через /{page-id}/videos по доступному URL файла. Посты публикуются от имени страницы, требуют токен доступа страницы с правом pages_manage_posts и могут ждать в неопубликованном виде до назначенного времени.
easyCoexistence публикует посты на Facebook-страницах через publish_facebook_post из Claude, ChatGPT или вашего собственного кода: текст, ссылку, фото или видео, сразу или по расписанию на срок до 90 дней вперёд из очереди easyCoexistence; list_social_posts читает опубликованные посты.
Наибольший размер файла фото, который Meta принимает для страницы; Meta советует держать PNG-файлы меньше 1 МБ, чтобы избежать пикселизации.
Типы файлов фото, которые Meta указывает для фото страницы: JPEG, BMP, PNG, GIF и TIFF.
Код ошибки, когда Meta не может получить видеофайл по URL, переданному в /{page-id}/videos.
Опубликованные ранжированные посты за год, которые API возвращает при чтении ленты страницы: не более 100 за запрос.
Что может содержать пост страницы?
Четыре вида контента через три эндпоинта страницы; посты публикуются от имени страницы. Текст и ссылки используют эндпоинт ленты, где обязательно поле message или link; у фото и видео есть каждый свой эндпоинт:
Как publish_facebook_post выбирает эндпоинт?
Выбирает по переданным полям. Если есть video_url, пост уходит в /videos, а message становится описанием; иначе, если есть image_url, пост уходит в /photos, а message становится текстом к фото; иначе message и link уходят в /feed. Ссылка передаётся только в текстовом посте, поэтому при фото или видео вставьте URL в message. Без scheduled_at пост уходит сразу, и результат содержит post_id, ID, который вернула Meta, и url, ссылку на него в Facebook; при указании scheduled_at easyCoexistence держит пост в своей очереди на срок от 1 минуты до 90 дней и публикует его в назначенное время.
Где должны находиться медиафайлы?
По адресу, который доступен Meta, потому что Meta сама забирает файл. Для фото url должен указывать на фото, уже загруженное в интернет; для видео file_url должен быть доступным URL файла, а видео, которое Meta не может получить, завершится ошибкой 389. Пост со ссылкой завершится ошибкой, если приложение не видит URL по ссылке, а ошибка 1609005 означает, что Meta не удалось извлечь данные по ссылке.
Какие файлы фото принимает Meta?
Файлы JPEG, BMP, PNG, GIF и TIFF размером до 10 МБ по данным справочника Meta по фото. Справочник рекомендует держать PNG-файлы меньше 1 МБ, так как большие могут выглядеть пикселизованными. Meta удаляет метаданные о местоположении перед публикацией и масштабирует изображения, чтобы отображать их в нескольких размерах. Отсутствующее или некорректное изображение завершится ошибкой 324.
Что нужно для видеопоста?
Файл, который Meta может скачать по file_url, и текст поста в description, который Meta может показывать вместе с постом; заголовок необязателен, publish_facebook_post оставляет его пустым. Обзор Video API от Meta указывает, что владелец токена должен иметь права, эквивалентные администраторским, на странице, а Resumable Upload API обрабатывает большие файлы и возобновляет прерванные загрузки.
Как читать и редактировать посты?
list_social_posts возвращает последние посты страницы: по умолчанию 25, и до 100 за вызов; у каждого поста есть ID, текст, время создания, постоянная ссылка (permalink) и картинка. Справочник Meta ограничивает чтение ленты 100 постами за запрос и возвращает примерно 600 ранжированных опубликованных постов в год. API Meta редактирует пост через POST /{page-post-id} с новым message, только для постов, созданных тем же приложением; в easyCoexistence для этого нет инструмента, поэтому пост редактируется на Facebook или в Meta Business Suite.
Распространённые ошибки
- Передача ссылки вместе с фото или видео. publish_facebook_post отказывает в ссылке рядом с файлом, поэтому, если в посте есть медиа, вставьте URL в message.
- Публикация одного и того же содержимого дважды подряд. Meta отклоняет подряд идущие одинаковые посты с ошибкой 506, поэтому измените текст перед повторной попыткой.
- Указание на файл за входом в аккаунт или на ссылку, срок действия которой истекает. Meta сама забирает фото или видео по URL, поэтому адрес должен оставаться публичным, пока пост не появится в ленте.
От US$ 9 до US$ 0,75 за подключение в месяц, по мере добавления подключений, с бесплатным пробным периодом на первые 3 дня.
Часто задаваемые вопросы
Можно ли опубликовать фото на Facebook-странице по URL?
Да. POST /{page-id}/photos принимает url, адрес фото, уже находящегося в интернете; Meta забирает его сама.
Почему пост на Facebook-странице завершается ошибкой 506?
Meta отклоняет подряд идущие одинаковые посты с ошибкой 506, поэтому измените текст перед повторной публикацией.
Может ли один пост на Facebook содержать несколько фото?
Не через easyCoexistence: publish_facebook_post принимает одно фото. Meta документирует посты с несколькими фото, которые собираются из фото, загруженных неопубликованными и прикреплённых к посту в ленте; его инструменты их не покрывают.
Можно ли отредактировать пост на Facebook-странице через API?
Да, через POST на ID поста, но только для постов, созданных тем же приложением. В easyCoexistence для этого нет инструмента, поэтому отредактируйте пост на Facebook или в Meta Business Suite.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на