ВойтиНачать бесплатный пробный период
easyCoexistence Официальные API

API страниц Facebook на Python и Node.js: рабочие примеры

Python и Node.js вызывают API страниц Facebook как обычные HTTPS-запросы к graph.facebook.com/v26.0 с токеном доступа страницы: POST /{page-id}/feed и /{page-id}/photos публикуют, /{post-id}/comments читает и отвечает на комментарии, POST /{page-id}/messages отвечает в Messenger, GET /{page-id}/insights читает метрики, а HMAC-SHA256 от исходного тела проверяет X-Hub-Signature-256 в каждом вебхуке.

easyCoexistence предоставляет подключённой странице эти задачи как инструменты MCP, от publish_facebook_post и reply_to_comment до send_social_dm и get_social_insights, пересылает события страницы, подписанные X-EC-Signature, и передаёт вашему коду ID страницы и базовый адрес API через get_social_credentials.

caption

Параметр text у фото страницы; параметр message, который справка Meta по фото помечает там как устаревший, не нужен.

X-Business-Use-Case-Usage

Заголовок ответа, в котором estimated_time_to_regain_access показывает, через сколько минут снова заработают ограниченные вызовы.

RESPONSE

messaging_type для ответа на сообщение, которое получила страница, отправленного в пределах 24-часового окна обслуживания клиентов.

recipient.comment_id

Как приватный ответ адресуется автору комментария через тот же эндпоинт /{page-id}/messages.

Что нужно примерам перед запуском?

ID страницы и токен доступа этой страницы, который берётся из /me/accounts с долгоживущим пользовательским токеном, а также Python 3 с библиотекой requests или Node.js 18 или новее, у которого встроенный fetch не требует пакетов. Каждой задаче также нужно разрешение в токене и задача на странице, а примеры вызывают Graph API v26.0:

Publish a post or photoPOST /{page-id}/feed and /{page-id}/photos: pages_manage_posts, CREATE_CONTENT
Read and reply to comments/{post-id}/comments and /{comment-id}/comments: pages_manage_engagement, MODERATE
Reply in MessengerPOST /{page-id}/messages: pages_messaging, MESSAGING
Read insightsGET /{page-id}/insights: read_insights, pages_read_engagement, ANALYZE
Check a webhookX-Hub-Signature-256, with the app secret and no token

Как опубликовать пост и фото на Python?

С помощью одной вспомогательной функции, которую используют следующие примеры: graph() добавляет токен страницы, отправляет параметры GET в строке запроса, а поля POST как JSON, как это делают собственные примеры Meta, и превращает объект ошибки Meta в GraphError с полями code и error_subcode. Она ждёт и повторяет запрос только при временных кодах и кодах ограничения частоты, столько времени, сколько просит заголовок X-Business-Use-Case-Usage, когда он приходит, а остальные ошибки выбрасывает сразу.

Python: graph(), then a post and a photo
import json, os, time
import requests

GRAPH = "https://graph.facebook.com/v26.0"
PAGE_ID = os.environ["PAGE_ID"]
PAGE_TOKEN = os.environ["PAGE_TOKEN"]  # the Page's own token, from /me/accounts
RETRY = {1, 2, 4, 17, 32, 613, 80001}   # temporary or rate limited


class GraphError(Exception):
    def __init__(self, err):
        super().__init__(err.get("message"))
        self.code, self.subcode = err.get("code"), err.get("error_subcode")


def wait_seconds(response, attempt):
    usage = json.loads(response.headers.get("x-business-use-case-usage", "{}"))
    minutes = [u.get("estimated_time_to_regain_access", 0) for v in usage.values() for u in v]
    return max([60 * m for m in minutes] + [30 * 2 ** attempt])


def graph(method, path, retries=3, **fields):
    fields["access_token"] = PAGE_TOKEN
    send = {"params": fields} if method == "GET" else {"json": fields}
    for attempt in range(retries + 1):
        response = requests.request(method, f"{GRAPH}/{path}", timeout=30, **send)
        body = response.json()
        if "error" not in body:
            return body
        err = GraphError(body["error"])
        if err.code not in RETRY or attempt == retries:
            raise err
        time.sleep(wait_seconds(response, attempt))


