Mentor Camp

Nối Facebook, TikTok, YouTube và web bán hàng vào Lark Base

Không cần biết lập trình — điền chìa khóa vào prompt, dán vào Claude Code, chờ nó cài.

Chuẩn bị một lần (~30 phút)

Bốn chìa khóa này dùng chung cho mọi module. Điền một lần ở đây, tất cả khối lệnh bên dưới tự thay giá trị thật vào.

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

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

LARK_BASE_ID Mở Base rồi dán nguyên link trên thanh địa chỉ. Link có /wiki/ vẫn dán được.

GITHUB_PAT bí mật Token cổ điển, quyền repo. Chưa có thì lấy ở khung xanh ngay dưới.

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

Ô Expiration → chọn No expiration. Để mặc định 30 days thì một tháng sau các nút bấm tự chết mà không báo gì.
Bấm Generate token. Chuỗi ghp_… chỉ hiện một lần — copy ngay rồi dán vào ô 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. Ẩn khi chia sẻ màn hình

Hai việc bắt buộc, hay bị quên:

Cấp quyền bitable:app cho app Lark rồi bấm Publish. Không publish thì quyền không có hiệu lực nhưng hệ thống không báo lỗi — nhìn như chạy mà không ra kết quả.
Nếu link Base có chữ /wiki/ — không sao, prompt đã xử lý sẵn. Đừng xóa câu đó. Xóa là bài đăng mất ảnh.

Cách dùng prompt

Mở Claude Code (gõ claude).
Copy cả khối lệnh của module bạn cần. Ô nào chưa điền ở mục 01 thì thay giá trị mẫu (cli_xxxx, ghp_xxxx…) bằng chìa khóa thật.
Dán vào, Enter — Claude hỏi gì thì trả lời, xin phép chạy lệnh thì đồng ý.
Chờ nó báo cáo kết quả.

Không xóa bớt câu nào trong prompt, kể cả câu trông thừa — đó là các câu phòng lỗi đã từng xảy ra thật.

Chọn module để cài

Thứ tự các thẻ là thứ tự nên làm: dễ và không rủi ro trước, dính tiền thật để sau cùng.

Làm module này đầu tiên~20 phútkhông rủi ro

Dễ nhất, chỉ cần thêm một chìa khóa. Nếu chưa cài module nào bao giờ, bắt đầu ở đây.

Cần thêm

YOUTUBE_API_KEY — vào console.cloud.google.com → tạo project → bật YouTube Data API v3 → Credentials → tạo API key.

YT_CHANNEL — tên kênh dạng @tenkenh, hoặc Channel ID.

Hai ô OAuth phía dưới chỉ cần khi muốn đăng video từ Lark. Chỉ đồng bộ số liệu thì để trống.

YOUTUBE_API_KEY bí mật

YT_CHANNEL

YT_OAUTH_CLIENT_ID tuỳ chọn

YT_OAUTH_CLIENT_SECRET bí mật

Khối lệnh — YouTube

Kiểm tra: có 3 bảng 16.1 / 16.2 / 16.3 · bảng 16.2 có video thật của bạn · bảng đăng video là 16.3.

Chưa muốn đăng video thì thêm câu này vào cuối prompt: “lần này tôi chỉ cần đồng bộ, chưa cần đăng video”.

kéo Page + đăng bàitoken hết hạn ~60 ngày

Kéo danh sách Fanpage về Lark, rồi đăng bài / Reel từ Lark lên Facebook.

Cần thêm

FB_USER_TOKEN — token dài hạn ~60 ngày (bắt đầu bằng EAA…), lấy qua Meta for Developers. Nhớ đổi sang bản dài hạn ở Access Token Debugger → Extend Access Token; token mặc định chỉ sống 1–2 giờ.

Danh sách Fanpage muốn dùng — hoặc để nguyên “tất cả page tôi quản lý”.

FB_USER_TOKEN bí mật

Fanpage muốn dùng Để trống là lấy hết Page bạn đang quản trị.

Khối lệnh — Facebook

Kiểm tra: 5 bảng 14.1→14.5 · bảng 14.1 có Fanpage · bảng đăng bài là 14.3 · bài lên có đủ ảnh.

kéo video + đăngcó bước bắt buộc làm trước

Kéo video và profile về Lark, đăng video từ Lark lên TikTok, đồng bộ theo lịch mỗi sáng.

Bắt buộc làm trước: thêm tài khoản TikTok của bạn vào mục Target users của app trên developers.tiktok.com. Thiếu bước này là đăng nhập luôn thất bại — và lỗi báo ra không nói gì về nguyên nhân.

Cần thêm

TIKTOK_CLIENT_KEY (dạng aw…) và TIKTOK_CLIENT_SECRET — lấy ở developers.tiktok.com.

TIKTOK_CLIENT_KEY

TIKTOK_CLIENT_SECRET bí mật

Tài khoản TikTok muốn dùng Chính là tài khoản đã thêm vào Target users.

