Facebook Fanpage Manager cho OpenClaw
Author: Pham Triet
Cộng đồng: OpenClaw Việt Nam
Skill quản lý Fanpage Facebook toàn diện: đăng bài, reply comment, auto-reply Messenger.
Bao gồm hướng dẫn lấy token từ A đến Z.
Mục lục
- Hướng dẫn lấy Page ID & Token (BẮT BUỘC đọc trước)
- Cấu hình OpenClaw
- Đăng bài Fanpage
- Reply comment
- Auto-reply Messenger
- Xem Insights
→ Đọc references/setup-guide.md để xem hướng dẫn CÓ HÌNH chi tiết từng bước.
→ Đọc references/api-reference.md để xem danh sách API endpoints.
1. Hướng dẫn lấy Page ID & Access Token
Đây là bước QUAN TRỌNG NHẤT — không có token thì skill không hoạt động.
→ Hướng dẫn đầy đủ có trong file references/setup-guide.md
Tóm tắt nhanh 4 bước:
Bước 1: Tạo tài khoản Meta for Developers
→ developers.facebook.com → Get Started
Bước 2: Tạo App
→ developers.facebook.com/apps → Tạo ứng dụng
→ Chọn "Tương tác với khách hàng trên Messenger"
Bước 3: Lấy Page ID + Short-lived Token
→ developers.facebook.com/tools/explorer/
→ Chọn App → Thêm quyền → Generate Access Token
→ Query "me/accounts" → lấy "id" và "access_token"
Bước 4: Đổi sang Token vĩnh viễn
→ Lấy App ID + App Secret từ Settings → Basic
→ Query đổi token (xem chi tiết trong setup-guide.md)
2. Cấu hình OpenClaw
Sau khi có Page ID và Token vĩnh viễn, cấu hình trong ~/.openclaw/openclaw.json:
{
"skills": {
"entries": {
"facebook-fanpage-manager": {
"env": {
"FACEBOOK_PAGE_ID": "123456789012345",
"FACEBOOK_ACCESS_TOKEN": "EAAG...your_permanent_page_token..."
}
}
}
}
}
Kiểm tra kết nối:
curl "https://graph.facebook.com/v21.0/$FACEBOOK_PAGE_ID?fields=name,followers_count" \
-H "Authorization: Bearer $FACEBOOK_ACCESS_TOKEN"
Nếu trả về tên Fanpage và số followers → kết nối thành công.
3. Đăng bài Fanpage
Đăng bài text
curl -X POST "https://graph.facebook.com/v21.0/$FACEBOOK_PAGE_ID/feed" \
-H "Authorization: Bearer $FACEBOOK_ACCESS_TOKEN" \
-d "message=Nội dung bài đăng"
Đăng bài có ảnh
curl -X POST "https://graph.facebook.com/v21.0/$FACEBOOK_PAGE_ID/photos" \
-H "Authorization: Bearer $FACEBOOK_ACCESS_TOKEN" \
-F "url=https://example.com/image.jpg" \
-F "caption=Nội dung kèm ảnh"
Đăng bài có link
curl -X POST "https://graph.facebook.com/v21.0/$FACEBOOK_PAGE_ID/feed" \
-H "Authorization: Bearer $FACEBOOK_ACCESS_TOKEN" \
-d "message=Xem thêm tại đây" \
-d "link=https://example.com"
Lấy danh sách bài đã đăng
curl "https://graph.facebook.com/v21.0/$FACEBOOK_PAGE_ID/posts?fields=message,created_time,shares,likes.summary(true),comments.summary(true)&limit=10" \
-H "Authorization: Bearer $FACEBOOK_ACCESS_TOKEN"
4. Reply comment
Lấy comments của bài viết
curl "https://graph.facebook.com/v21.0/{post_id}/comments?fields=from,message,created_time" \
-H "Authorization: Bearer $FACEBOOK_ACCESS_TOKEN"
Reply một comment
curl -X POST "https://graph.facebook.com/v21.0/{comment_id}/comments" \
-H "Authorization: Bearer $FACEBOOK_ACCESS_TOKEN" \
-d "message=Cảm ơn bạn đã quan tâm!"
Quy trình auto-reply comment (AI soạn nội dung)
- Lấy danh sách bài viết mới nhất
- Lấy comments chưa reply
- Dùng AI phân tích nội dung comment
- Soạn reply phù hợp
- Gửi reply qua API
5. Auto-reply Messenger
Gửi tin nhắn cho người dùng
curl -X POST "https://graph.facebook.com/v21.0/$FACEBOOK_PAGE_ID/messages" \
-H "Authorization: Bearer $FACEBOOK_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"recipient": {"id": "USER_PSID"},
"message": {"text": "Xin chào! Cảm ơn bạn đã nhắn tin."}
}'
Lấy danh sách conversations
curl "https://graph.facebook.com/v21.0/$FACEBOOK_PAGE_ID/conversations?fields=participants,messages{message,from,created_time}&limit=10" \
-H "Authorization: Bearer $FACEBOOK_ACCESS_TOKEN"
Webhook cho Messenger (realtime auto-reply)
Để nhận tin nhắn realtime, cần setup webhook. Xem chi tiết trong references/setup-guide.md phần "Setup Webhook".
Lưu ý: Webhook cần server chạy liên tục (VPS, ngrok, hoặc Cloudflare Tunnel).
Nếu không có server, vẫn có thể dùng cách polling (lấy tin nhắn định kỳ).
Cách polling (không cần webhook)
# Lấy tin nhắn mới mỗi 30 giây
curl "https://graph.facebook.com/v21.0/$FACEBOOK_PAGE_ID/conversations?fields=messages.limit(1){message,from,created_time}&limit=5" \
-H "Authorization: Bearer $FACEBOOK_ACCESS_TOKEN"
Quy trình polling:
- Cứ mỗi 30–60 giây, lấy danh sách conversations mới
- Kiểm tra tin nhắn chưa reply
- Dùng AI soạn reply
- Gửi reply qua Send API
6. Xem Insights
Thống kê Fanpage
curl "https://graph.facebook.com/v21.0/$FACEBOOK_PAGE_ID/insights?metric=page_impressions,page_engaged_users,page_fans&period=day" \
-H "Authorization: Bearer $FACEBOOK_ACCESS_TOKEN"
Thống kê bài viết
curl "https://graph.facebook.com/v21.0/{post_id}/insights?metric=post_impressions,post_engaged_users,post_clicks" \
-H "Authorization: Bearer $FACEBOOK_ACCESS_TOKEN"
Lưu ý quan trọng
- Token vĩnh viễn vẫn có thể hết hạn nếu: đổi mật khẩu Facebook, gỡ quyền App, hoặc App bị vô hiệu hóa. Khi đó cần lấy token mới.
- Rate limit: Facebook giới hạn khoảng 200 requests/giờ. Không gọi API quá nhiều.
- Quyền cần có:
pages_show_list, pages_messaging, pages_manage_metadata, pages_manage_posts, pages_read_engagement.
- App Mode: App phải ở chế độ Live (không phải Development) để hoạt động với người dùng khác.
Cấu trúc thư mục skill
facebook-fanpage-manager/
├── SKILL.md ← File này
├── references/
│ ├── setup-guide.md ← Hướng dẫn lấy token từng bước chi tiết
│ └── api-reference.md ← Danh sách API endpoints
└── scripts/
└── check-connection.sh ← Script kiểm tra kết nối
