Facebook Pages API: Python ve Node.js ile çalışan örnekler
Python ve Node.js, Facebook Pages API'yi Sayfanın erişim token'ıyla graph.facebook.com/v26.0 adresine düz HTTPS istekleri olarak çağırır: POST /{page-id}/feed ve /{page-id}/photos gönderi yayınlar, /{post-id}/comments yorumları okur ve yanıtlar, POST /{page-id}/messages Messenger'da yanıt verir, GET /{page-id}/insights metrikleri okur ve her webhook'ta ham gövdenin HMAC-SHA256 değeri X-Hub-Signature-256 ile karşılaştırılarak doğrulanır.
easyCoexistence, bağlı bir Sayfaya bu işleri MCP araçları olarak sunar: publish_facebook_post'tan reply_to_comment'e ve send_social_dm'den get_social_insights'a kadar.
Sayfa fotoğrafının text parametresi; Meta'nın photos referansı orada message parametresini kullanımdan kaldırılmış olarak işaretler.
estimated_time_to_regain_access değerinin, sınırlanan isteklerin yeniden çalışmasına kaç dakika kaldığını gösterdiği yanıt başlığı.
Sayfanın aldığı bir mesaja yanıt için messaging_type; 24 saatlik pencere içinde gönderilir.
Özel yanıtın, yorum yapan kişiyi aynı /{page-id}/messages uç noktası üzerinden nasıl hedeflediği.
Örnekler çalışmadan önce neye ihtiyaç duyar?
Bir Sayfa ID'si ve o Sayfanın erişim token'ı; bu token, uzun ömürlü bir kullanıcı token'ıyla /me/accounts üzerinden okunur. Ayrıca requests paketli Python 3 veya paket gerektirmeyen yerleşik fetch'e sahip Node.js 18 ve sonrası. Her işin token üzerinde kendi izni ve Sayfada kendi görevi de olmalı; örnekler Graph API v26.0'ı çağırır:
Python'da gönderi ve fotoğraf nasıl yayınlanır?
Sonraki örneklerin yeniden kullandığı tek bir yardımcı fonksiyonla: graph() Sayfa token'ını ekler, GET parametrelerini sorgu dizgisinde, POST alanlarını ise Meta'nın kendi örneklerindeki gibi JSON olarak gönderir ve Meta'nın hata nesnesini code ve error_subcode taşıyan bir GraphError'a çevirir. Yalnızca geçici ve hız sınırı kodlarında bekleyip yeniden dener; bekleme süresini X-Business-Use-Case-Usage başlığının istediği kadar alır. Diğer hataları hemen fırlatır.
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'te nasıl yayınlanır?
Aynı yardımcı fonksiyonla, Node.js 18 veya sonrasında, üst düzey await çalışsın diye .mjs dosyası olarak kaydedilmiş; istemci kütüphanesi yerine yerleşik fetch kullanılır. Fotoğraf çağrısı url ve caption gönderir; bunlar photos uç noktasının text alanına karşılık gelir. Meta, fotoğrafın id'siyle ve fotoğrafı taşıyan Sayfa gönderisinin post_id'siyle yanıt verir; feed çağrısı ise yalnızca gönderinin id'siyle yanıt verir.
// 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'da yorumlar nasıl okunur ve yanıtlanır?
Bir gönderinin yorumları fields ile okunur; filter=stream tüm düzeylerdeki yorumları zaman sırasıyla, order=reverse_chronological ise en yenisini en başta getirir. Ardından Sayfa olarak, yorumun kendi comments uç noktasına bir mesaj gönderilerek yanıt verilir. Token, MODERATE görevini yerine getirebilen birinden alınmalıdır; aksi halde Meta yorum ID'lerini dışarıda bırakır. Yanıt vermek için pages_manage_engagement gerekir. paging.next ise daha eski yorumlara götürür.
# 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'te yorumlar nasıl okunur ve yanıtlanır?
Aynı iki çağrı; sorgu dizgisini URL nesnesi oluşturur. fields, filter ve order ile bir GET, ardından /{comment-id}/comments adresine bir POST. fields içinde istenen can_reply_privately, Sayfanın o yorum yapana hâlâ özel yanıt gönderip gönderemeyeceğini söyler; aşağıdaki Messenger örneğinden önce bilinmesi yararlıdır. Yanıtladığınız yorumların ID'lerini saklayın ki yeniden çalıştırma aynı yoruma iki kez yanıt vermesin.
// 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'da Messenger yanıtı nasıl gönderilir?
messages webhook'undan gelen kişinin Sayfa kapsamlı ID'siyle recipient.id ayarlanmış POST /{page-id}/messages; messaging_type RESPONSE ve metin. Örnek, yeniden denenmeye değmeyen iki reddi yakalar: 24 saatlik pencere kapandığında 2534022 veya 2018278 alt koduyla 10 hatası ve kişi kullanılamadığında 551. private_reply() ise ID yerine recipient.comment_id koyar; bu, bir yoruma 7 gün içinde izin verilen tek mesaj içindir.
# 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'te Messenger yanıtı nasıl gönderilir?
Aynı istek gövdesi JavaScript'te; recipient, messaging_type ve message, graph() tarafından JSON olarak gönderilir. Meta, kabul ettiği gönderime recipient_id ve message_id ile yanıt verir; bunları konuşmayla birlikte saklamaya değer. Özel yanıt, yanıtladığı yoruma geri bağlantı taşır; kişi yazdığında konuşma standart 24 saatlik pencerede devam eder.
// 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'da Sayfa içgörüleri nasıl okunur?
Virgülle ayrılmış bir metrik listesi, period=day ve UNIX saniyesi cinsinden since ile until penceresiyle GET /{page-id}/insights; tek istek 90 güne kadar kapsar. Bu metriklerden üçü, Meta'nın kullanımdan kaldırdığı metriklerin yerini aldı: page_impressions yerine page_media_view, page_impressions_unique yerine page_total_media_view_unique ve page_fans yerine page_follows. page_post_engagements ise tepkileri, yorumları ve paylaşımları sayar.
# 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'te Sayfa içgörüleri nasıl okunur?
Aynı çağrı; since ve until, Date.now() değerinden saniye cinsinden hesaplanır. Her metrik adı, periyodu ve value ile end_time çiftlerinden oluşan bir values listesiyle döner; her gün için bir çift. since verildiğinde ilk end_time bir sonraki güne düşer, böylece o günün verisi dahil edilir. Token'da read_insights ve pages_read_engagement bulunmalı; bunu ANALYZE görevine sahip biri vermelidir.
// 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'da webhook imzası nasıl doğrulanır?
X-Hub-Signature-256 değeri, ham istek gövdesi ve uygulama sırrından yeniden hesaplanır, ardından iki değer sabit süreli karşılaştırmayla kıyaslanır. Meta her POST'u, App Dashboard'un temel ayarlarındaki App Secret ile anahtarlanmış bir HMAC-SHA256 değeriyle imzalar ve bunu sha256= ön ekinden sonra yazar. Gövdeyi JSON ayrıştırmadan önce bayt olarak geçirin: Django'da request.body ve FastAPI'de await request.body(), Meta'nın imzaladığı baytların aynısını verir.
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'te webhook imzası nasıl doğrulanır?
Aynı kontrol node:crypto ile yapılır; gövdenin bir Buffer olarak gelmesi gerekir. Express'te express.raw, o rotada gövdeyi ayrıştırılmadan tutar. timingSafeEqual, farklı uzunluktaki girdilerde hata fırlattığı için uzunluk kontrolü önce çalışır. 200 yanıtını hızlıca verin, işi sonra yapın; Meta başarısız teslimatları yeniden dener ve bir olayı iki kez gönderebilir. Doğrulama sayfası, herhangi bir olaydan önce gelen hub.challenge el sıkışmasını anlatır.
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
// });Kod hangi hata kodlarına göre davranmalı?
Meta'nın hata kılavuzlarının birbirinden ayırdığı kodlar; her biri farklı bir yanıt gerektirdiği için. Reddedilmiş bir token'ı ya da hatalı bir parametreyi yeniden denemek yalnızca yeniden başarısız olur; sınırlanmış bir çağrı ise bir bekleme sonrası başarılı olur. graph() geçici ve hız sınırı kodlarını yeniden dener, diğerlerini çağıranın işlemesi için fırlatır:
Aynı işleri easyCoexistence üzerinden nasıl çalıştırırsınız?
Bağlı bir Sayfada Claude, ChatGPT veya kendi ajanınızın çağırdığı MCP araçları olarak; token easyCoexistence tarafında tutulur. Sayfa token'ları asla verilmez, bu yüzden yukarıdaki örnekler kendi Meta uygulamanızın token'ıyla çalışır; get_social_credentials Sayfanın ID'sini ve Graph API tabanını döndürür. Her işin aracı:
Yaygın hatalar
- Sayfa uç noktalarını kullanıcı token'ıyla çağırmak. Çoğu, Sayfanın kendi token'ını bekler; kullanıcı veya uygulama token'ıyla yapılan çağrılar, Sayfanın değil o token'ların hız sınırlarından düşer.
- Aynı metni arka arkaya iki kez yayınlamak. Meta, art arda gelen yinelenen gönderileri 506 hatasıyla reddeder; bu yüzden yeniden çalışan bir iş içeriği değiştirmeli ya da gönderiyi atlamalıdır.
- Günlük tekil izleyicileri toplamak. page_total_media_view_unique, her periyotta tekil izleyicileri sayar; bu yüzden günlük değerler aya toplanmaz. Bunun yerine period değeri olarak days_28 isteyin.
- Sayfa token'ını bir tarayıcıya ya da uygulamaya göndermek. Bu çağrılar sunucuda yapılmalıdır; böylece token, istemciyi okuyabilen herkesin erişiminin dışında kalır.
Olaylarını X-EC-Signature ile imzalanmış olarak iletir ve kendi kodunuza get_social_credentials üzerinden Sayfa kimliğini ve API tabanını verir. Bağlantı başına ayda US$ 9 ile US$ 0.75 arasında ücretlendirilir; bağlantı sayısı arttıkça fiyat düşer ve ilk 3 gün ücretsizdir.
Sık sorulan sorular
Facebook Pages API'yi çağırmak için SDK gerekir mi?
Hayır. Graph API, JSON ile HTTPS üzerinden çalışır; bu sayfadaki örneklerin gösterdiği gibi Python'daki istekler ve Node.js 18 veya sonrasının yerleşik fetch'i yeterlidir.
Aynı kod birden çok Sayfaya gönderebilir mi?
Evet. /me/accounts her Sayfa için ayrı bir token döndürür; bu yüzden Sayfa başına bir tane tutun ve eşleşen PAGE_ID ile PAGE_TOKEN'ı geçirin. Sayfa token'ıyla yapılan çağrılar o Sayfanın kendi hız sınırından düşer.
Messenger yanıtı için PSID nereden gelir?
messages webhook'undan: her messaging olayındaki sender.id, kişinin Sayfa kapsamlı ID'sidir ve o kişiye ve Sayfaya özeldir. Facebook Login'den gelen kullanıcı ID'leri uygulama kapsamlıdır ve Messenger Platform ile çalışmaz.
Bir Facebook Sayfası için easyCoexistence ne kadar tutar?
Bağlı her Sayfa bir bağlantı sayılır; bağlantı başına ayda US$ 9 ile US$ 0.75 arasında ücretlendirilir, bağlantı sayısına göre değişir ve ilk 3 gün ücretsizdir. MCP araçları bu fiyatla birlikte gelir.
Okumaya devam edin
İlk kanalınızı iki dakikada bağlayın.
Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.
- 3 gün ücretsiz
- İstediğiniz zaman iptal
- Yalnızca resmi API'ler
- 7/24 izleniyor
Doğrulama tarihi