Khối lệnh — TikTok

Kiểm tra: bảng 15.1 có video · bảng 15.3 có profile · bảng đăng là 15.2 — số giữa, khác YouTube là số cuối.

Câu “nhớ PKCE dùng SHA-256 HEX” trong prompt đừng xóa — TikTok làm khác chuẩn đúng ở chỗ này.

chưa cài đượcchỉ đọc và báo cáo

Mới có kho mã nguồn mentor_club_threads, chưa có hướng dẫn cài. Muốn tìm hiểu trước thì dùng khối lệnh an toàn dưới đây — nó chỉ đọc và báo cáo, không cài gì cả.

Khối lệnh — Threads (chỉ khảo sát)

Đọc xong báo cáo, thấy ổn thì mới bắt đầu cài.

khó nhấtliên quan tiền thật

Khách đặt hàng → quét QR chuyển khoản → hệ thống tự lên đơn, ghi sổ, gửi email. Có bộ đối soát chạy nền mỗi 2 phút nên khách tắt trình duyệt đơn vẫn xử lý xong.

Đây là module khó nhất và liên quan tiền thật. Chỉ làm khi đã cài xong ít nhất 2 module khác, và nên có người kèm.

Tài khoản cần có

Cloudflare + tên miền · SePay (đã liên kết ngân hàng thật của chủ shop) · Pancake POS · Lark Base · Resend.

Khối lệnh này dùng giá trị mô tả (tên thương hiệu, sản phẩm, ngân hàng…) nên phải điền tay trong lúc chat, không có ô điền sẵn. Ba ô Lark ở mục 01 vẫn tự thay.

Khối lệnh — Web bán hàng

Kiểm thử bắt buộc:

Tự chuyển khoản thật một khoản nhỏ.
Tắt trình duyệt ngay sau khi chuyển, chờ 2 phút xem hệ thống có tự xử lý không.
Kiểm email cả trong thư mục spam.
Đổi giá test thành giá thật ở cả web lẫn Pancake trước khi chia sẻ link.

chạy trên máy bạnmáy tắt là ngừng

Nói hoặc gõ vào một nhóm Lark, trợ lý AI trả lời bằng giọng và làm việc trên máy bạn. Chạy trên máy tính của bạn — máy phải bật thì mới hoạt động.

Chuẩn bị

Tạo nhóm Lark riêng và thêm Bot vào.
Bật event im.message.receive_v1 + 3 quyền im:message, im:message:send_as_bot, im:resource rồi publish lại.
Biết máy có card NVIDIA hay không.
Cài sẵn Node 18+, ffmpeg, lark-cli, Python.

Khối lệnh — Trợ lý giọng nói

Kiểm tra: hai lệnh node check-itto.mjs và node scripts/check-setup.mjs đều XANH · bạn tự bấm scripts/start.ps1 để khởi động — đây là AI chạy ngầm toàn quyền trên máy, người bật phải là người chịu trách nhiệm.

Lỗi thường gặp

Hiện tượng	Nguyên nhân	Cách xử lý
Bấm nút mà không có gì xảy ra; gọi HTTP trả `204` như thành công	chưa bật Actions	Vào tab Actions của repo vừa nhân bản → bấm nút xanh bật workflow.
Đọc được nhưng không ghi được vào Base; báo `Forbidden`	app chưa vào Base	Mở Base → nút `•••` → thêm app, quyền Can edit.
Đã cấp quyền mà vẫn không có tác dụng, không báo lỗi gì	chưa Publish app	Lark Console → Create version → Submit for release.
Bài đăng lên mất ảnh, dòng vẫn ghi bình thường	Base nằm trong Wiki	Giữ nguyên câu xử lý `/wiki/` trong prompt, đừng xóa.
`TableIdNotFound` · `1254005`	sai Base ID / mã bảng	Kiểm lại `LARK_BASE_ID` trong Variables.
`1254060 TextFieldConvFail`	ghi số vào ô Text	Mọi giá trị ghi vào ô kiểu Text phải `String()` trước.
`OAuthException` / lỗi token Facebook	token hết hạn ~60 ngày	Lấy token mới, cập nhật Secret `FB_USER_TOKEN`.
TikTok: đăng nhập luôn thất bại	thiếu Target users	Thêm tài khoản TikTok vào Target users của app.
Web bán hàng: lỗi `1042`	gọi sai kiểu	Dùng Service Binding `env.SALE_WORKER.fetch(...)`, không fetch URL `*.workers.dev`.
Trợ lý giọng nói: báo “Nghe không rõ” với mọi câu	thiếu cuBLAS/cuDNN	Chạy lại `scripts/install.ps1` để cài đủ.

Không có dòng nào khớp thì dán vào Claude Code theo mẫu này:

“Tôi đang cài module X, đã làm đến bước Y. Tôi mong đợi A nhưng thực tế là B. Lỗi hiện ra: [dán nguyên văn]. Giúp tôi tìm nguyên nhân.”