post = graph("POST", f"{PAGE_ID}/feed", message="Open until 11pm this Friday.")
photo = graph("POST", f"{PAGE_ID}/photos",
              url="https://example.com/menu.jpg", caption="This week's menu")
print(post["id"], photo["post_id"])

Как опубликовать их на Node.js?

С той же вспомогательной функцией на Node.js 18 или новее, сохранённой как файл .mjs, чтобы работал top-level await, и со встроенным fetch вместо клиентской библиотеки. Вызов фото передаёт url и caption, то есть поле text эндпоинта photos; Meta отвечает id фото и post_id поста страницы, который содержит фото, а вызов для ленты отвечает только id поста.

Node.js: graph(), then a post and a photo
// Node.js 18 or later, saved as an .mjs file: fetch and top-level await are built in.
const GRAPH = "https://graph.facebook.com/v26.0";
const { PAGE_ID, PAGE_TOKEN } = process.env; // the Page's own token, from /me/accounts
const RETRY = new Set([1, 2, 4, 17, 32, 613, 80001]); // temporary or rate limited

class GraphError extends Error {
  constructor(err) {
    super(err.message);
    this.code = err.code;
    this.subcode = err.error_subcode;
  }
}

function waitMs(response, attempt) {
  const usage = JSON.parse(response.headers.get("x-business-use-case-usage") ?? "{}");
  const minutes = Object.values(usage).flat().map((u) => u.estimated_time_to_regain_access ?? 0);
  return Math.max(30_000 * 2 ** attempt, ...minutes.map((m) => m * 60_000));
}

async function graph(method, path, fields = {}, retries = 3) {
  const url = new URL(`${GRAPH}/${path}`);
  const init = { method };
  const all = { ...fields, access_token: PAGE_TOKEN };
  if (method === "GET") {
    for (const [key, value] of Object.entries(all)) url.searchParams.set(key, String(value));
  } else {
    init.headers = { "Content-Type": "application/json" };
    init.body = JSON.stringify(all);
  }
  for (let attempt = 0; ; attempt++) {
    const response = await fetch(url, init);
    const body = await response.json();
    if (!body.error) return body;
    if (!RETRY.has(body.error.code) || attempt === retries) throw new GraphError(body.error);
    await new Promise((done) => setTimeout(done, waitMs(response, attempt)));
  }
}

const post = await graph("POST", `${PAGE_ID}/feed`, { message: "Open until 11pm this Friday." });
const photo = await graph("POST", `${PAGE_ID}/photos`, {
  url: "https://example.com/menu.jpg",
  caption: "This week's menu",
});
console.log(post.id, photo.post_id);

Как читать и отвечать на комментарии на Python?

Комментарии к посту читаются через fields, filter=stream для комментариев всех уровней по времени и order=reverse_chronological для самых новых сверху. Затем ответ от имени страницы отправляется POST-запросом на эндпоинт comments этого комментария. Токен должен принадлежать тому, кто может выполнять задачу MODERATE, иначе Meta не возвращает ID комментариев, а для ответа нужно разрешение pages_manage_engagement. paging.next ведёт назад, к более ранним записям.

Python: read a post's comments and reply to the questions
# graph() as in the first example
post_id = post["id"]  # {page-id}_{post-id}, as the publish call returned it
page = graph("GET", f"{post_id}/comments", fields="id,message,created_time,can_reply_privately",
             filter="stream", order="reverse_chronological", limit=50)
for comment in page["data"]:
    if "?" in comment.get("message", ""):
        graph("POST", f"{comment['id']}/comments",
              message="Thanks for asking! Our hours are on the Page.")
older = page.get("paging", {}).get("next")  # follow it to read further back

Как читать и отвечать на комментарии на Node.js?

Те же два вызова, а строку запроса собирает объект URL: GET с fields, filter и order, затем POST на /{comment-id}/comments. can_reply_privately, запрошенное в fields, показывает, может ли страница всё ещё отправить этому автору комментария приватный ответ, и это стоит знать до примера с Messenger ниже. Сохраняйте ID комментариев, на которые вы ответили, чтобы повторный запуск не отвечал дважды.

