Facebook Pages API σε Python και Node.js: λειτουργικά παραδείγματα
Python και Node.js καλούν το Facebook Pages API ως απλά αιτήματα HTTPS στο graph.facebook.com/v26.0 με το access token της Σελίδας: 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 σε κάθε webhook.
Το easyCoexistence δίνει σε μια συνδεδεμένη Σελίδα αυτές τις εργασίες ως εργαλεία MCP, από το publish_facebook_post και το reply_to_comment έως το send_social_dm και το get_social_insights, προωθεί τα γεγονότα του υπογεγραμμένα με X-EC-Signature, και δίνει στον δικό σας κώδικα το ID της Σελίδας και τη βάση του API μέσω της get_social_credentials.
Το πεδίο text μιας φωτογραφίας Σελίδας· η αναφορά φωτογραφιών της Meta σημειώνει το message ως παρωχημένο εκεί.
Κεφαλίδα απόκρισης, της οποίας το estimated_time_to_regain_access δίνει τα λεπτά μέχρι να λειτουργήσουν ξανά οι κλήσεις με περιορισμό.
Το messaging_type για απάντηση σε μήνυμα που έλαβε η Σελίδα, στάλμενο εντός του παραθύρου 24 ωρών.
Πώς μια ιδιωτική απάντηση απευθύνεται στο άτομο που σχολίασε, μέσω του ίδιου endpoint /{page-id}/messages.
Τι χρειάζονται τα παραδείγματα πριν τρέξουν;
Ένα Page ID και το access token της συγκεκριμένης Σελίδας, που διαβάζονται από το /me/accounts με long-lived user token, καθώς και Python 3 με requests ή Node.js 18 ή νεότερο, του οποίου το ενσωματωμένο fetch δεν χρειάζεται πακέτο. Κάθε εργασία χρειάζεται επίσης το δικαίωμά της στο token και την αντίστοιχη εργασία της στη Σελίδα, και τα παραδείγματα καλούν το Graph API v26.0:
Πώς δημοσιεύετε μια ανάρτηση και μια φωτογραφία σε Python;
Με μία βοηθητική συνάρτηση που ξαναχρησιμοποιούν τα επόμενα παραδείγματα: η graph() προσθέτει το token της Σελίδας, στέλνει τις παραμέτρους GET στο query string και τα πεδία 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 του edge photos· η Meta απαντά με το id της φωτογραφίας και το post_id της ανάρτησης της Σελίδας που περιέχει τη φωτογραφία, ενώ η κλήση feed απαντά μόνο με το 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 για τα νεότερα πρώτα, και μετά απαντάτε ως Σελίδα στέλνοντας μήνυμα στο edge comments του ίδιου του σχολίου. Το token πρέπει να προέρχεται από κάποιον που μπορεί να εκτελέσει το MODERATE, αλλιώς η Meta παραλείπει τα comment IDs, και η απάντηση χρειάζεται το 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 να χτίζει το query string: ένα GET με fields, filter και order, και μετά ένα POST στο /{comment-id}/comments. Το can_reply_privately, που ζητείται στα fields, δείχνει αν η Σελίδα μπορεί ακόμα να στείλει στον σχολιαστή ιδιωτική απάντηση, κάτι χρήσιμο να ξέρετε πριν από το παράδειγμα Messenger παρακάτω. Κρατάτε τα IDs των σχολίων που έχετε απαντήσει, ώστε η επανεκτέλεση να μην απαντά δύο φορές.
// 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 ίσο με το Page-scoped ID του ατόμου από το webhook των μηνυμάτων, messaging_type RESPONSE και το text. Το παράδειγμα πιάνει τις δύο αρνήσεις που δεν αξίζει να ξαναδοκιμαστούν: το σφάλμα 10 με subcode 2534022 ή 2018278, όταν έχει κλείσει το παράθυρο 24 ωρών, και το 551, όταν το άτομο δεν είναι διαθέσιμο. Η private_reply() βάζει στη θέση του ID το recipient.comment_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 },
});
}Πώς διαβάζετε τα insights της Σελίδας σε Python;
GET στο /{page-id}/insights με λίστα μετρικών χωρισμένων με κόμμα, period=day και παράθυρο since και until σε δευτερόλεπτα UNIX· ένα αίτημα καλύπτει έως 90 ημέρες. Τρεις από αυτές τις μετρικές αντικατέστησαν άλλες που η Meta έχει αποσύρει: το 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"])Πώς διαβάζετε τα insights της Σελίδας σε Node.js;
Η ίδια κλήση, με τα since και until να υπολογίζονται από το Date.now() σε δευτερόλεπτα. Κάθε μετρική επιστρέφει το όνομά της, την περίοδό της και μια λίστα values με ζεύγη value και end_time, ένα για κάθε ημέρα· όταν έχει οριστεί το since, το πρώτο end_time πέφτει την επόμενη ημέρα, ώστε να περιλαμβάνονται τα δεδομένα εκείνης της ημέρας. Το token χρειάζεται 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);
}
}Πώς ελέγχετε την υπογραφή webhook σε Python;
Υπολογίζετε ξανά το X-Hub-Signature-256 από το ακατέργαστο σώμα του αιτήματος και το app secret, και συγκρίνετε τα δύο σε σταθερό χρόνο. Η Meta υπογράφει κάθε POST με HMAC-SHA256 του payload, κλειδωμένο με το App Secret από τις βασικές ρυθμίσεις του App Dashboard, και το γράφει μετά το sha256=. Περνάτε το σώμα ως bytes, πριν από οποιαδήποτε ανάλυση JSON: το request.body στο Django και το await request.body() στο FastAPI δίνουν τα bytes που υπέγραψε η 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"))Πώς ελέγχετε την υπογραφή webhook σε 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, επειδή ο καθένας θέλει διαφορετική απόκριση: η επανάληψη ενός απορριφθέντος token ή μιας λανθασμένης παραμέτρου αποτυγχάνει ξανά, ενώ μια κλήση με περιορισμό πετυχαίνει μετά από αναμονή. Η graph() ξαναδοκιμάζει τους προσωρινούς κωδικούς και τους κωδικούς ορίου ρυθμού και προκαλεί εξαίρεση για τους υπόλοιπους, για να τους χειριστεί ο καλών:
Πώς τρέχετε τις ίδιες εργασίες μέσω του easyCoexistence;
Ως εργαλεία MCP που καλούν το Claude, το ChatGPT ή ο δικός σας πράκτορας σε μια συνδεδεμένη Σελίδα, με το token να φυλάσσεται από το easyCoexistence. Τα tokens των Σελίδων δεν παραδίδονται ποτέ, οπότε τα παραδείγματα παραπάνω τρέχουν με token από τη δική σας εφαρμογή Meta· η get_social_credentials επιστρέφει το ID της Σελίδας και τη βάση του Graph API. Το εργαλείο κάθε εργασίας:
Συνηθισμένα λάθη
- Κλήσεις σε endpoints της Σελίδας με user token. Τα περισσότερα περιμένουν το δικό τους token της Σελίδας, και οι κλήσεις με user ή app token μετρώνται στα όρια ρυθμού αυτών των ορίων αντί της Σελίδας.
- Δημοσίευση του ίδιου κειμένου δύο φορές στη σειρά. Η Meta απορρίπτει διαδοχικές πανομοιότυπες αναρτήσεις με σφάλμα 506, οπότε μια εργασία που ξανατρέχει πρέπει να αλλάξει το περιεχόμενο ή να παραλείψει την ανάρτηση.
- Πρόσθεση των καθημερινών μοναδικών θεατών. Το page_total_media_view_unique μετρά μοναδικούς θεατές σε κάθε περίοδο, οπότε οι καθημερινές τιμές δεν αθροίζονται σε μήνα· ζητήστε αντί αυτού period days_28.
- Αποστολή του token της Σελίδας σε πρόγραμμα περιήγησης ή εφαρμογή. Αυτές οι κλήσεις ανήκουν σε διακομιστή, όπου το token μένει μακριά από όποιον μπορεί να διαβάσει τον πελάτη.
Από US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και οι πρώτες 3 ημέρες είναι δωρεάν.
Συχνές ερωτήσεις
Χρειάζομαι SDK για να καλέσω το Facebook Pages API;
Όχι. Το Graph API είναι HTTPS με JSON, οπότε αρκούν τα αιτήματα σε Python και το fetch που είναι ενσωματωμένο στο Node.js 18 ή νεότερο, όπως δείχνουν τα παραδείγματα αυτής της σελίδας.
Μπορεί ο ίδιος κώδικας να δημοσιεύσει σε πολλές Σελίδες;
Ναι. Το /me/accounts επιστρέφει ξεχωριστό token για κάθε Σελίδα, οπότε κρατήστε ένα για κάθε Σελίδα και περάστε το αντίστοιχο PAGE_ID και PAGE_TOKEN· οι κλήσεις με token Σελίδας μετρώνται στο δικό της όριο ρυθμού.
Από πού προέρχεται το PSID για μια απάντηση Messenger;
Από το webhook των μηνυμάτων: το sender.id σε κάθε γεγονός messaging είναι το Page-scoped ID του ατόμου, μοναδικό για εκείνο το άτομο και τη Σελίδα. Τα User IDs από το Facebook Login είναι περιορισμένα στην εφαρμογή και δεν λειτουργούν με το Messenger Platform.
Πόσο κοστίζει το easyCoexistence για μια Σελίδα Facebook;
Κάθε συνδεδεμένη Σελίδα μετράει ως μία σύνδεση, από US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα ανάλογα με το πλήθος τους, και οι πρώτες 3 ημέρες είναι δωρεάν· τα εργαλεία MCP περιλαμβάνονται.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις