Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Facebook Pages API dalam Python dan Node.js: contoh yang berfungsi

Python dan Node.js memanggil Facebook Pages API sebagai permintaan HTTPS biasa ke graph.facebook.com/v26.0 dengan token akses Halaman: POST /{page-id}/feed dan /{page-id}/photos menyiarkan, /{post-id}/comments membaca dan membalas komen, POST /{page-id}/messages membalas dalam Messenger, GET /{page-id}/insights membaca metrik, dan HMAC-SHA256 daripada badan mentah menyemak X-Hub-Signature-256 pada setiap webhook.

easyCoexistence memberi Halaman yang disambungkan tugas-tugas ini sebagai alat MCP, daripada publish_facebook_post dan reply_to_comment hingga send_social_dm dan get_social_insights, memajukan acaranya yang ditandatangani dengan X-EC-Signature, dan menyerahkan ID Halaman dan asas API kepada kod anda melalui get_social_credentials.

caption

Parameter text bagi foto Halaman; rujukan foto Meta menandakan message usang di situ.

X-Business-Use-Case-Usage

Header respons yang estimated_time_to_regain_access memberi bilangan minit sehingga panggilan yang tertakluk had kadar berfungsi semula.

RESPONSE

messaging_type bagi balasan kepada mesej yang diterima Halaman, dihantar dalam tetingkap 24 jam.

recipient.comment_id

Cara balasan persendirian menujukan orang yang mengulas, melalui endpoint /{page-id}/messages yang sama.

Apakah yang diperlukan oleh contoh sebelum dijalankan?

ID Halaman dan token akses Halaman itu, dibaca daripada /me/accounts dengan token pengguna berjangka panjang, serta Python 3 dengan requests, atau Node.js 18 ke atas, yang fetch terbina dalamnya tidak memerlukan sebarang pakej. Setiap tugas juga memerlukan kebenarannya pada token dan tugasnya pada Halaman, dan contoh memanggil 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

Bagaimana cara menyiarkan siaran dan foto dalam Python?

Dengan satu pembantu yang digunakan semula oleh contoh kemudian: graph() menambah token Halaman, menghantar parameter GET dalam query string dan medan POST sebagai JSON, seperti contoh Meta sendiri, dan menukar objek ralat Meta kepada GraphError yang membawa code dan error_subcode. Ia menunggu dan mencuba semula hanya kod sementara dan kod had kadar, selama tempoh yang diminta oleh X-Business-Use-Case-Usage apabila header itu kembali, dan melontarkan yang lain serta-merta.

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"])

Bagaimana pula cara menyiarkannya dalam Node.js?

Dengan pembantu yang sama dalam Node.js 18 ke atas, disimpan sebagai fail .mjs supaya top-level await berfungsi, dan fetch terbina dalam menggantikan pustaka klien. Panggilan foto menghantar url dan caption, medan text bagi edge photos; Meta menjawab dengan id foto dan post_id siaran Halaman yang membawa foto itu, manakala panggilan feed menjawab dengan id siaran sahaja.

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);

Bagaimana cara membaca dan membalas komen dalam Python?

Baca komen siaran dengan fields, filter=stream untuk komen pada semua peringkat mengikut masa, dan order=reverse_chronological untuk yang terbaru dahulu, kemudian balas sebagai Halaman dengan menghantar mesej ke edge komen itu sendiri. Token mesti diperoleh daripada seseorang yang boleh melaksanakan MODERATE, atau Meta akan meninggalkan ID komen, dan membalas memerlukan pages_manage_engagement. paging.next membawa ke belakang lagi.

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

Bagaimana cara membaca dan membalas komen dalam Node.js?

Dua panggilan yang sama, dengan objek URL membina query string: GET dengan fields, filter dan order, kemudian POST ke /{comment-id}/comments. can_reply_privately, yang diminta dalam fields, menyatakan sama ada Halaman masih boleh menghantar balasan persendirian kepada pengulas itu, dan ini berbaloi diketahui sebelum contoh Messenger di bawah. Simpan ID komen yang anda balas, supaya larian semula tidak membalas dua kali.

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

Bagaimana cara menghantar balasan Messenger dalam Python?

POST /{page-id}/messages dengan recipient.id ditetapkan kepada ID berskop Halaman orang itu daripada webhook mesej, messaging_type RESPONSE dan text. Contoh menangkap dua penolakan yang tidak berbaloi dicuba semula: ralat 10 dengan subkod 2534022 atau 2018278 apabila tetingkap 24 jam telah tutup, dan 551 apabila orang itu tidak tersedia. private_reply() meletakkan recipient.comment_id di tempat ID, untuk satu mesej yang dibenarkan oleh komen dalam tempoh 7 hari.

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})

Bagaimana cara menghantar balasan Messenger dalam Node.js?

Badan permintaan yang sama dalam JavaScript, dengan recipient, messaging_type dan message dihantar sebagai JSON oleh graph(). Meta menjawab penghantaran yang diterima dengan recipient_id dan message_id, yang berbaloi disimpan bersama perbualan. Balasan persendirian membawa pautan kembali ke komen yang dibalasnya, dan perbualan diteruskan dalam tetingkap 24 jam standard apabila orang itu menulis semula.

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 },
  });
}

Bagaimana cara membaca metrik Halaman dalam Python?

GET /{page-id}/insights dengan senarai metrik dipisahkan koma, period=day dan tetingkap since dan until dalam saat UNIX; satu permintaan meliputi sehingga 90 hari. Tiga metrik ini menggantikan metrik yang telah ditarik balik oleh Meta: page_media_view menggantikan page_impressions, page_total_media_view_unique menggantikan page_impressions_unique dan page_follows menggantikan page_fans, manakala page_post_engagements mengira reaksi, komen dan kongsi.

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"])

