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.
Параметр text у фото страницы; параметр message, который справка Meta по фото помечает там как устаревший, не нужен.
Заголовок ответа, в котором estimated_time_to_regain_access показывает, через сколько минут снова заработают ограниченные вызовы.
messaging_type для ответа на сообщение, которое получила страница, отправленного в пределах 24-часового окна обслуживания клиентов.
Как приватный ответ адресуется автору комментария через тот же эндпоинт /{page-id}/messages.
Что нужно примерам перед запуском?
ID страницы и токен доступа этой страницы, который берётся из /me/accounts с долгоживущим пользовательским токеном, а также Python 3 с библиотекой requests или Node.js 18 или новее, у которого встроенный fetch не требует пакетов. Каждой задаче также нужно разрешение в токене и задача на странице, а примеры вызывают Graph API v26.0:
Как опубликовать пост и фото на Python?
С помощью одной вспомогательной функции, которую используют следующие примеры: graph() добавляет токен страницы, отправляет параметры GET в строке запроса, а поля POST как JSON, как это делают собственные примеры Meta, и превращает объект ошибки Meta в GraphError с полями code и error_subcode. Она ждёт и повторяет запрос только при временных кодах и кодах ограничения частоты, столько времени, сколько просит заголовок X-Business-Use-Case-Usage, когда он приходит, а остальные ошибки выбрасывает сразу.
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 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 ведёт назад, к более ранним записям.
# 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 комментариев, на которые вы ответили, чтобы повторный запуск не отвечал дважды.
// 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 дней.
# 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-часовом окне, как только человек напишет в ответ.
// 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 считает реакции, комментарии и репосты.
# 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.
// 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.
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, которое идёт до любого события.
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() повторяет временные коды и коды ограничения частоты, а остальные передаёт вызывающему коду для обработки:
Как запустить те же задачи через easyCoexistence?
Как инструменты MCP, которые Claude, ChatGPT или ваш собственный агент вызывают на подключённой странице, при этом токен хранится в easyCoexistence. Токены страниц никогда не выдаются, поэтому примеры выше работают с токеном вашего собственного приложения Meta; get_social_credentials возвращает ID страницы и базовый адрес Graph API. Инструмент для каждой задачи:
Распространённые ошибки
- Вызовы эндпоинтов страницы с пользовательским токеном. Большинство из них ожидает собственный токен страницы, а вызовы с пользовательским токеном или токеном приложения расходуют лимиты частоты, которые должны идти на страницу.
- Публикация одного и того же текста подряд. Meta отклоняет идущие подряд одинаковые посты с ошибкой 506, поэтому задача, которая перезапускается, должна менять содержимое или пропускать пост.
- Сложение ежедневных уникальных зрителей. page_total_media_view_unique считает уникальных зрителей в каждом периоде, поэтому ежедневные значения не складываются в месяц; запросите вместо этого period days_28.
- Передача токена страницы в браузер или приложение. Эти вызовы должны выполняться на сервере, где токен недоступен никому, кто может прочитать клиентскую часть.
От 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 входят в стоимость.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на