Node.js: read a post's comments and reply to the questions
// graph() as in the first example
const postId = post.id; // {page-id}_{post-id}, as the publish call returned it
const page = await graph("GET", `${postId}/comments`, {
  fields: "id,message,created_time,can_reply_privately",
  filter: "stream",
  order: "reverse_chronological",
  limit: 50,
});
for (const comment of page.data) {
  if ((comment.message ?? "").includes("?")) {
    await graph("POST", `${comment.id}/comments`, {
      message: "Thanks for asking! Our hours are on the Page.",
    });
  }
}
const older = page.paging?.next; // follow it to read further back

Как отправить ответ в Messenger на Python?

POST на /{page-id}/messages с recipient.id, равным ID человека, привязанному к странице из вебхука сообщений, messaging_type RESPONSE и текстом. Пример перехватывает два отказа, которые не стоит повторять: ошибку 10 с подкодом 2534022 или 2018278, когда 24-часовое окно закрылось, и 551, когда человек недоступен. Функция private_reply() подставляет recipient.comment_id вместо ID; это единственное сообщение, которое разрешает комментарий, в течение 7 дней.

Python: a Messenger reply and a private reply
# graph(), GraphError and PAGE_ID as in the first example
def reply(psid, text):
    """psid: sender.id from the messages webhook, within 24 hours of the person's message."""
    try:
        return graph("POST", f"{PAGE_ID}/messages", recipient={"id": psid},
                     messaging_type="RESPONSE", message={"text": text})
    except GraphError as e:
        if (e.code == 10 and e.subcode in (2534022, 2018278)) or e.code == 551:
            return None  # the window has closed, or the person is unavailable: no retry
        raise


def private_reply(comment_id, text):
    """One Messenger message to the person who commented, within 7 days of the comment."""
    return graph("POST", f"{PAGE_ID}/messages", recipient={"comment_id": comment_id},
                 message={"text": text})

Как отправить ответ в Messenger на Node.js?

То же тело запроса на JavaScript: recipient, messaging_type и message отправляются как JSON функцией graph(). Meta на принятую отправку отвечает recipient_id и message_id, их стоит сохранить вместе с перепиской. Приватный ответ содержит ссылку на комментарий, на который отвечает, а переписка продолжается в стандартном 24-часовом окне, как только человек напишет в ответ.

Node.js: a Messenger reply and a private reply
// graph(), GraphError and PAGE_ID as in the first example
async function reply(psid, text) {
  // psid: sender.id from the messages webhook, within 24 hours of the person's message
  try {
    return await graph("POST", `${PAGE_ID}/messages`, {
      recipient: { id: psid },
      messaging_type: "RESPONSE",
      message: { text },
    });
  } catch (e) {
    const closed =
      e instanceof GraphError && ((e.code === 10 && [2534022, 2018278].includes(e.subcode)) || e.code === 551);
    if (closed) return null; // the window has closed, or the person is unavailable: no retry
    throw e;
  }
}

function privateReply(commentId, text) {
  // one Messenger message to the person who commented, within 7 days of the comment
  return graph("POST", `${PAGE_ID}/messages`, {
    recipient: { comment_id: commentId },
    message: { text },
  });
}

Как читать инсайты страницы на Python?

GET на /{page-id}/insights со списком метрик через запятую, period=day и окном since и until в секундах UNIX; один запрос охватывает до 90 дней. Три метрики пришли на смену выведенным из употребления: page_media_view вместо page_impressions, page_total_media_view_unique вместо page_impressions_unique и page_follows вместо page_fans. page_post_engagements считает реакции, комментарии и репосты.

Python: four Page metrics for the last 28 days
# graph() and PAGE_ID as in the first example
until = int(time.time())
since = until - 28 * 86400  # one request can cover up to 90 days
metrics = "page_media_view,page_total_media_view_unique,page_post_engagements,page_follows"
data = graph("GET", f"{PAGE_ID}/insights", metric=metrics, period="day", since=since, until=until)
for metric in data["data"]:
    for point in metric["values"]:
        print(metric["name"], point["end_time"][:10], point["value"])

Как читать инсайты страницы на Node.js?

Тот же вызов, а since и until считаются из Date.now() в секундах. Каждая метрика возвращается с именем, периодом и списком values из пар value и end_time, по одной на день. При заданном since первый end_time приходится на день после него, поэтому данные этого дня включаются. Токену нужны read_insights и pages_read_engagement от человека с задачей ANALYZE.

