Python ও Node.js-এ Facebook Pages API: কার্যকর উদাহরণ
Python ও Node.js সাধারণ HTTPS রিকোয়েস্ট হিসেবে graph.facebook.com/v26.0-এ Page-এর অ্যাক্সেস টোকেন দিয়ে Facebook Pages API-কে কল করে: 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 রেফারেন্স সেখানে মেসেজ-কে অপ্রচলিত বলে চিহ্নিত করে।
প্রতিক্রিয়া হেডার, যার estimated_time_to_regain_access মান জানায় রেট লিমিটে আটকানো কল আবার কাজ করতে কত মিনিট লাগবে।
messaging_type-এর মান, যা Page-এর পাওয়া মেসেজের উত্তরে ব্যবহৃত হয় এবং 24 ঘণ্টার উইন্ডোর ভেতরে পাঠানো হয়।
ব্যক্তিগত উত্তর কীভাবে মন্তব্যকারীকে ঠিকানা দেয়, একই /{page-id}/messages এন্ডপয়েন্টের মাধ্যমে।
উদাহরণগুলো চালানোর আগে কী লাগে?
একটি Page ID ও সেই Page-এর অ্যাক্সেস টোকেন, যা দীর্ঘমেয়াদি ইউজার টোকেন দিয়ে /me/accounts থেকে পড়া হয়, সঙ্গে requests সহ Python 3, অথবা Node.js 18 বা তার পরের সংস্করণ, যার বিল্ট-ইন fetch-এর জন্য কোনো প্যাকেজ লাগে না। প্রতিটি কাজের জন্য টোকেনে তার পারমিশন এবং Page-এ সংশ্লিষ্ট কাজের অধিকার থাকতে হবে, আর উদাহরণগুলো Graph API v26.0 কল করে:
Python-এ কীভাবে পোস্ট ও ছবি প্রকাশ করবেন?
একটি হেল্পার দিয়ে, যা পরের উদাহরণগুলো পুনর্ব্যবহার করে: graph() Page টোকেন যোগ করে, 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 ফাইল হিসেবে সংরক্ষিত, যাতে টপ-লেভেল await কাজ করে, এবং ক্লায়েন্ট লাইব্রেরির বদলে বিল্ট-ইন fetch। ছবির কল url ও caption পাঠায়, যা photos এজের 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 এজে একটি মেসেজ পোস্ট করে Page হিসেবে উত্তর দিন। টোকেনটি এমন কারও হতে হবে যে 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 backNode.js-এ মন্তব্য কীভাবে পড়বেন ও উত্তর দেবেন?
একই দুটি কল, URL অবজেক্ট দিয়ে কোয়েরি স্ট্রিং তৈরি: fields, filter ও order সহ একটি GET, তারপর /{comment-id}/comments-এ POST। fields-এ চাওয়া can_reply_privately বলে দেয় Page এখনো সেই মন্তব্যকারীকে ব্যক্তিগত উত্তর পাঠাতে পারে কি না, যা নিচের 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 backPython-এ Messenger উত্তর কীভাবে পাঠাবেন?
/{page-id}/messages-এ POST, যেখানে recipient.id হলো মেসেজ ওয়েবহুক থেকে পাওয়া ব্যক্তির Page-scoped ID, messaging_type RESPONSE এবং text। উদাহরণটি দুটি প্রত্যাখ্যান ধরে, যেগুলো আবার চেষ্টা করার যোগ্য নয়: 24 ঘণ্টার উইন্ডো বন্ধ হলে সাবকোড 2534022 বা 2018278 সহ ত্রুটি 10, এবং ব্যক্তি উপলব্ধ না থাকলে 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 উত্তর কীভাবে পাঠাবেন?
একই রিকোয়েস্ট বডি 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-এ Page-এর insights কীভাবে পড়বেন?
GET /{page-id}/insights, কমা-বিভাজিত মেট্রিক তালিকা, period=day এবং UNIX সেকেন্ডে since ও until উইন্ডো দিয়ে; একটি রিকোয়েস্টে 90 দিন পর্যন্ত কভার হয়। এই মেট্রিকগুলোর তিনটি Meta-র বাতিল করা মেট্রিকের জায়গা নিয়েছে: page_impressions থেকে page_media_view, page_impressions_unique থেকে page_total_media_view_unique এবং page_fans থেকে page_follows, আর 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 ও একটি 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-এ ওয়েবহুক স্বাক্ষর কীভাবে যাচাই করবেন?
কাঁচা রিকোয়েস্ট বডি ও App Secret থেকে X-Hub-Signature-256 আবার হিসাব করুন, তারপর দুটি মান কনস্ট্যান্ট টাইমে তুলনা করুন। Meta প্রতিটি POST-কে পেলোডের HMAC-SHA256 দিয়ে স্বাক্ষর করে, যা App Dashboard-এর বেসিক সেটিংস থেকে নেওয়া App Secret দিয়ে তৈরি, এবং sha256= এর পরে লেখে। বডিকে JSON পার্সিংয়ের আগে bytes হিসেবে দিন: Django-তে request.body ও FastAPI-তে await request.body() উভয়ই Meta-র স্বাক্ষর করা bytes দেয়।
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 HTTPS ও JSON দিয়ে চলে, তাই Python-এর requests ও Node.js 18 বা তার পরের বিল্ট-ইন fetch যথেষ্ট, যেমন এই পাতার উদাহরণগুলো দেখায়।
একই কোড কি একাধিক Page-এ পোস্ট করতে পারে?
হ্যাঁ। /me/accounts প্রতিটি Page-এর জন্য আলাদা টোকেন দেয়, তাই প্রতি Page-এর জন্য একটি রাখুন এবং মিলে যাওয়া PAGE_ID ও PAGE_TOKEN পাঠান; Page টোকেন দিয়ে কল ওই Page-এর নিজের রেট লিমিটে গোনা হয়।
Messenger উত্তরের PSID কোথা থেকে আসে?
মেসেজ ওয়েবহুক থেকে: প্রতিটি messaging ইভেন্টের sender.id হলো ব্যক্তির Page-scoped ID, যা ওই ব্যক্তি ও Page-এর জন্য অনন্য। Facebook Login-এর ইউজার ID অ্যাপ-স্কোপড এবং Messenger Platform-এ কাজ করে না।
একটি Facebook Page-এর জন্য easyCoexistence-এর খরচ কত?
প্রতিটি সংযুক্ত Page একটি সংযোগ গণ্য হয়, এবং তার সংখ্যার ওপর নির্ভর করে প্রতি সংযোগে প্রতি মাসে US$ 9 থেকে US$ 0.75, আর প্রথম 3 দিন ফ্রি; MCP টুল এর সাথেই আসে।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে