Tài liệu nội bộ · Phiếu triển khai

Kết nối Lark Base với Facebook
để triển khai đăng bài tự động

Điền 5 ô ở tab Triển khai. Khối lệnh tự ghép theo những gì bạn gõ. Sao chép nó, dán vào Claude Code — máy sẽ tự dựng bảng, kéo danh sách Fanpage về Lark và nối nút Đăng cho bạn.

Bạn chỉ phải tự tay đúng 2 việc: lấy token Facebook loại dài hạn, và bấm vài nút mà máy không bấm thay được. Phần còn lại chỉ là điền ô rồi dán.

Lấy token FBtay · ~5 phút

Điền 5 ôlệnh tự ghép

Dán vào Claude Codemáy dựng bảng

Bấm nút Đăngtay · 3 nút cuối

Repo mkt-tripower/mentor-club-facebook

2Bảng bạn dùng

2Lệnh bấm được

3Mảnh ghép

0Tiến trình chạy ngầm

Hình 1 · Toàn cảnh

Một vòng khép kín, Lark đứng giữa

Bạn viết bài trong bảng Lark. Máy mang bài đó sang Facebook, đăng xong thì đem kết quả về ghi lại đúng dòng bạn vừa viết.

Đi hết một vòng là về chỗ cũ. Bạn không cần mở Facebook để kiểm tra — bài lên được hay hỏng đều hiện ngay trên dòng bạn vừa viết.

Nguyên tắc

Bạn viết bài, máy ghi kết quả

Hai cột dưới đây đừng lẫn vào nhau. Nếu bạn tự gõ tay vào cột bên phải, bạn đang ghi đè lên dấu vết máy để lại — và mất luôn cách kiểm tra bài nào đã lên.

Bạn điền

Nội dung bài đăng

Bảng 14.3 — mỗi dòng là một bài.

PageChọn Fanpage muốn đăng. Chọn nhiều Page thì bài lên nhiều nơi cùng lúc.
LoạiHình ảnh → lên tường. Video → thành Reel.
Nội dungPhần chữ của bài viết.
TệpKéo ảnh hoặc video thả vào ô.

Máy ghi

Dấu vết sau khi đăng

Đừng sửa tay — đây là nhật ký của máy.

Bảng 14.1Danh sách Page kèm chìa khoá riêng của từng Page.
Trạng tháiThành công hay Thất bại.
LinkĐường dẫn tới bài vừa lên.
LogLý do cụ thể khi bài hỏng.

Hai lệnh

Toàn bộ thứ có thể bấm

Lark không tự đăng bài lên Facebook. Lark chỉ gõ cửa GitHub; GitHub mới dựng máy và gọi sang Facebook. Cả hệ thống rút gọn lại còn đúng hai lệnh này.

fetch-pages

Kéo danh sách Fanpage về

Lấy về mọi Page bạn đang quản trị, kèm chìa khoá riêng của từng Page, ghi vào bảng 14.1. Chạy lại mỗi khi bạn thêm Page mới.

dang-bai

Đăng bài lên Facebook

Lấy đúng dòng bạn vừa tick, đẩy ảnh hoặc Reel lên Page, rồi ghi link bài trở lại chính dòng đó.

Vận hành

Một bài đăng đi qua những đâu

Mốc thời gian đo trên bài thật, tính từ lúc bạn bấm nút Đăng.

Bạn viết Điền một dòng ở bảng 14.3 Chọn Page, chọn loại, gõ nội dung, kéo tệp vào ô.
Bạn bấm Tick ô Đăng Lark gọi sang GitHub. Nếu thấy trả về mã 204 thì nghĩa là đã nhận lệnh — chưa phải đã đăng xong.
30–60 giây Máy làm việc Tải tệp từ Lark xuống, đẩy lên Facebook, rồi chờ Facebook xử lý xong video nếu là Reel.
Xong Kết quả về đúng dòng Cột Trạng thái chuyển thành Thành công và cột Link hiện đường dẫn bài. Nếu hỏng, lý do nằm ở cột Log.

Ba câu là hiểu cả hệ

Hệ không tự chạy. Không có tiến trình nào chạy ngầm — nó chỉ động khi bạn bấm nút hoặc hẹn giờ trong Lark.
Bảng là sự thật. Bài lên được hay hỏng đều hiện trên chính dòng bạn viết, không phải mở Facebook ra dò.
Chìa khoá có hạn dùng. Token mặc định của Facebook chỉ sống một hai giờ. Phải đổi sang loại dài hạn, nếu không hôm nay chạy ngon mai chết im lặng.

Lấy token Facebook dài hạn

Đây là bước hay hỏng nhất. Facebook mặc định đưa cho bạn token sống 1–2 giờ. Cài xong bạn thấy chạy đúng, rồi vài giờ sau mọi lệnh lặng lẽ hỏng mà không báo gì cả. Phải đổi sang token dài hạn (~60 ngày) trước khi làm bất cứ bước nào khác.

Mở Graph API Explorer → chọn app của bạn → tick đủ 3 quyền: pages_show_list, pages_read_engagement, pages_manage_posts → bấm Generate Access Token.
Copy chuỗi bắt đầu bằng EAA… vừa hiện ra. Mở Access Token Debugger, dán vào, bấm Debug.
Kéo xuống cuối trang, bấm Extend Access Token. Chuỗi mới hiện ra mới là thứ cần dùng — copy chuỗi mới, đừng copy lại chuỗi cũ.

