Prijavite seZapočnite besplatni probni period
easyCoexistence Zvanični API-ji

Facebook Pages API u Pythonu i Node.js: radni primeri

Python i Node.js pozivaju Facebook Pages API kao obične HTTPS zahteve ka graph.facebook.com/v26.0 uz token pristupa stranice: POST /{page-id}/feed i /{page-id}/photos objavljuju, /{post-id}/comments čita i odgovara na komentare, POST /{page-id}/messages odgovara u Messengeru, GET /{page-id}/insights čita metrike, a HMAC-SHA256 nad sirovim telom zahteva proverava X-Hub-Signature-256 na svakom webhooku.

easyCoexistence daje povezanoj stranici ove poslove kao MCP alate, od publish_facebook_post i reply_to_comment do send_social_dm i get_social_insights, prosleđuje svoje događaje potpisane sa X-EC-Signature, a vašem sopstvenom kodu daje ID stranice i API osnovu preko get_social_credentials.

caption

Parametar text fotografije stranice; Metina referenca za fotografije tu označava poruku kao zastarelu.

X-Business-Use-Case-Usage

Zaglavlje odgovora čije polje estimated_time_to_regain_access daje minute do trenutka kada ograničeni pozivi ponovo rade.

RESPONSE

messaging_type za odgovor na poruku koju je stranica primila, poslat unutar 24-časovnog prozora.

recipient.comment_id

Kako privatni odgovor adresira osobu koja je komentarisala, preko istog endpointa /{page-id}/messages.

Šta primeri zahtevaju pre pokretanja?

ID stranice i token pristupa te stranice, pročitan iz /me/accounts uz dugotrajni korisnički token, plus Python 3 sa requests paketom ili Node.js 18 ili noviji, čiji ugrađeni fetch ne traži nijedan paket. Svaki posao takođe zahteva svoju dozvolu na tokenu i svoj zadatak na stranici, a primeri pozivaju Graph API v26.0:

Publish a post or photoPOST /{page-id}/feed and /{page-id}/photos: pages_manage_posts, CREATE_CONTENT
Read and reply to comments/{post-id}/comments and /{comment-id}/comments: pages_manage_engagement, MODERATE
Reply in MessengerPOST /{page-id}/messages: pages_messaging, MESSAGING
Read insightsGET /{page-id}/insights: read_insights, pages_read_engagement, ANALYZE
Check a webhookX-Hub-Signature-256, with the app secret and no token

Kako objaviti post i fotografiju u Pythonu?

Pomoću jedne pomoćne funkcije koju kasniji primeri koriste ponovo: graph() dodaje token stranice, šalje GET parametre u query stringu, a POST polja kao JSON, kao što to rade Metini primeri, i pretvara Metin objekat greške u GraphError koji nosi code i error_subcode. Čeka i ponavlja pokušaj samo za privremene kodove i kodove ograničenja, onoliko koliko X-Business-Use-Case-Usage traži kada se to zaglavlje vrati, a ostale odmah prijavljuje.

Python: graph(), then a post and a photo
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"])

Kako ih objaviti u Node.js?

Istom pomoćnom funkcijom u Node.js 18 ili novijem, sačuvanom kao .mjs fajl kako bi top-level await radio, uz ugrađeni fetch umesto klijentske biblioteke. Poziv za fotografiju šalje url i caption, polje text edge-a photos; Meta odgovara ID-jem fotografije i post_id-jem objave stranice koja nosi fotografiju, dok poziv za feed odgovara samo ID-jem objave.

Node.js: graph(), then a post and a photo
// 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);

Kako čitati i odgovarati na komentare u Pythonu?

Komentari objave čitaju se sa fields, filter=stream za komentare svih nivoa po vremenskom redu i order=reverse_chronological za najnovije prvo, a zatim se odgovara kao stranica slanjem poruke na sopstveni comments edge komentara. Token mora da potiče od nekoga ko može da izvrši MODERATE, inače Meta izostavlja ID-jeve komentara, a odgovor zahteva pages_manage_engagement. paging.next vodi dalje unazad.

Python: read a post's comments and reply to the questions
# 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

