Giới thiệu về đăng ký Form Lark trong n8n
Việc tích hợp Lark Forms với n8n mở ra nhiều khả năng tự động hóa quy trình làm việc của bạn. Khi một form mới được submit hoặc một approval được tạo, n8n có thể tự động nhận thông báo và xử lý dữ liệu theo workflow bạn đã thiết lập. Tuy nhiên, để thiết lập kết nối này, bạn cần thực hiện đúng quy trình đăng ký (subscribe) form với Lark API.
Trong bài viết này, tôi sẽ hướng dẫn bạn chi tiết 3 bước cơ bản để đăng ký một Form Lark mới. Sau khi hoàn thành, bạn sẽ có thể tái sử dụng quy trình này cho bất kỳ form nào trong tương lai mà không cần phải mò mẫm lại từ đầu.
1. Lấy Approval Code (Mã định danh Form)
Approval Code chính là ID duy nhất của mỗi mẫu đơn trong hệ thống Lark. Đây là thông tin quan trọng nhất để Lark biết được n8n đang muốn “lắng nghe” sự kiện từ form nào. Mỗi form sẽ có một mã riêng biệt, và bạn cần lấy đúng mã này để đảm bảo webhook hoạt động chính xác.
Cách lấy Approval Code
Step 1: Đăng nhập vào Lark và truy cập vào phần quản lý Approval hoặc Forms của bạn.
Step 2: Mở form mà bạn muốn tích hợp với n8n. Bạn có thể mở form ở chế độ thiết kế (Design) hoặc ở phần quản lý phê duyệt (Approval Management).
Step 3: Nhìn lên thanh địa chỉ URL của trình duyệt. Mã Approval Code thường nằm ngay trong URL, có thể xuất hiện sau tham số definitionCode= hoặc nằm giữa các dấu gạch chéo.
Specific example
Giả sử URL của form bạn đang mở là:
https://example.larksuite.com/approval/definitionCode=8C49EDF7-8116-448C-8131-83D2071B632E
Thì Approval Code của bạn chính là: 8C49EDF7-8116-448C-8131-83D2071B632E
Hãy copy mã này và lưu lại vào một nơi an toàn, bạn sẽ cần dùng nó ở bước 3.
2. Lấy Tenant Access Token (Chìa khóa xác thực)
Tenant Access Token là một chuỗi mã xác thực giúp Lark API xác nhận rằng ứng dụng của bạn (trong trường hợp này là app Approval-N8N) có quyền thực hiện các thao tác với form. Đây chính là thông tin mà nhiều người thường bỏ qua hoặc không biết cách lấy khi thiết lập lần đầu.
Tại sao cần Tenant Access Token?
Lark sử dụng cơ chế OAuth 2.0 để bảo mật API. Mỗi request gửi đến Lark API đều cần có một token hợp lệ trong header để xác thực. Nếu thiếu token hoặc token không hợp lệ, API sẽ trả về lỗi 401 Unauthorized.
Cách lấy Tenant Access Token nhanh nhất
Phương pháp 1: Sử dụng Lark API Explorer (Khuyến nghị cho người mới)
- Access Lark API Explorer (thường có địa chỉ tại
https://open.larksuite.com/api-explorer). - Ở góc trên bên trái, chọn đúng App mà bạn đã tạo (ví dụ: Approval-N8N).
- Lark sẽ tự động hiển thị một đoạn mã token bắt đầu bằng
t-ở khung bên cạnh. Đây chính là Tenant Access Token của bạn. - Copy toàn bộ chuỗi token này (bao gồm cả phần
t-).
Phương pháp 2: Gọi API để lấy Token (Cho người có kinh nghiệm)
Bạn cũng có thể gọi trực tiếp endpoint /auth/v3/tenant_access_token/internal với App ID và App Secret để lấy token. Tuy nhiên, phương pháp này phức tạp hơn và yêu cầu bạn phải quản lý App credentials.
Lưu ý quan trọng về thời hạn Token
Token này chỉ có hiệu lực trong 2 giờ. Sau 2 giờ, token sẽ hết hạn và bạn cần lấy token mới. Đây là lý do tại sao trong phần “Mẹo nhỏ” ở cuối bài, tôi sẽ hướng dẫn bạn cách tự động hóa việc lấy token này để không phải làm thủ công mỗi lần.
Nếu bạn đang thiết lập lần đầu và chỉ muốn test, thì việc lấy token thủ công từ API Explorer là đủ. Nhưng nếu bạn cần đăng ký nhiều form hoặc muốn hệ thống chạy lâu dài, hãy tham khảo phần tự động hóa ở cuối bài.
3. Cấu hình Node HTTP Request trong n8n
Sau khi đã có đủ 2 thông tin quan trọng (Approval Code và Tenant Access Token), bạn sẽ sử dụng chúng để cấu hình một HTTP Request node trong n8n. Node này sẽ gửi lệnh subscribe đến Lark API, yêu cầu Lark gửi webhook về n8n mỗi khi có sự kiện xảy ra với form.
Các bước cấu hình chi tiết
Bước 1: Tạo một HTTP Request node mới trong n8n
Trong workflow của bạn, thêm một node mới và chọn loại HTTP Request.
Bước 2: Thiết lập Method
Chọn method là POST. Đây là method chuẩn để gửi lệnh subscribe đến Lark API.
Bước 3: Thiết lập URL
URL sẽ có dạng như sau:
https://open.larksuite.com/open-apis/approval/v4/approvals/{{Approval_Code}}/subscribe
Trong đó, bạn cần thay {{Approval_Code}} bằng mã Approval Code mà bạn đã lấy ở bước 1.
Example: Nếu Approval Code của bạn là 8C49EDF7-8116-448C-8131-83D2071B632E, thì URL đầy đủ sẽ là:
https://open.larksuite.com/open-apis/approval/v4/approvals/8C49EDF7-8116-448C-8131-83D2071B632E/subscribe
Bước 4: Thiết lập Headers
Phần Headers rất quan trọng vì nó chứa thông tin xác thực. Bạn cần thêm một header mới với các thông tin sau:
- Name:
Authorization - Value:
Bearer [Tenant_Access_Token]
Lưu ý cực kỳ quan trọng: Phải có chữ Bearer (viết hoa chữ B) và một dấu cách trước đoạn mã token. Nhiều người mắc lỗi quên dấu cách hoặc viết sai chữ Bearer, dẫn đến API trả về lỗi xác thực.
Example: Nếu token của bạn là t-g1044ghHGHJKL..., thì giá trị trong header sẽ là:
Bearer t-g1044ghHGHJKL...
Bước 5: Kiểm tra và Execute
Sau khi cấu hình xong, hãy nhấn Execute để test. Nếu mọi thứ đúng, bạn sẽ nhận được response thành công từ Lark API, xác nhận rằng form đã được subscribe thành công.
💡 Mẹo nhỏ: Tự động hóa việc lấy Token cho lần sau
Như đã đề cập, Tenant Access Token chỉ có hiệu lực trong 2 giờ. Nếu bạn cần đăng ký nhiều form hoặc muốn hệ thống tự động renew token, bạn nên tạo một workflow riêng để tự động hóa quá trình này.
Workflow tự động gồm 2 node
Node 1: Lấy Tenant Access Token tự động
Tạo một HTTP Request node với cấu hình sau:
- Method: POST
- URL:
https://open.larksuite.com/open-apis/auth/v3/tenant_access_token/internal - Body (JSON):
{
"app_id": "YOUR_APP_ID",
"app_secret": "YOUR_APP_SECRET"
}Node này sẽ trả về một token mới mỗi khi được execute. Bạn có thể lưu token này vào một biến để sử dụng cho node tiếp theo.
Node 2: Sử dụng Token để Subscribe Form
Sử dụng token từ Node 1 để gửi lệnh subscribe như đã hướng dẫn ở bước 3. Bạn có thể dùng expression {{$node["Node1"].json["tenant_access_token"]}} để lấy token từ output của Node 1.
Lợi ích của việc tự động hóa
Với workflow này, mỗi lần bạn cần đăng ký một form mới, bạn chỉ cần:
- Lấy Approval Code từ URL (30 giây)
- Paste Approval Code vào Node 2 (10 giây)
- Execute workflow (5 giây)
Không cần phải vào API Explorer để lấy token thủ công nữa!
Conclusion
Việc đăng ký Form Lark trong n8n không hề phức tạp nếu bạn nắm rõ 3 bước cơ bản: Lấy Approval Code, lấy Tenant Access Token, và cấu hình HTTP Request node. Sau khi thiết lập xong, bạn có thể tận dụng sức mạnh của n8n để tự động hóa mọi quy trình liên quan đến form của mình.
Nếu bạn gặp khó khăn trong quá trình thiết lập hoặc muốn tôi gửi template workflow tự động lấy token, hãy để lại comment bên dưới nhé!