Kiểm nhanh 10 giây: dán chuỗi mới vào Debugger lần nữa. Dòng Expires phải ghi khoảng 2 tháng nữa. Nếu vẫn ghi vài giờ, nghĩa là bạn đang cầm nhầm chuỗi cũ — quay lại bước 3.

Điền 5 ô của bạn

Gõ tới đâu, khối lệnh ở mục 03 tự cập nhật tới đó. Ô nào để trống thì khối lệnh vẫn hiện giá trị mẫu — nhưng khi đó bạn phải tự thay bằng tay lúc chat.

LARK_APP_ID biến Lark Developer Console → app của bạn → mục Credentials & Basic Info.

LARK_APP_SECRET bí mật Nằm ngay dưới App ID, cùng một trang.

LARK_BASE_ID biến Mở Base rồi dán nguyên cái link trên thanh địa chỉ vào đây. Link dạng /wiki/… vẫn dán được — máy tự tra ra mã thật.

FB_USER_TOKEN bí mật Chuỗi dài hạn lấy ở mục 01. Dán nhầm chuỗi ngắn hạn thì vài giờ sau hỏng im lặng.

GITHUB_PAT bí mật Đây là chìa để nút Đăng trong Lark gọi được sang GitHub. Chưa có thì lấy ở khung ngay dưới.

Fanpage muốn dùng mặc định Không cần điền. Mặc định là tất cả Page bạn đang quản trị — khối lệnh đã ghi sẵn. Chỉ điền khi muốn giới hạn vài Page cụ thể.

Repo nguồn mặc định Không cần điền. Chỉ đổi khi bạn dùng một bản mã nguồn khác.

0/5 ô

Chưa có GITHUB_PAT? Bấm nút bên cạnh — GitHub sẽ mở sẵn trang tạo token với quyền repo và workflow đã tick giúp bạn. Còn đúng hai chỗ bạn phải tự chọn:

Ô Expiration → chọn No expiration. Nếu để mặc định 30 days thì đúng một tháng sau nút Đăng tự chết mà không báo gì.
Bấm Generate token ở cuối trang. Chuỗi ghp_… chỉ hiện đúng một lần — copy ngay rồi dán vào ô GITHUB_PAT ở trên.

Tạo GITHUB_PAT ↗

Các giá trị này chỉ nằm trong trình duyệt của bạn — trang không gửi đi đâu và không lưu lại. Đóng tab là mất sạch. Che khi chia sẻ màn hình

Khối lệnh — sao chép rồi dán vào Claude Code

Lệnh triển khai

Mẹo: bấm Ctrl+Enter (Mac: ⌘+Enter) để sao chép nhanh. Gõ sai một ký tự trong secret là lỗi câm — máy vẫn báo đã nhận lệnh mà thật ra không chạy gì.

Máy sẽ dựng những gì

Bộ này chạy đúng hai việc: kéo danh sách Fanpage về, và đăng bài từ Lark lên Facebook. Mỗi việc là một link HTTP để bạn gắn vào nút bấm trong Lark.

Bảng	Chứa gì	Lệnh chạy
14.1	Danh sách Fanpage + access_token riêng của từng Page	`fetch-pages`
14.3	Nơi bạn viết bài rồi bấm Đăng — ảnh hoặc Reel	`dang-bai`

Lệnh init-tables chỉ chạy một lần lúc cài để dựng bảng. Nó tạo sẵn thêm vài bảng chưa dùng tới — cứ để nguyên, đừng xoá. Sau này cần mở rộng thì không phải cài lại từ đầu.

Ba việc máy không bấm thay được

Đây là ba chỗ hay tắc nhất. Máy sẽ dừng lại và nhắc bạn, nhưng biết trước thì đỡ mất thời gian.

Bật Actions trên bản repo vừa nhân bản Vào tab Actions của repo mới → bấm nút xanh "I understand my workflows, go ahead and enable them". GitHub cố tình tắt sẵn khi bạn fork. Bỏ bước này thì mọi lệnh HTTP đều trả mã 204 — trông y như thành công — nhưng thực tế không chạy gì cả.
Cho app Lark vào Base với quyền sửa Mở Base → nút ••• góc trên bên phải → thêm ứng dụng bạn vừa tạo → chọn quyền Can edit. Thiếu bước này thì máy đọc được nhưng không ghi được: nhìn như đang chạy mà bảng vẫn trống trơn.
Đổi cột Đăng ở bảng 14.3 thành kiểu Nút bấm Lark không cho tạo cột kiểu Nút bấm bằng API, nên bạn phải tự đổi bằng tay trong Base. Có nút rồi thì automation mới bắt được cú bấm của bạn.

Đăng thử bài đầu tiên

Sau khi máy báo xong, mở bảng 14.3 trong Base và làm đúng một dòng:

Cột	Điền gì
Page	Chọn Page muốn đăng. Chọn nhiều Page thì bài lên nhiều Page cùng lúc.
Loại	Hình ảnh → đăng lên tường. Video → đăng dạng Reel: MP4 dọc 9:16, dài 3–90 giây.
Nội dung	Phần chữ của bài viết.
Ảnh/video	Kéo tệp thả vào ô.
Đăng	Bấm nút, rồi chờ 30–60 giây.

Xong thì cột Trạng thái chuyển thành Thành công và cột Link bài đăng hiện link. Nếu Thất bại, lý do nằm ở cột Log. Muốn đăng lại một dòng: xoá chữ Thành công ở cột Trạng thái rồi bấm Đăng lần nữa.

Nhớ chạy fetch-pages trước khi đăng. Page chưa có trong bảng 14.1 thì không đăng lên được.