Node.js: four Page metrics for the last 28 days
// graph() and PAGE_ID as in the first example
const until = Math.floor(Date.now() / 1000);
const since = until - 28 * 86400; // one request can cover up to 90 days
const data = await graph("GET", `${PAGE_ID}/insights`, {
  metric: "page_media_view,page_total_media_view_unique,page_post_engagements,page_follows",
  period: "day",
  since,
  until,
});
for (const metric of data.data) {
  for (const point of metric.values) {
    console.log(metric.name, point.end_time.slice(0, 10), point.value);
  }
}

Как проверить подпись вебхука на Python?

Пересчитайте X-Hub-Signature-256 из исходного тела запроса и секрета приложения, затем сравните два значения за постоянное время. Meta подписывает каждый POST через HMAC-SHA256 от полезной нагрузки, ключом служит App Secret из базовых настроек App Dashboard, а результат записывается после sha256=. Передавайте тело в виде bytes до любого разбора JSON: request.body в Django и await request.body() в FastAPI дают именно те байты, которые подписала Meta.

Python: check X-Hub-Signature-256
import hashlib, hmac, os

APP_SECRET = os.environ["APP_SECRET"].encode()  # App Dashboard, Settings, Basic


def signed_by_meta(raw_body: bytes, header: str) -> bool:
    """raw_body: the request body exactly as received. header: X-Hub-Signature-256."""
    expected = "sha256=" + hmac.new(APP_SECRET, raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected.encode(), (header or "").encode())

# Django:  signed_by_meta(request.body, request.headers.get("X-Hub-Signature-256"))
# FastAPI: signed_by_meta(await request.body(), request.headers.get("X-Hub-Signature-256"))

Как проверить подпись вебхука на Node.js?

Та же проверка с node:crypto, которому нужно тело в виде Buffer: в Express express.raw оставляет его неразобранным на этом маршруте. timingSafeEqual выбрасывает исключение при входах разной длины, поэтому проверка длины идёт первой. Отвечайте 200 быстро, а работу делайте потом, так как Meta повторяет неудачные доставки и может прислать событие дважды. Страница проверки описывает рукопожатие hub.challenge, которое идёт до любого события.

Node.js: check X-Hub-Signature-256
import crypto from "node:crypto";

const APP_SECRET = process.env.APP_SECRET; // App Dashboard, Settings, Basic

function signedByMeta(rawBody, header = "") {
  // rawBody: a Buffer holding the request body exactly as received. header: X-Hub-Signature-256
  const digest = crypto.createHmac("sha256", APP_SECRET).update(rawBody).digest("hex");
  const expected = Buffer.from(`sha256=${digest}`);
  const given = Buffer.from(header);
  return given.length === expected.length && crypto.timingSafeEqual(given, expected);
}

// Express: app.post("/webhook", express.raw({ type: "application/json" }), (req, res) => {
//   if (!signedByMeta(req.body, req.get("X-Hub-Signature-256"))) return res.sendStatus(401);
//   res.sendStatus(200); // then work on JSON.parse(req.body) after answering
// });

Какие коды ошибок стоит обрабатывать?

Те, которые справочники Meta по ошибкам различают, потому что каждому нужен свой ответ: повтор при отклонённом токене или неверном параметре снова даёт ошибку, а ограниченный вызов удаётся после ожидания. graph() повторяет временные коды и коды ограничения частоты, а остальные передаёт вызывающему коду для обработки:

190, 102The token was refused, and the subcode says why. A new sign-in is the fix
10, 200 to 299A permission was not granted or was removed. Grant it again
4, 17, 32, 613An app, user or Page rate limit. Stop, wait, then resume gradually
80001Page calls made with a Page token are throttled; the header gives the minutes
368Blocked for policy violations. Wait, and review what was being sent
100An invalid parameter. Fix the request before sending it again
551The person is not available on Messenger. Do not retry
1, 2A temporary issue on Meta's side. Wait and retry

Как запустить те же задачи через easyCoexistence?

Как инструменты MCP, которые Claude, ChatGPT или ваш собственный агент вызывают на подключённой странице, при этом токен хранится в easyCoexistence. Токены страниц никогда не выдаются, поэтому примеры выше работают с токеном вашего собственного приложения Meta; get_social_credentials возвращает ID страницы и базовый адрес Graph API. Инструмент для каждой задачи:

