Triển khai · Thu lead tự động

Leadpage Ebook Lark Base,
dựng xong trong một lệnh

Đưa ảnh bìa ebook và vài câu nỗi đau. Máy dựng trang thu lead, nối thẳng về bảng Lark của bạn, gắn tên miền riêng, và ghi lại khách đến từ quảng cáo nào.

Bạn tự tay đúng 2 việc — tạo app Lark và thêm nó vào Base. Còn lại: điền các ô bên dưới, xem thử trang ngay tại chỗ, dán một khối lệnh.

  1. Tạo app Larktay · 5 phút · một lần duy nhất
  2. Điền nội dungxem thử ngay tại chỗ
  3. Chọn bảng & map cộtxổ thẳng từ Base của bạn
  4. Dán khối lệnhmáy dựng + đẩy lên tên miền
01

Hiểu đúng một điều này thì mọi bước sau đều dễ

Đây là chỗ hỏng im lặng nhiều nhất

Leadpage là trang tĩnh. Nó không tự ghi vào Lark được — phải có một người đưa thư chạy ở giữa.

Muốn ghi vào Base, ai đó phải cầm chìa khoá Lark mà gọi. Có đúng hai chỗ đặt người đưa thư đó, và chọn sai chỗ là hỏng:

Đặt trong trình duyệtSAI
Vì saoChìa khoá Lark nằm trong mã trang. Ai bấm F12 cũng đọc được, rồi ghi/xoá cả Base của bạn.
Và kể cả muốnTrình duyệt cũng bị chặn — Lark không cho gọi từ trang web khác.
Đặt trên máy chủĐÚNG
Cách làmMột hàm nhỏ /api/lead nằm cùng tên miền với leadpage. Chìa khoá cất trên máy chủ, khách không bao giờ thấy.
Được thêmCùng tên miền nên không dính CORS, và máy chủ kiểm lại dữ liệu chứ không tin trình duyệt.

Khối lệnh ở mục 08 dựng sẵn thứ này cho bạn — không phải viết dòng mã nào. Chỉ cần hiểu vì sao nó phải có, để sau không ai xui bạn "gọi thẳng Lark cho nhanh".

Đã đo thật 03/08/2026: gọi tới open.larksuite.com từ trình duyệt thì Lark không trả về header cho phép ⇒ bị chặn. Cách duy nhất chạy được là qua máy chủ.
02

Việc tay thứ nhất — tạo app Lark và thêm vào Base

Khoảng 5 phút, làm một lần duy nhất. Mọi ebook sau dùng chung app này.

  1. open.larksuite.com/appCreate custom app

    Vào Credentials & Basic Info lấy App ID + App Secret.

  2. Tab Permissions → thêm bitable:app

    Dùng link Lark Wiki thì thêm cả wiki:wiki:readonly.

  3. Tab Version ManagementCreate version

    Quyền chưa có hiệu lực cho tới khi phát hành phiên bản.

  4. Mở Base → Add app → cấp quyền Sửa

    Bước hay quên nhất. Có quyền chung rồi vẫn phải mời app vào từng Base một.

App Secret đọc–ghi được mọi Base mà app được mời vào. Đừng gửi qua chat nhóm. Lỡ lộ thì bấm Reset trong Developer Console.
03

Nội dung ebook — điền tới đâu, trang hiện ra tới đó

Chọn ảnh để xem thử — ảnh không rời khỏi máy bạn. Ô dưới là đường dẫn đầy đủ để máy lấy ảnh lúc dựng thật; ảnh giữ nguyên 100%.
Không dấu, không khoảng trắng.
Dành cho [ai] muốn [kết quả], chưa biết [rào cản], ngại [rào cản] nhưng vẫn muốn [mong ước].
3–5 dòng, mỗi dòng gắn một hậu quả cụ thể.
Hiện ở chân trang. Bỏ trống là máy dừng, không dựng.
Ba ô liên hệ: bỏ trống thì ẩn hẳn.
Có link thì popup cảm ơn hiện luôn nút TẢI EBOOK. Bỏ trống thì bạn phải gửi tay.
04

Xem thử trang ngay tại chỗ

Trang thật sẽ được dựng. Điền ở mục 03 là đổi theo ngay.

Bố cụcbìa + nút đè ảnh → headline → nỗi đau → ribbon → đồng hồ → form → chân trang
Khung trangtối đa 420px — thuần điện thoại
Đồng hồ hết giờ tự đặt lại 12 tiếng mới — khan hiếm giả. Muốn bỏ thì ghi thêm một câu vào khối lệnh.
Thông báo "Chị A vừa đăng ký" là tên bịa. Khối lệnh mặc định tắt nó đi.
05