Kako čitati i odgovarati na komentare u Node.js?

Isti dva poziva, a URL objekat gradi query string: GET sa fields, filter i order, pa POST na /{comment-id}/comments. can_reply_privately, zatražen u fields, kazuje da li stranica još može tom komentatoru da pošalje privatni odgovor, što valja znati pre primera za Messenger ispod. Čuvajte ID-jeve komentara na koje odgovarate, kako ponovno pokretanje ne bi odgovorilo dvaput.

Node.js: read a post's comments and reply to the questions
// 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

Kako poslati odgovor u Messengeru u Pythonu?

POST /{page-id}/messages sa recipient.id postavljenim na Page-scoped ID osobe iz messages webhooka, messaging_type RESPONSE i tekst. Primer hvata dva odbijanja koja nije vredno ponavljati: grešku 10 sa subkodom 2534022 ili 2018278 kada je 24-časovni prozor zatvoren, i 551 kada osoba nije dostupna. private_reply() umesto ID-ja stavlja recipient.comment_id, za jednu poruku koju komentar dozvoljava u roku od 7 dana.

Python: a Messenger reply and a private reply
# 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})

Kako poslati odgovor u Messengeru u Node.js?

Isto telo zahteva u JavaScriptu, sa recipient, messaging_type i message poslatim kao JSON preko graph(). Meta na prihvaćeno slanje odgovara sa recipient_id i message_id, što vredi sačuvati uz razgovor. Privatni odgovor nosi vezu nazad na komentar na koji odgovara, a razgovor se nastavlja u standardnom 24-časovnom prozoru čim osoba odgovori.

Node.js: a Messenger reply and a private reply
// 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 },
  });
}

Kako čitati uvide stranice u Pythonu?

GET /{page-id}/insights sa listom metrika odvojenom zarezima, period=day i prozorom since i until u UNIX sekundama; jedan zahtev pokriva do 90 dana. Tri ove metrike preuzela su mesto onih koje je Meta ukinula: page_media_view umesto page_impressions, page_total_media_view_unique umesto page_impressions_unique i page_follows umesto page_fans, dok page_post_engagements broji reakcije, komentare i deljenja.

Python: four Page metrics for the last 28 days
# 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"])

Kako čitati uvide stranice u Node.js?

Isti poziv, a since i until se računaju iz Date.now() u sekundama. Svaka metrika vraća se sa svojim imenom, periodom i listom values sa parovima value i end_time, po jedan za svaki dan; kada je since zadat, prvi end_time pada na dan posle njega, pa su podaci tog dana uključeni. Token mora imati read_insights i pages_read_engagement, od nekoga sa zadatkom ANALYZE.

Node.js: four Page metrics for the last 28 days
// 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);
  }
}

Kako proveriti potpis webhooka u Pythonu?

Ponovo izračunajte X-Hub-Signature-256 iz sirovog tela zahteva i App Secret, pa uporedite dve vrednosti u konstantnom vremenu. Meta potpisuje svaki POST HMAC-SHA256 nad payloadom, ključem App Secret iz osnovnih podešavanja aplikacije u App Dashboard-u, i upisuje ga posle sha256=. Telo prosledite kao bajtove, pre bilo kakvog JSON parsiranja: request.body u Django-u i await request.body() u FastAPI-ju daju bajtove koje je Meta potpisao.

Python: check X-Hub-Signature-256
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"))

Kako proveriti potpis webhooka u Node.js?

Ista provera sa node:crypto, kojem je potrebno telo kao Buffer: u Expressu express.raw ga ostavlja neparsiranog na toj ruti. timingSafeEqual baca grešku za ulaze različitih dužina, pa se provera dužine radi prva. Odgovorite 200 brzo, a posao obavite posle, jer Meta ponavlja neuspele isporuke i može poslati događaj dvaput; stranica o verifikaciji pokriva hub.challenge rukovanje koje dolazi pre bilo kog događaja.

Node.js: check X-Hub-Signature-256
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
// });

Na koje kodove grešaka kod treba da reaguje?

