Facebook Pages API di Python dan Node.js: contoh yang bisa dijalankan
Python dan Node.js memanggil Facebook Pages API sebagai permintaan HTTPS biasa ke graph.facebook.com/v26.0 dengan access token Page: POST /{page-id}/feed dan /{page-id}/photos mempublikasikan, /{post-id}/comments membaca dan membalas komentar, POST /{page-id}/messages membalas di Messenger, GET /{page-id}/insights membaca metrik, dan HMAC-SHA256 dari body mentah memeriksa X-Hub-Signature-256 pada setiap webhook.
easyCoexistence memberi Page yang terhubung tugas-tugas ini sebagai alat MCP, mulai dari publish_facebook_post dan reply_to_comment hingga send_social_dm dan get_social_insights, meneruskan event-nya yang ditandatangani dengan X-EC-Signature, dan memberikan kode Anda ID Page dan base API melalui get_social_credentials.
Parameter text dari foto Page; referensi foto Meta menandai message sebagai usang di sana.
Header respons yang estimated_time_to_regain_access memberi jumlah menit sampai panggilan yang dibatasi kembali berfungsi.
messaging_type untuk balasan atas pesan yang diterima Page, dikirim di dalam jendela layanan pelanggan 24 jam.
Cara balasan privat menargetkan orang yang berkomentar, melalui endpoint /{page-id}/messages yang sama.
Apa yang dibutuhkan contoh-contoh ini sebelum dijalankan?
Page ID dan access token Page tersebut, dibaca dari /me/accounts dengan user token berumur panjang, serta Python 3 dengan requests, atau Node.js 18 atau lebih baru, yang fetch bawaannya tidak memerlukan paket apa pun. Setiap tugas juga membutuhkan izin pada token dan tugas pada Page, dan contoh-contoh ini memanggil Graph API v26.0:
Bagaimana cara mempublikasikan postingan dan foto di Python?
Dengan satu fungsi bantu yang dipakai ulang oleh contoh-contoh berikutnya: graph() menambahkan token Page, mengirim parameter GET dalam query string dan field POST sebagai JSON, seperti contoh resmi Meta, dan mengubah objek kesalahan Meta menjadi GraphError yang membawa code dan error_subcode. Fungsi ini menunggu dan mencoba kembali hanya untuk kode sementara dan kode pembatasan laju, selama X-Business-Use-Case-Usage memintanya ketika header itu muncul, dan langsung melempar sisanya.
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"])Bagaimana cara mempublikasikannya di Node.js?
Dengan fungsi bantu yang sama di Node.js 18 atau lebih baru, disimpan sebagai file .mjs agar top-level await berfungsi, dan memakai fetch bawaan sebagai pengganti library klien. Panggilan foto mengirim url dan caption, field text pada edge photos; Meta membalasnya dengan id foto dan post_id dari postingan Page yang memuat foto itu, sedangkan panggilan feed hanya membalas dengan id postingan.
// 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);Bagaimana cara membaca dan membalas komentar di Python?
Baca komentar postingan dengan fields, filter=stream untuk komentar di semua tingkat secara urut waktu dan order=reverse_chronological untuk yang terbaru lebih dulu, lalu balas sebagai Page dengan mengirim pesan ke edge comments milik komentar itu. Token harus berasal dari seseorang yang dapat melakukan MODERATE, atau Meta tidak menyertakan ID komentar, dan membalas memerlukan pages_manage_engagement. paging.next menuju ke komentar yang lebih lama.
# 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 backBagaimana cara membaca dan membalas komentar di Node.js?
Dua panggilan yang sama, dengan objek URL yang membangun query string: GET dengan fields, filter dan order, lalu POST ke /{comment-id}/comments. can_reply_privately, yang diminta dalam fields, menunjukkan apakah Page masih dapat mengirim balasan privat kepada pemberi komentar, informasi yang berguna sebelum contoh Messenger di bawah. Simpan ID komentar yang Anda balas, agar menjalankan ulang tidak membalas dua kali.
// 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 backBagaimana cara mengirim balasan Messenger di Python?
POST /{page-id}/messages dengan recipient.id diisi ID yang terbatas pada Page dari webhook messages, messaging_type RESPONSE, dan text. Contoh ini menangkap dua penolakan yang tidak layak dicoba ulang: kesalahan 10 dengan subcode 2534022 atau 2018278 saat jendela layanan pelanggan 24 jam sudah tertutup, dan 551 saat orang tersebut tidak tersedia. private_reply() memasukkan recipient.comment_id sebagai pengganti ID, untuk satu pesan yang diizinkan oleh sebuah komentar dalam 7 hari.
# 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})Bagaimana cara mengirim balasan Messenger di Node.js?
Body permintaan yang sama dalam JavaScript, dengan recipient, messaging_type dan message yang dikirim sebagai JSON oleh graph(). Meta membalas pengiriman yang diterimanya dengan recipient_id dan message_id, yang sebaiknya disimpan bersama percakapan. Balasan privat membawa tautan kembali ke komentar yang dibalasnya, dan percakapan berlanjut dalam jendela layanan pelanggan 24 jam standar begitu orang itu membalas.
// 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 },
});
}Bagaimana cara membaca insight Page di Python?
GET /{page-id}/insights dengan daftar metrik dipisah koma, period=day, dan jendela since serta until dalam detik UNIX; satu permintaan mencakup hingga 90 hari. Tiga metrik ini menggantikan metrik yang sudah dihentikan Meta: page_media_view dari page_impressions, page_total_media_view_unique dari page_impressions_unique, dan page_follows dari page_fans, sedangkan page_post_engagements menghitung reaksi, komentar, dan pembagian.
# 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"])Bagaimana cara membaca insight Page di Node.js?
Panggilan yang sama, dengan since dan until dihitung dari Date.now() dalam detik. Setiap metrik kembali dengan nama, period, dan daftar values berisi pasangan value dan end_time, satu per hari; dengan since diisi, end_time pertama jatuh pada hari setelahnya, sehingga data hari itu ikut terhitung. Token memerlukan read_insights dan pages_read_engagement, dari seseorang yang memiliki tugas 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);
}
}Bagaimana cara memverifikasi tanda tangan webhook di Python?
Hitung ulang X-Hub-Signature-256 dari body permintaan mentah dan app secret, lalu bandingkan keduanya dalam waktu konstan. Meta menandatangani setiap POST dengan HMAC-SHA256 dari payload, dikunci dengan App Secret dari pengaturan dasar App Dashboard, dan menuliskannya setelah sha256=. Berikan body sebagai bytes, sebelum parsing JSON apa pun: request.body di Django dan await request.body() di FastAPI keduanya memberi bytes yang ditandatangani 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"))Bagaimana cara memverifikasi tanda tangan webhook di Node.js?
Pemeriksaan yang sama dengan node:crypto, yang memerlukan body sebagai Buffer: di Express, express.raw menjaganya tetap belum diparsing pada rute itu. timingSafeEqual melempar kesalahan untuk input dengan panjang berbeda, sehingga pengecekan panjang dijalankan lebih dulu. Balas 200 dengan cepat dan kerjakan setelahnya, karena Meta mencoba kembali pengiriman yang gagal dan dapat mengirim event dua kali; halaman verifikasi membahas jabat tangan hub.challenge yang terjadi sebelum event apa pun.
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
// });Kode kesalahan mana yang harus ditangani oleh kode ini?
Yang dibedakan oleh panduan kesalahan Meta, karena masing-masing memerlukan respons berbeda: mencoba ulang token yang ditolak atau parameter yang salah hanya akan gagal lagi, sedangkan panggilan yang dibatasi berhasil setelah menunggu. graph() mencoba ulang kode sementara dan kode pembatasan laju, dan melempar yang lain agar ditangani pemanggil:
Bagaimana cara menjalankan tugas yang sama melalui easyCoexistence?
Sebagai alat MCP yang dipanggil Claude, ChatGPT, atau agen Anda sendiri pada Page yang terhubung, dengan token disimpan oleh easyCoexistence. Token Page tidak pernah diberikan, sehingga contoh di atas berjalan dengan token dari aplikasi Meta Anda sendiri; get_social_credentials mengembalikan ID Page dan basis Graph API. Alat untuk setiap tugas:
Kesalahan umum
- Memanggil endpoint Page dengan user token. Sebagian besar mengharapkan token milik Page itu sendiri, dan panggilan dengan user atau app token dihitung terhadap pembatasan laju tersebut, bukan milik Page.
- Mempublikasikan teks yang sama dua kali berturut-turut. Meta menolak postingan duplikat berturut-turut dengan kesalahan 506, sehingga tugas yang dijalankan ulang harus mengubah konten atau melewati postingan.
- Menjumlahkan pemirsa unik harian. page_total_media_view_unique menghitung pemirsa unik di setiap periode, sehingga nilai harian tidak dapat dijumlahkan menjadi sebulan; minta period days_28 sebagai gantinya.
- Mengirim token Page ke browser atau aplikasi. Panggilan ini harus berada di server, tempat token tetap di luar jangkauan siapa pun yang dapat membaca klien.
US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring penambahan koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Apakah saya memerlukan SDK untuk memanggil Facebook Pages API?
Tidak. Graph API adalah HTTPS dengan JSON, jadi permintaan di Python dan fetch bawaan Node.js 18 atau lebih baru sudah cukup, seperti ditunjukkan contoh di halaman ini.
Bisakah kode yang sama memposting ke beberapa Page?
Bisa. /me/accounts mengembalikan token terpisah untuk setiap Page, jadi simpan satu per Page dan teruskan PAGE_ID dan PAGE_TOKEN yang sesuai; panggilan dengan token Page dihitung terhadap pembatasan laju Page itu sendiri.
Dari mana PSID untuk balasan Messenger berasal?
Dari webhook messages: sender.id pada setiap event messaging adalah ID yang terbatas pada Page milik orang tersebut, unik untuk orang dan Page itu. ID pengguna dari Facebook Login terbatas pada app dan tidak berfungsi dengan Messenger Platform.
Berapa biaya easyCoexistence untuk Facebook Page?
Setiap Page yang terhubung dihitung sebagai satu koneksi, dengan harga US$ 9 hingga US$ 0.75 per koneksi per bulan tergantung jumlah koneksi Anda, dan 3 hari pertama gratis; alat MCP sudah termasuk.
Lanjut membaca
Hubungkan saluran pertama Anda dalam dua menit.
Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.
- Gratis 3 hari
- Batalkan kapan saja
- Hanya API resmi
- Dipantau 24/7
Diverifikasi pada