Facebook Pages API کے ساتھ Python اور Node.js: کام کرنے والی مثالیں
Python اور Node.js، Facebook Pages API کو graph.facebook.com/v26.0 پر سادہ HTTPS کالز کے ذریعے، Page کے ایکسیس ٹوکن کے ساتھ، استعمال کرتے ہیں: 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 منسلک Page کو یہ کام MCP ٹولز کے طور پر دیتا ہے، publish_facebook_post اور reply_to_comment سے لے کر send_social_dm اور get_social_insights تک، اپنے ایونٹس X-EC-Signature کے دستخط کے ساتھ آگے بھیجتا ہے، اور get_social_credentials کے ذریعے آپ کے اپنے کوڈ کو Page کا ID اور API بیس دیتا ہے۔
Page تصویر کا پیرامیٹر text؛ Meta کے photos ریفرنس میں پیرامیٹر message وہاں متروک نشان زد ہے۔
جواب کا ہیڈر جس کا estimated_time_to_regain_access بتاتا ہے کہ ریٹ لمٹ والی کالیں کتنے منٹ بعد دوبارہ کام کریں گی۔
messaging_type وہ قسم ہے جو Page کو موصول ہونے والے میسج کے جواب کے لیے استعمال ہوتی ہے، 24 گھنٹے کی ونڈو کے اندر بھیجی گئی۔
نجی جواب اس شخص کو کیسے مخاطب کرتا ہے جس نے کمنٹ کیا، اسی /{page-id}/messages اینڈ پوائنٹ کے ذریعے۔
مثالیں چلانے سے پہلے کیا درکار ہے؟
ایک Page ID اور اس Page کا ایکسیس ٹوکن، جو /me/accounts سے طویل المیعاد یوزر ٹوکن کے ذریعے پڑھا جائے، نیز Python 3 جس کے ساتھ requests ہو، یا Node.js 18 یا اس کے بعد کا ورژن، جس کا بلٹ اِن fetch کسی پیکج کے بغیر کام کرتا ہے۔ ہر کام کو ٹوکن پر اپنی اجازت اور Page پر اپنا ٹاسک بھی درکار ہے، اور یہ مثالیں Graph API v26.0 کال کرتی ہیں:
Python میں پوسٹ اور تصویر کیسے شائع کریں؟
ایک مددگار فنکشن کے ساتھ جسے بعد کی مثالیں دوبارہ استعمال کرتی ہیں: graph() Page ٹوکن شامل کرتا ہے، 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 بھیجتی ہے، جو photos edge کا فیلڈ text ہے؛ Meta اسے تصویر کا id اور اس Page پوسٹ کا 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 سے تازہ ترین پہلے، پھر کمنٹ کے اپنے comments edge پر میسج بھیج کر Page کے طور پر جواب دیں۔ ٹوکن کسی ایسے شخص کا ہونا چاہیے جو MODERATE کر سکے، ورنہ Meta کمنٹ 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 backNode.js میں کمنٹس کیسے پڑھیں اور ان کا جواب کیسے دیں؟
وہی دو کالیں، جہاں URL آبجیکٹ query string بناتا ہے: fields، filter اور order کے ساتھ GET، پھر /{comment-id}/comments پر POST۔ can_reply_privately، جو fields میں مانگا گیا ہے، بتاتا ہے کہ کیا Page اب بھی اس کمنٹ کرنے والے کو نجی جواب بھیج سکتا ہے، جو نیچے 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 backPython میں Messenger کا جواب کیسے بھیجیں؟
POST /{page-id}/messages، جس میں recipient.id وہ Page-scoped ID ہو جو messages ویب ہک سے ملا، 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})Node.js میں Messenger کا جواب کیسے بھیجیں؟
وہی درخواست کا باڈی جاوااسکرپٹ میں، جس میں recipient، messaging_type اور message ہیں، جنہیں graph() JSON کے طور پر بھیجتا ہے۔ 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 میں Page کی insights کیسے پڑھیں؟
GET /{page-id}/insights کے ساتھ کاما سے الگ میٹرکس کی فہرست، period=day، اور UNIX سیکنڈز میں since اور until کی ونڈو؛ ایک درخواست زیادہ سے زیادہ 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"])Node.js میں Page کی insights کیسے پڑھیں؟
وہی کال، جس میں since اور until Date.now() سے سیکنڈز میں نکالے جاتے ہیں۔ ہر میٹرک اپنا نام، اپنی period اور value اور end_time جوڑوں کی values فہرست کے ساتھ آتا ہے، ہر دن کے لیے ایک؛ 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 ڈیش بورڈ کی بنیادی سیٹنگز کے App Secret سے کی گئی ہوتی ہے، اور اسے sha256= کے بعد لکھتا ہے۔ باڈی کو JSON پارس ہونے سے پہلے bytes کے طور پر دیں: Django میں request.body اور FastAPI میں await request.body() دونوں وہ 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"))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 یا آپ کا اپنا ایجنٹ منسلک Page پر کال کرتا ہے، جبکہ ٹوکن easyCoexistence کے پاس رہتا ہے۔ Page ٹوکن کبھی حوالے نہیں کیے جاتے، اس لیے اوپر کی مثالیں آپ کی اپنی Meta ایپ کے ٹوکن پر چلتی ہیں؛ get_social_credentials Page کا ID اور Graph API بیس دیتا ہے۔ ہر کام کا ٹول:
عام غلطیاں
- Page کے اینڈ پوائنٹس کو یوزر ٹوکن سے کال کرنا۔ ان میں سے زیادہ تر Page کا اپنا ٹوکن چاہتے ہیں، اور یوزر یا ایپ ٹوکن سے کی گئی کالیں Page کے بجائے ان ریٹ لمٹس میں شمار ہوتی ہیں۔
- ایک ہی متن لگاتار دو بار شائع کرنا۔ Meta لگاتار ایک جیسی پوسٹیں ایرر 506 کے ساتھ مسترد کرتا ہے، اس لیے دوبارہ چلنے والا کام مواد بدلے یا پوسٹ چھوڑ دے۔
- روزانہ منفرد ناظرین کو جمع کرنا۔ page_total_media_view_unique ہر مدت میں منفرد ناظرین شمار کرتا ہے، اس لیے روزانہ کی قدریں مہینے میں جمع نہیں ہوتیں؛ اس کے بجائے period کے لیے days_28 مانگیں۔
- Page کا ٹوکن براؤزر یا ایپ تک بھیجنا۔ یہ کالیں سرور پر ہونی چاہئیں، جہاں ٹوکن ہر اس شخص کی پہنچ سے باہر رہے جو کلائنٹ پڑھ سکتا ہے۔
فی کنکشن ماہانہ US$ 9 سے US$ 0.75 تک، جوں جوں کنکشنز بڑھتے ہیں قیمت کم ہوتی ہے، پہلے 3 دن فری ٹرائل۔
اکثر پوچھے جانے والے سوالات
کیا Facebook Pages API کو کال کرنے کے لیے SDK درکار ہے؟
نہیں۔ Graph API JSON کے ساتھ HTTPS ہے، اس لیے Python میں HTTP کالز اور Node.js 18 یا اس کے بعد کا بلٹ اِن fetch کافی ہے، جیسا کہ اس صفحے کی مثالیں دکھاتی ہیں۔
کیا یہی کوڈ کئی Pages پر پوسٹ کر سکتا ہے؟
ہاں۔ /me/accounts ہر Page کا الگ ٹوکن دیتا ہے، اس لیے ہر Page کا ایک رکھیں اور متعلقہ PAGE_ID اور PAGE_TOKEN دیں؛ Page ٹوکن سے کی گئی کالیں اسی Page کی اپنی ریٹ لمٹ میں شمار ہوتی ہیں۔
Messenger کے جواب کے لیے PSID کہاں سے آتا ہے؟
messages ویب ہک سے: ہر messaging ایونٹ میں sender.id اس شخص کا Page-scoped ID ہے، جو اس شخص اور Page کے لیے منفرد ہے۔ Facebook Login کے یوزر IDs ایپ-scoped ہوتے ہیں اور Messenger Platform کے ساتھ کام نہیں کرتے۔
Facebook Page کے لیے easyCoexistence کتنے کا ہے؟
ہر منسلک Page ایک کنکشن شمار ہوتا ہے، جو آپ کے کنکشنز کی تعداد کے لحاظ سے فی کنکشن ماہانہ US$ 9 سے US$ 0.75 تک ہے، اور پہلے 3 دن فری ٹرائل ہیں؛ MCP ٹولز اسی کے ساتھ آتے ہیں۔
مزید پڑھیں
دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔
کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔
- 3 دن مفت
- کسی بھی وقت منسوخ کریں
- صرف آفیشل API
- 24/7 نگرانی
تصدیق شدہ تاریخ