Na one koje Metini vodiči za greške razlikuju, jer svaka traži drugačiji odgovor: ponavljanje odbijenog tokena ili lošeg parametra samo ponovo pada, dok ograničen poziv uspeva posle čekanja. graph() ponavlja privremene kodove i kodove ograničenja, a ostale prosleđuje pozivaocu da ih obradi:

190, 102The token was refused, and the subcode says why. A new sign-in is the fix
10, 200 to 299A permission was not granted or was removed. Grant it again
4, 17, 32, 613An app, user or Page rate limit. Stop, wait, then resume gradually
80001Page calls made with a Page token are throttled; the header gives the minutes
368Blocked for policy violations. Wait, and review what was being sent
100An invalid parameter. Fix the request before sending it again
551The person is not available on Messenger. Do not retry
1, 2A temporary issue on Meta's side. Wait and retry

Kako pokrenuti iste poslove preko easyCoexistence?

Kao MCP alati koje Claude, ChatGPT ili vaš sopstveni agent poziva na povezanoj stranici, a token čuva easyCoexistence. Tokeni stranice se nikada ne dele, pa primeri iznad rade sa tokenom iz vaše sopstvene Meta aplikacije; get_social_credentials vraća ID stranice i Graph API bazu. Alat za svaki posao:

Publishpublish_facebook_post with message, link, image_url or video_url, now or at scheduled_at
Commentslist_social_comments, then reply_to_comment; private set to true sends the one Messenger message
Messengersend_social_dm, with recipient_id set to the sender's ID from the forwarded event
Insightsget_social_insights with metrics and a period, or object_id for one post
Eventsset_social_webhook_destination; each forward carries X-EC-Signature, made with the Page's own secret

Česte greške

  • Pozivanje endpointa stranice korisničkim tokenom. Većina endpointa očekuje sopstveni token stranice, a pozivi sa korisničkim ili aplikacionim tokenom troše te limite umesto stranicinih.
  • Objavljivanje istog teksta dvaput zaredom. Meta odbija uzastopne identične objave greškom 506, pa posao koji se ponovo pokreće mora da menja sadržaj ili preskoči objavu.
  • Sabiranje dnevnih jedinstvenih gledalaca. page_total_media_view_unique broji jedinstvene gledaoce u svakom periodu, pa se dnevne vrednosti ne sabiraju u mesec; umesto toga zatražite period days_28.
  • Slanje tokena stranice u pregledač ili aplikaciju. Ovi pozivi pripadaju serveru, gde token ostaje izvan domašaja svakoga ko može da pročita klijentski kod.
Ovo radite uz EasyCoexistence

US$ 9 do US$ 0.75 po povezivanju mesečno, sa padanjem kako dodajete povezivanja, uz prva 3 dana besplatno.

Često postavljana pitanja

Treba li mi SDK za poziv Facebook Pages API?

Ne. Graph API je HTTPS sa JSON-om, pa su zahtevi u Pythonu i fetch ugrađen u Node.js 18 ili noviji dovoljni, kao što primeri na ovoj stranici pokazuju.

Može li isti kod da objavljuje na više stranica?

Može. /me/accounts vraća poseban token za svaku stranicu, pa čuvajte po jedan za svaku i prosleđujte odgovarajući PAGE_ID i PAGE_TOKEN; pozivi sa tokenom stranice troše ograničenje poziva te stranice.

Odakle PSID za odgovor u Messengeru?

Iz messages webhooka: sender.id u svakom događaju za poruke je Page-scoped ID osobe, jedinstven za tu osobu i stranicu. Korisnički ID-jevi iz Facebook Logina vezani su za aplikaciju i ne rade sa Messenger Platformom.

Koliko košta easyCoexistence za Facebook stranicu?

Svaka povezana stranica računa se kao jedno povezivanje, po US$ 9 do US$ 0.75 po povezivanju mesečno, u zavisnosti od toga koliko ih imate, a prva 3 dana su besplatna; MCP alati su uključeni.

Nastavite sa čitanjem

Povežite prvi kanal za dva minuta.

Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo zvanični API-ji
  • Nadzor 24/7

Provereno na