Facebook Pages API u Pythonu i Node.js: radni primjeri
Python i Node.js pozivaju Facebook Pages API kao obične HTTPS zahtjeve na graph.facebook.com/v26.0 s pristupnim tokenom stranice: POST /{page-id}/feed i /{page-id}/photos objavljuju, /{post-id}/comments čita i odgovara na komentare, POST /{page-id}/messages odgovara u Messengeru, GET /{page-id}/insights čita metrike, a HMAC-SHA256 nad sirovim tijelom zahtjeva provjerava X-Hub-Signature-256 na svakom webhooku.
easyCoexistence daje povezanoj stranici ove zadaće kao MCP alate, od publish_facebook_post i reply_to_comment do send_social_dm i get_social_insights, prosljeđuje svoje događaje potpisane s X-EC-Signature i vašem vlastitom kodu predaje ID stranice i osnovnu adresu API-ja putem get_social_credentials.
Parametar text za fotografiju stranice; Metina referenca za fotografije tamo označava parametar message zastarjelim.
Zaglavlje odgovora čiji estimated_time_to_regain_access daje minute do ponovnog rada ograničenih poziva.
messaging_type za odgovor na poruku koju je stranica primila, poslan unutar 24-satnog prozora.
Kako privatni odgovor adresira osobu koja je komentirala, preko istog /{page-id}/messages endpointa.
Što primjeri trebaju prije pokretanja?
ID stranice i pristupni token te stranice, pročitan iz /me/accounts uz dugotrajni korisnički token, plus Python 3 s bibliotekom requests ili Node.js 18 ili noviji, čiji ugrađeni fetch ne treba nikakav paket. Svaka zadaća također treba svoje dopuštenje na tokenu i svoj zadatak na stranici, a primjeri pozivaju Graph API v26.0:
Kako objaviti objavu i fotografiju u Pythonu?
Jednom pomoćnom funkcijom koju kasniji primjeri ponovno koriste: graph() dodaje token stranice, šalje GET parametre u upitnom nizu, a POST polja kao JSON, kao što to rade Metini vlastiti primjeri, te Metin objekt pogreške pretvara u GraphError s kodom i error_subcode. Čeka i ponovno pokušava samo privremene kodove i kodove ograničenja brzine, onoliko dugo koliko to traži X-Business-Use-Case-Usage kad se to zaglavlje vrati, a ostale odmah prosljeđuje pozivatelju.
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"])Kako objaviti u Node.js?
Istom pomoćnom funkcijom u Node.js 18 ili novijem, spremljenom kao datoteka .mjs da bi await na najvišoj razini radio, a ugrađeni fetch zamjenjuje klijentsku biblioteku. Poziv za fotografiju šalje url i caption, polje text na edgeu photos; Meta odgovara id-jem fotografije i post_id-jem objave stranice koja nosi fotografiju, dok poziv za feed odgovara samo id-jem objave.
// 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);Kako čitati i odgovarati na komentare u Pythonu?
Komentari objave čitaju se s fields, filter=stream za komentare na svim razinama po vremenu i order=reverse_chronological za najnovije prvo, zatim se odgovara kao stranica slanjem odgovora na edge comments komentara. Token mora dolaziti od nekoga tko može obavljati MODERATE, inače Meta izostavlja ID-jeve komentara, a za odgovor treba pages_manage_engagement. paging.next vodi dalje unatrag.
# 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 backKako čitati i odgovarati na komentare u Node.js?
Ista dva poziva, s URL objektom koji gradi upitni niz: GET s fields, filter i order, zatim POST na /{comment-id}/comments. can_reply_privately, zatražen u fields, kaže može li stranica tom komentatoru još poslati privatni odgovor, što valja znati prije primjera Messengera ispod. Čuvajte ID-jeve komentara na koje ste odgovorili, kako ponovno pokretanje ne bi odgovorilo dvaput.
// 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 backKako poslati odgovor u Messengeru u Pythonu?
POST /{page-id}/messages s recipient.id postavljenim na ID osobe vezan uz stranicu iz webhooka poruka, messaging_type RESPONSE i text. Primjer hvata dva odbijanja koja ne vrijedi ponovno pokušavati: pogreška 10 s podkodom 2534022 ili 2018278 kad je 24-satni prozor zatvoren, te 551 kad osoba nije dostupna. private_reply() umjesto ID-ja stavlja recipient.comment_id, za jednu poruku koju komentar dopušta u roku od 7 dana.
# 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})Kako poslati odgovor u Messengeru u Node.js?
Isto tijelo zahtjeva u JavaScriptu, s recipient, messaging_type i message koje graph() šalje kao JSON. Meta na prihvaćeno slanje odgovara recipient_id i message_id, što vrijedi spremiti uz razgovor. Privatni odgovor nosi poveznicu natrag na komentar na koji odgovara, a razgovor se nastavlja u standardnom 24-satnom prozoru čim osoba ponovno napiše.
// 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 },
});
}Kako čitati uvide stranice u Pythonu?
GET /{page-id}/insights s popisom metrika odvojenim zarezom, period=day i prozorom since i until u sekundama od UNIX epohe; jedan zahtjev pokriva do 90 dana. Tri ove metrike preuzele su mjesto metrika koje je Meta ukinula: page_media_view od page_impressions, page_total_media_view_unique od page_impressions_unique i page_follows od page_fans, dok page_post_engagements broji reakcije, komentare i dijeljenja.
# 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"])Kako čitati uvide stranice u Node.js?
Isti poziv, s since i until izračunatima iz Date.now() u sekundama. Svaka metrika vraća se s imenom, periodom i popisom values s parovima value i end_time, po jedan za svaki dan; kad je postavljen since, prvi end_time pada na dan nakon njega, pa su podaci tog dana uključeni. Token treba read_insights i pages_read_engagement, od nekoga sa zadatkom 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);
}
}Kako provjeriti potpis webhooka u Pythonu?
Ponovno izračunajte X-Hub-Signature-256 iz sirovog tijela zahtjeva i tajne aplikacije, zatim ih usporedite u konstantnom vremenu. Meta potpisuje svaki POST s HMAC-SHA256 payloada, ključem App Secret iz osnovnih postavki aplikacije u Meta konzoli, i zapisuje ga iza sha256=. Tijelo proslijedite kao bajtove, prije svake JSON obrade: request.body u Djangu i await request.body() u FastAPI-ju daju bajtove koje je Meta potpisao.
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"))Kako provjeriti potpis webhooka u Node.js?
Ista provjera s node:crypto, koji traži tijelo kao Buffer: u Expressu express.raw ga na toj ruti ostavlja neobrađenim. timingSafeEqual baca grešku za ulaze različitih duljina, pa se provjera duljine radi prva. Odgovorite brzo s 200, a posao odradite poslije, jer Meta ponavlja neuspjele isporuke i može poslati događaj dvaput; stranica za provjeru pokriva rukovanje hub.challenge koje dolazi prije svakog događaja.
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
// });Na koje kôdove pogrešaka treba reagirati?
One koje razlikuju Metini vodiči za pogreške, jer svaka traži drugačiji odgovor: ponovno pokušavanje odbijenog tokena ili neispravnog parametra samo ponovno propada, dok ograničeni poziv uspijeva nakon čekanja. graph() ponovno pokušava privremene kodove i kodove ograničenja brzine, a ostale prosljeđuje pozivatelju da ih obradi:
Kako pokrenuti iste zadaće kroz easyCoexistence?
Kao MCP alati koje Claude, ChatGPT ili vaš vlastiti agent poziva na povezanoj stranici, pri čemu token čuva easyCoexistence. Tokeni stranice se nikada ne daju, pa se primjeri gore pokreću s tokenom iz vaše vlastite Meta aplikacije; get_social_credentials vraća ID stranice i bazu Graph API-ja. Alat svake zadaće:
Uobičajene pogreške
- Pozivanje stranica s korisničkim tokenom. Većina njih očekuje vlastiti token stranice, a pozivi s korisničkim ili aplikacijskim tokenom troše ograničenje brzine umjesto ograničenja same stranice.
- Objavljivanje istog teksta dvaput zaredom. Meta odbija uzastopne duplicirane objave pogreškom 506, pa zadaća koja se ponovno pokreće mora mijenjati sadržaj ili preskočiti objavu.
- Zbrajanje dnevnih jedinstvenih gledatelja. page_total_media_view_unique broji jedinstvene gledatelje u svakom periodu, pa se dnevne vrijednosti ne zbrajaju u mjesec; umjesto toga zatražite period days_28.
- Slanje tokena stranice u preglednik ili aplikaciju. Ovi pozivi pripadaju poslužitelju, gdje token ostaje izvan dosega svakoga tko može čitati klijenta.
US$ 9 do US$ 0.75 po vezi mjesečno, uz pad kako dodajete veze, s prva 3 dana besplatno.
Često postavljana pitanja
Trebam li SDK za pozivanje Facebook Pages API-ja?
Ne. Graph API je HTTPS s JSON-om, pa su zahtjevi u Pythonu i fetch ugrađen u Node.js 18 ili noviji dovoljni, kao što primjeri na ovoj stranici pokazuju.
Može li isti kôd objavljivati na više stranica?
Može. /me/accounts vraća zaseban token za svaku stranicu, pa držite po jedan za svaku i proslijedite odgovarajuće PAGE_ID i PAGE_TOKEN; pozivi s tokenom stranice troše ograničenje brzine te stranice.
Odakle dolazi PSID za odgovor u Messengeru?
Iz webhooka poruka: sender.id u svakom događaju za poruke je ID osobe vezan uz stranicu, jedinstven za tu osobu i stranicu. ID-jevi korisnika dobiveni prijavom na Facebook vezani su uz aplikaciju i ne rade uz Messenger Platform.
Koliko košta easyCoexistence za Facebook stranicu?
Svaka povezana stranica broji se kao jedna veza, po cijeni od US$ 9 do US$ 0.75 po vezi mjesečno ovisno o broju veza, a prva 3 dana su besplatna; MCP alati dolaze uz to.
Nastavite čitati
Povežite svoj prvi kanal u dvije minute.
Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo službeni API-ji
- Nadzor 24/7
Provjereno na