Facebook — Bài viết
Xem bài viết (Get post) — facebook.get_post
Reads one Page post by id: message, created time, permalink and attachments. Pass fields to request counts such as reactions.summary(true).
| Tác động | Rủi ro | Cần duyệt | Idempotent | Scopes |
|---|---|---|---|---|
| NONE | low | không | có | pages_read_engagement, pages_read_user_content |
Input
| Field | Nhãn | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|---|
page_id | Mã Page (ID) | string | có | Page id. From facebook.list_managed_pages. |
post_id | Mã bài viết | string | có | Post id, e.g. "123_456". From facebook.get_page_posts. |
fields | Các trường cần lấy (fields) | string | không | Comma-separated Graph fields to return, e.g. "id,message,created_time". |
Field thêm: bỏ qua.
Output
| Field | Nhãn | Kiểu | Mô tả |
|---|---|---|---|
id | Mã bài viết | string | |
message | Nội dung | string | |
created_time | Thời gian tạo | string | |
permalink_url | Liên kết bài viết | string |
Xem insights của bài viết (Get post insights) — facebook.get_post_insights
Reads insights metrics for one post (e.g. post_impressions, post_clicks). metric is required and comma separated.
| Tác động | Rủi ro | Cần duyệt | Idempotent | Scopes |
|---|---|---|---|---|
| NONE | low | không | có | read_insights, pages_read_engagement |
Input
| Field | Nhãn | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|---|
page_id | Mã Page (ID) | string | có | Page id. From facebook.list_managed_pages. |
post_id | Mã bài viết | string | có | Post id, e.g. "123_456". From facebook.get_page_posts. |
metric | Chỉ số (metric) | string | có | Comma-separated insight metrics, e.g. "post_impressions,post_clicks". |
Field thêm: bỏ qua.
Output
| Field | Nhãn | Kiểu | Mô tả |
|---|---|---|---|
data | Danh sách kết quả | array of object | |
data[].id | string | ||
data[].name | string | ||
data[].period | string | ||
data[].values | array | ||
paging | Phân trang | object | |
paging.cursors | object |
Xem lượt cảm xúc của bài viết (Get post reactions) — facebook.get_post_reactions
Lists who reacted to a post and with which reaction. type filters by LIKE, LOVE, WOW, HAHA, SAD or ANGRY. Supports paging.
| Tác động | Rủi ro | Cần duyệt | Idempotent | Scopes |
|---|---|---|---|---|
| NONE | low | không | có | pages_read_engagement, pages_read_user_content |
Input
| Field | Nhãn | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|---|
page_id | Mã Page (ID) | string | có | Page id. From facebook.list_managed_pages. |
post_id | Mã bài viết | string | có | Post id, e.g. "123_456". From facebook.get_page_posts. |
type | Loại cảm xúc | string | không | Only this reaction, e.g. LIKE, LOVE, WOW, HAHA, SAD, ANGRY or CARE. Empty = all. |
limit | Số kết quả tối đa | integer | không | Max items per page (1-100). Min 1. Max 100. |
after | Con trỏ trang tiếp theo | string | không | Cursor for the next page, from paging.cursors.after of the previous call. |
Field thêm: bỏ qua.
Output
| Field | Nhãn | Kiểu | Mô tả |
|---|---|---|---|
data | Danh sách kết quả | array of object | |
data[].id | string | ||
data[].name | string | ||
data[].type | string | ||
paging | Phân trang | object | |
paging.cursors | object |
Xem bài viết đã lên lịch (Get scheduled posts) — facebook.get_scheduled_posts
Lists unpublished posts scheduled on a Page, with their scheduled publish time. Use before rescheduling or cancelling a post.
| Tác động | Rủi ro | Cần duyệt | Idempotent | Scopes |
|---|---|---|---|---|
| NONE | low | không | có | pages_read_engagement, pages_read_user_content |
Input
| Field | Nhãn | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|---|
page_id | Mã Page (ID) | string | có | Page id. From facebook.list_managed_pages. |
fields | Các trường cần lấy (fields) | string | không | Comma-separated Graph fields to return, e.g. "id,message,created_time". |
limit | Số kết quả tối đa | integer | không | Max items per page (1-100). Min 1. Max 100. |
after | Con trỏ trang tiếp theo | string | không | Cursor for the next page, from paging.cursors.after of the previous call. |
Field thêm: bỏ qua.
Output
| Field | Nhãn | Kiểu | Mô tả |
|---|---|---|---|
data | Danh sách kết quả | array of object | |
data[].id | string | ||
data[].message | string | ||
data[].scheduled_publish_time | integer | ||
data[].created_time | string | ||
paging | Phân trang | object | |
paging.cursors | object |
Đăng bài viết (Create post) — facebook.create_post
Publishes a text or link post to a Page feed. Waits for human approval; once approved the post goes public. Set published=false with scheduled_publish_time (unix seconds) to schedule it instead.
| Tác động | Rủi ro | Cần duyệt | Idempotent | Scopes |
|---|---|---|---|---|
| WRITE | high | có | không | pages_manage_posts, pages_read_engagement |
Input
| Field | Nhãn | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|---|
page_id | Mã Page (ID) | string | có | Page id. From facebook.list_managed_pages. |
message | Nội dung | string | có | Post text. |
link | Liên kết đính kèm | string | không | URL to attach as a link preview, e.g. https://example.com. |
published | Đăng ngay (false = lưu nháp/lên lịch) | boolean | không | Publish now (default true). Set false to save unpublished or to schedule. |
scheduled_publish_time | Giờ đăng dự kiến (unix time) | integer | không | Publish time in unix seconds, 10 minutes to 30 days ahead; needs published=false. |
Field thêm: bỏ qua.
Output
| Field | Nhãn | Kiểu | Mô tả |
|---|---|---|---|
id | Mã bài viết | string |
Thẻ duyệt: hiển thị dạng post (page → page_id, message → message, link → link, scheduled_at → scheduled_publish_time).
Đăng bài viết kèm ảnh (Create photo post) — facebook.create_photo_post
Publishes one photo from a public image url to a Page, with an optional caption. Waits for human approval; once approved the photo goes public.
| Tác động | Rủi ro | Cần duyệt | Idempotent | Scopes |
|---|---|---|---|---|
| WRITE | high | có | không | pages_manage_posts, pages_read_engagement |
Input
| Field | Nhãn | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|---|
page_id | Mã Page (ID) | string | có | Page id. From facebook.list_managed_pages. |
url | Liên kết ảnh công khai | string | có | Public https URL of the image. |
caption | Chú thích | string | không | Text shown with the photo. |
published | Đăng ngay (false = lưu nháp/lên lịch) | boolean | không | Publish now (default true). Set false to save unpublished or to schedule. |
scheduled_publish_time | Giờ đăng dự kiến (unix time) | integer | không | Publish time in unix seconds, 10 minutes to 30 days ahead; needs published=false. |
Field thêm: bỏ qua.
Output
| Field | Nhãn | Kiểu | Mô tả |
|---|---|---|---|
id | Mã ảnh | string | |
post_id | Mã bài viết | string |
Thẻ duyệt: hiển thị dạng post (page → page_id, message → caption, media → url, scheduled_at → scheduled_publish_time).
Sửa bài viết (Update post) — facebook.update_post
Replaces the message of an existing Page post. Waits for human approval; once approved the edited text is public.
| Tác động | Rủi ro | Cần duyệt | Idempotent | Scopes |
|---|---|---|---|---|
| WRITE | high | có | không | pages_manage_posts, pages_read_engagement |
Input
| Field | Nhãn | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|---|
page_id | Mã Page (ID) | string | có | Page id. From facebook.list_managed_pages. |
post_id | Mã bài viết | string | có | Post id, e.g. "123_456". From facebook.get_page_posts. |
message | Nội dung mới | string | có | New post text; replaces the old text. |
Field thêm: bỏ qua.
Output
| Field | Nhãn | Kiểu | Mô tả |
|---|---|---|---|
success | Thành công | boolean |
Thẻ duyệt: hiển thị dạng post (page → page_id, message → message, link → link, scheduled_at → scheduled_publish_time).
Xóa bài viết (Delete post) — facebook.delete_post
Deletes a Page post. Waits for human approval; once approved the post and its comments are removed and cannot be restored.
| Tác động | Rủi ro | Cần duyệt | Idempotent | Scopes |
|---|---|---|---|---|
| WRITE | high | có | có | pages_manage_posts, pages_read_engagement |
Input
| Field | Nhãn | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|---|
page_id | Mã Page (ID) | string | có | Page id. From facebook.list_managed_pages. |
post_id | Mã bài viết | string | có | Post id, e.g. "123_456". From facebook.get_page_posts. |
Field thêm: bỏ qua.
Output
| Field | Nhãn | Kiểu | Mô tả |
|---|---|---|---|
success | Thành công | boolean |
Đăng ngay bài viết đã lên lịch (Publish scheduled post now) — facebook.publish_scheduled_post
Publishes an unpublished or scheduled post immediately (is_published=true). Waits for human approval; once approved the post goes public.
| Tác động | Rủi ro | Cần duyệt | Idempotent | Scopes |
|---|---|---|---|---|
| WRITE | high | có | không | pages_manage_posts, pages_read_engagement |
Input
| Field | Nhãn | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|---|
page_id | Mã Page (ID) | string | có | Page id. From facebook.list_managed_pages. |
post_id | Mã bài viết | string | có | Post id, e.g. "123_456". From facebook.get_page_posts. |
Field thêm: bỏ qua.
Output
| Field | Nhãn | Kiểu | Mô tả |
|---|---|---|---|
success | Thành công | boolean |
Đổi giờ đăng bài viết (Reschedule post) — facebook.reschedule_post
Changes the scheduled publish time (unix seconds) of a still-unpublished post. Does not publish anything now.
| Tác động | Rủi ro | Cần duyệt | Idempotent | Scopes |
|---|---|---|---|---|
| WRITE | medium | không | không | pages_manage_posts, pages_read_engagement |
Input
| Field | Nhãn | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|---|
page_id | Mã Page (ID) | string | có | Page id. From facebook.list_managed_pages. |
post_id | Mã bài viết | string | có | Post id, e.g. "123_456". From facebook.get_page_posts. |
scheduled_publish_time | Giờ đăng dự kiến (unix time) | integer | có | Publish time in unix seconds, 10 minutes to 30 days ahead; needs published=false. |
Field thêm: bỏ qua.
Output
| Field | Nhãn | Kiểu | Mô tả |
|---|---|---|---|
success | Thành công | boolean |
Thẻ duyệt: hiển thị dạng post (page → page_id, message → message, link → link, scheduled_at → scheduled_publish_time).
Làm mới bản xem trước liên kết (Refresh URL preview) — facebook.refresh_url_scrape
Asks Facebook to re-scrape a URL so link previews pick up new title and image. Uses the connected user token; no Page is needed.
| Tác động | Rủi ro | Cần duyệt | Idempotent | Scopes |
|---|---|---|---|---|
| WRITE | low | không | không | — |
Input
| Field | Nhãn | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|---|
id | Liên kết cần làm mới | string | có | Full URL to re-scrape, e.g. https://example.com/page. |
Field thêm: bỏ qua.
Output
| Field | Nhãn | Kiểu | Mô tả |
|---|---|---|---|
id | Liên kết | string | |
title | Tiêu đề | string |
Đăng bài nhiều ảnh (Create multi-photo post) — facebook.create_multi_photo_post
Publishes one Page post with 1-10 photos (https URLs): uploads each photo unpublished, then attaches them to a feed post. Waits for human approval.
| Tác động | Rủi ro | Cần duyệt | Idempotent | Scopes |
|---|---|---|---|---|
| WRITE | high | có | không | pages_manage_posts, pages_read_engagement |
Input
| Field | Nhãn | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|---|
page_id | Mã Page (ID) | string | có | Page id. From facebook.list_managed_pages. |
photo_urls | Danh sách URL ảnh (https) | array of string | có | 1-10 public https image URLs, in display order. |
message | Nội dung bài viết | string | không | Post text. |
published | Đăng ngay (false = lưu nháp/lên lịch) | boolean | không | Publish now (default true). Set false to save unpublished or to schedule. |
scheduled_publish_time | Giờ đăng dự kiến (unix time) | integer | không | Publish time in unix seconds, 10 minutes to 30 days ahead; needs published=false. |
Field thêm: bỏ qua.
Output
| Field | Nhãn | Kiểu | Mô tả |
|---|---|---|---|
id | Mã bài viết | string |
Đăng video (Create video post) — facebook.create_video_post
Publishes a video to a Page from a public https file URL, via the Graph video host. Waits for human approval.
| Tác động | Rủi ro | Cần duyệt | Idempotent | Scopes |
|---|---|---|---|---|
| WRITE | high | có | không | pages_manage_posts, pages_read_engagement |
Input
| Field | Nhãn | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|---|
page_id | Mã Page (ID) | string | có | Page id. From facebook.list_managed_pages. |
file_url | URL video (https) | string | có | Public https URL of the video file, e.g. an .mp4. |
description | Mô tả | string | không | Text shown with the video. |
title | Tiêu đề | string | không | Video title. |
published | Đăng ngay (false = lưu nháp/lên lịch) | boolean | không | Publish now (default true). Set false to save unpublished or to schedule. |
scheduled_publish_time | Giờ đăng dự kiến (unix time) | integer | không | Publish time in unix seconds, 10 minutes to 30 days ahead; needs published=false. |
Field thêm: bỏ qua.
Output
| Field | Nhãn | Kiểu | Mô tả |
|---|---|---|---|
id | Mã video | string |
Tải nhiều ảnh cùng lúc (Upload photos in batch) — facebook.upload_photos_batch
Uploads up to 50 photos (https URLs, optional caption) to a Page or album in one Graph batch call. Per-photo failures are reported in results, not raised. Waits for human approval.
| Tác động | Rủi ro | Cần duyệt | Idempotent | Scopes |
|---|---|---|---|---|
| WRITE | high | có | không | pages_manage_posts, pages_read_engagement |
Input
| Field | Nhãn | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|---|
page_id | Mã Page (ID) | string | có | Page id. From facebook.list_managed_pages. |
photos | Danh sách ảnh (url, caption) | array of object | có | Photos as objects, e.g. [{"url": "https://...", "caption": "..."}]. |
photos[].url | string | có | ||
photos[].caption | string | không | ||
album_id | Mã album (mặc định: Page) | string | không | Album id to upload into. Empty = the Page's photos. |
Field thêm: bỏ qua.
Output
| Field | Nhãn | Kiểu | Mô tả |
|---|---|---|---|
results | Kết quả từng ảnh | array of object | |
results[].id | string | ||
results[].success | boolean | ||
results[].error | string |