Publishpublish_facebook_post with message, link, image_url or video_url, now or at scheduled_at
Commentslist_social_comments, then reply_to_comment; private set to true sends the one Messenger message
Messengersend_social_dm, with recipient_id set to the sender's ID from the forwarded event
Insightsget_social_insights with metrics and a period, or object_id for one post
Eventsset_social_webhook_destination; each forward carries X-EC-Signature, made with the Page's own secret

Распространённые ошибки

  • Вызовы эндпоинтов страницы с пользовательским токеном. Большинство из них ожидает собственный токен страницы, а вызовы с пользовательским токеном или токеном приложения расходуют лимиты частоты, которые должны идти на страницу.
  • Публикация одного и того же текста подряд. Meta отклоняет идущие подряд одинаковые посты с ошибкой 506, поэтому задача, которая перезапускается, должна менять содержимое или пропускать пост.
  • Сложение ежедневных уникальных зрителей. page_total_media_view_unique считает уникальных зрителей в каждом периоде, поэтому ежедневные значения не складываются в месяц; запросите вместо этого period days_28.
  • Передача токена страницы в браузер или приложение. Эти вызовы должны выполняться на сервере, где токен недоступен никому, кто может прочитать клиентскую часть.
Настройка с EasyCoexistence

От US$ 9 до US$ 0,75 за подключение в месяц, снижаясь по мере добавления подключений, первые 3 дня бесплатно.

Часто задаваемые вопросы

Нужен ли SDK для вызова API страниц Facebook?

Нет. Graph API работает через HTTPS с JSON, поэтому запросов в Python и встроенного fetch в Node.js 18 или новее достаточно, как показывают примеры на этой странице.

Может ли тот же код публиковать на несколько страниц?

Да. /me/accounts возвращает отдельный токен для каждой страницы, поэтому храните по одному на страницу и передавайте соответствующие PAGE_ID и PAGE_TOKEN; вызовы с токеном страницы расходуют лимит частоты этой страницы.

Откуда берётся PSID для ответа в Messenger?

Из вебхука сообщений: sender.id в каждом событии messaging это ID человека в рамках страницы, уникальный для этого человека и страницы. ID пользователей из Facebook Login привязаны к приложению и не работают с Messenger Platform.

Сколько стоит easyCoexistence для страницы Facebook?

Каждая подключённая страница считается одним подключением: от US$ 9 до US$ 0,75 за подключение в месяц в зависимости от количества подключений, первые 3 дня бесплатны, а инструменты MCP входят в стоимость.

Читайте дальше

Руководство по Facebook Pages API на 2026 год: от приложения до первой публикацииПуть Facebook Pages API в 2026 году по шагам: приложение Meta, вход через Facebook Login for Business, токен Страницы, первый пост и вебхуки.Верификация вебхука Facebook: hub.challenge и X-Hub-Signature-256Верификация вебхука Facebook: вернуть hub.challenge при совпадении hub.verify_token, затем проверять X-Hub-Signature-256 каждого события по App Secret.Метрики Facebook Page Insights в 2026 году: какие работают и какие Meta отключилаКакие метрики Facebook Page Insights работают в конце 2026 года, а какие Meta отключила, с датами: page_impressions, page_fans, охват и другие.Теги сообщений Messenger в 2026 году: что может отправить страница Facebook после окна 24 часаЧто может отправить страница Facebook после 24-часового окна Messenger в 2026 году: HUMAN_AGENT, CUSTOMER_FEEDBACK, три отключённых тега и замены.Почему подключение Facebook Page API перестаёт работать и как его сохранитьПричины, по которым токен Страницы Facebook или вебхук перестаёт работать, ошибка для каждой, как заметить сбой заранее и переподключить Страницу.Изменения Facebook Graph API в 2026: что перестало работать и что делатьИзменения Facebook Graph API в 2026: v26.0, снятые версии, изменения протокола, устаревшие метрики Страниц, теги сообщений и решение для каждого.

Подключите первый канал за две минуты.

Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.

  • 3 дня бесплатно
  • Отмена в любой момент
  • Только официальные API
  • Мониторинг 24/7

Проверено по состоянию на