Bagaimana cara membaca metrik Halaman dalam Node.js?

Panggilan yang sama, dengan since dan until dikira daripada Date.now() dalam saat. Setiap metrik dipulangkan dengan namanya, tempohnya dan senarai values yang berpasangan value dan end_time, satu bagi setiap hari; apabila since ditetapkan, end_time pertama jatuh pada hari selepasnya, supaya data hari itu termasuk. Token memerlukan read_insights dan pages_read_engagement, daripada seseorang yang mempunyai tugas 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);
  }
}

Bagaimana cara menyemak tandatangan webhook dalam Python?

Kira semula X-Hub-Signature-256 daripada badan permintaan mentah dan rahsia aplikasi, kemudian bandingkan kedua-duanya dalam masa yang tetap. Meta menandatangani setiap POST dengan HMAC-SHA256 bagi payload, dikunci dengan App Secret daripada tetapan asas App Dashboard, dan menulisnya selepas sha256=. Hantar badan sebagai bait, sebelum sebarang huraian JSON: request.body dalam Django dan await request.body() dalam FastAPI kedua-duanya memberi bait yang ditandatangani Meta.

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"))

Bagaimana cara menyemak tandatangan webhook dalam Node.js?

Semakan yang sama dengan node:crypto, yang memerlukan badan sebagai Buffer: dalam Express, express.raw mengekalkannya tanpa dihurai pada laluan itu. timingSafeEqual melontarkan ralat bagi input yang panjangnya berbeza, jadi ujian panjang dijalankan dahulu. Jawab 200 dengan segera dan buat kerja selepas itu, kerana Meta mencuba semula penghantaran yang gagal dan boleh menghantar acara dua kali; halaman pengesahan meliputi jabat tangan hub.challenge yang datang sebelum sebarang acara.

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
// });

Kod ralat yang mana perlu ditangani oleh kod?

Kod yang dibezakan oleh panduan ralat Meta, kerana setiap satu memerlukan respons yang berbeza: mencuba semula token yang ditolak atau parameter yang salah hanya gagal lagi, manakala panggilan yang tertakluk had kadar berjaya selepas menunggu. graph() mencuba semula kod sementara dan kod had kadar, dan melontarkan yang lain untuk pemanggil mengendalikan:

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

Bagaimana cara menjalankan tugas yang sama melalui easyCoexistence?

Sebagai alat MCP yang dipanggil oleh Claude, ChatGPT atau ejen anda sendiri pada Halaman yang disambungkan, dengan token dipegang oleh easyCoexistence. Token Halaman tidak pernah diberikan, jadi contoh di atas berjalan dengan token daripada aplikasi Meta anda sendiri; get_social_credentials memulangkan ID Halaman dan asas Graph API. Alat bagi setiap tugas:

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

Kesilapan biasa

  • Memanggil endpoint Halaman dengan token pengguna. Kebanyakannya menjangka token Halaman itu sendiri, dan panggilan yang dibuat dengan token pengguna atau aplikasi dikira terhadap had kadar tersebut dan bukannya had kadar Halaman.
  • Menyiarkan teks yang sama dua kali berturut-turut. Meta menolak siaran pendua berturut-turut dengan ralat 506, jadi tugas yang dijalankan semula mesti mempelbagaikan kandungan atau melangkau siaran itu.
  • Menjumlahkan penonton unik harian. page_total_media_view_unique mengira penonton unik dalam setiap tempoh, jadi nilai harian tidak dijumlahkan kepada jumlah sebulan; minta period days_28 sebaliknya.
  • Menghantar token Halaman kepada pelayar atau aplikasi. Panggilan ini patut berada di pelayan, tempat token kekal di luar capaian sesiapa yang boleh membaca klien.
Menggunakan EasyCoexistence untuk ini

Daripada US$ 9 hingga US$ 0.75 setiap sambungan sebulan, berkurang apabila anda menambah sambungan, dengan 3 hari pertama percuma.

Soalan lazim

Adakah saya perlukan SDK untuk memanggil Facebook Pages API?

Tidak. Graph API ialah HTTPS dengan JSON, jadi permintaan dalam Python dan fetch yang terbina dalam Node.js 18 ke atas sudah memadai, seperti yang ditunjukkan oleh contoh pada halaman ini.

Bolehkah kod yang sama menyiarkan ke beberapa Halaman?

Boleh. /me/accounts memulangkan token berasingan bagi setiap Halaman, jadi simpan satu untuk setiap Halaman dan hantar PAGE_ID dan PAGE_TOKEN yang sepadan; panggilan yang dibuat dengan token Halaman dikira terhadap had kadar Halaman itu sendiri.

Dari mana datangnya PSID bagi balasan Messenger?

Daripada webhook mesej: sender.id dalam setiap acara messaging ialah ID berskop Halaman orang itu, unik bagi orang dan Halaman tersebut. ID pengguna daripada Facebook Login berskop aplikasi dan tidak berfungsi dengan Messenger Platform.

Berapakah kos easyCoexistence untuk Halaman Facebook?

Setiap Halaman yang disambungkan dikira sebagai satu sambungan, pada US$ 9 hingga US$ 0.75 setiap sambungan sebulan bergantung kepada bilangan yang anda ada, dan 3 hari pertama adalah percuma; alat MCP disertakan.

Teruskan membaca

Sambungkan saluran pertama anda dalam masa dua minit.

Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.

  • 3 hari percuma
  • Batal bila-bila masa
  • API rasmi sahaja
  • Dipantau 24/7

Disahkan pada