Nối vào bảng Lark — chọn bảng, map cột

Dán App ID, App Secret và link Base rồi bấm một nút — trang xổ thẳng danh sách bảng thật, rồi liệt kê cột để ghép.

Đọc trước khi dán App Secret

App Secret dán ở đây đi qua máy chủ của trang này để hỏi Lark hộ bạn.

Chỉ dùng để đọc tên bảng và tên cột — không tạo, không sửa, không xoá. Không ghi log, không lưu, dùng xong là mất.

Không muốn dán? Bỏ trống hai ô bí mật, chỉ điền link Base. Khối lệnh tự đổi sang cách khác: Claude Code hỏi bạn ngay trên máy bạn, chìa khoá không rời máy.

Developer Console → Credentials & Basic Info.
Ngay dưới App ID, cùng một trang.
Mở Base trên trình duyệt rồi copy nguyên thanh địa chỉ. Link Wiki (/wiki/…) cũng nhận.
06

Nguồn khách — biết lead này đến từ quảng cáo nào

Không có phần này thì bảng chỉ có tên và số điện thoại — không biết nên tăng tiền cho quảng cáo nào.

Bắt tự độngutm_source · utm_medium · utm_campaign · utm_content · utm_term
Bắt thêmfbclid / ttclid / gclid · trang giới thiệu · trang đích · thời gian
Giữ nguồnlưu ngay lượt đầu — khách bấm lòng vòng vẫn không mất
Link quảng cáo gắn như thế này:
https://tenmien.com/?utm_source=facebook&utm_medium=cpc&utm_campaign=ebook-thang-8&utm_content=video-a
Đổi utm_content theo từng mẫu quảng cáo là biết mẫu nào ra lead.
07

Tên miền — nơi trang sẽ chạy

Trang chạy trên Cloudflare Pages, tên miền đặt ở Cloudflare.

Máy dựng trên .pages.dev trước, rồi gắn tên miền này.
Bỏ trống thì máy đặt theo slug.
Cần API Token mẫu Edit zone DNS đặt vào biến CLOUDFLARE_API_TOKEN — token đăng nhập wrangler chỉ đọc được vùng, không tạo được bản ghi. Không có thì máy dừng và chỉ bạn tạo tay.
Gắn tên miền trong Pages là chưa đủ. Nếu vùng DNS có bản ghi ký tự đại diện * thì tên miền con mới bị nuốt — phải tạo bản ghi đích danh. Đã dính thật trên hoangminhhoa.com.
08

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

Mở Claude Code ở thư mục bạn muốn chứa dự án, dán khối này vào. Chỗ nào còn vàng là bạn chưa điền.

Khối lệnh triển khai

    
Nghiệm thu thật, đừng tin lời máy báo xong. Khối lệnh bắt máy phải tự điền một lead thử, rồi mở bảng Lark đọc lại đúng dòng vừa ghi và in ra cho bạn xem. Chưa thấy dòng đó trong bảng thì coi như chưa chạy.
09

Bẫy thường gặp — soi ở đây trước khi hỏi

Hiện tượngNguyên nhân thậtCách sửa
Bấm “Xổ danh sách bảng” báo App chưa được thêm vào Base App có quyền chung rồi nhưng chưa được mời vào Base cụ thể Mở Base → Add app → chọn app → cấp quyền Sửa
Báo sai App ID / App Secret dù chép đúng Cấp quyền xong chưa phát hành phiên bản Version Management → Create version → chờ duyệt
Form gửi xong hiện “Cảm ơn” nhưng bảng không có dòng nào Skill gốc có lỗi: máy chủ trả lỗi 400/500 mà trang vẫn coi là thành công Khối lệnh đã bắt sửa. Kiểm bằng cách tự điền 1 lead rồi mở bảng xem
Trang mở ra không thấy gì / lỗi tên miền Bản ghi CNAME ký tự đại diện nuốt tên miền con Tạo bản ghi DNS đích danh cho tên miền con đó
Lead vào bảng nhưng cột nguồn trống trơn Link quảng cáo không gắn UTM Gắn ?utm_source=…&utm_campaign=… vào link chạy quảng cáo
/api/lead trả 405 Deploy sai thư mục nên Cloudflare bỏ qua thư mục functions/ Phải cd site rồi wrangler pages deploy . — không deploy từ thư mục cha
Ảnh bìa hiện mờ / vỡ trên điện thoại Ảnh mockup gốc nhỏ hơn bề ngang trang Dùng ảnh rộng tối thiểu 840px. Máy không phóng to ảnh hộ vì sẽ vỡ