Quy Trình Xác Thực (Authorize) Với Lark Suite: "Chìa Khóa" Để Mở Cánh Cửa Tự Động Hóa

Quy Trình Xác Thực (Authorize) Với Lark Suite: "Chìa Khóa" Để Mở Cánh Cửa Tự Động Hóa

Quy Trình Xác Thực (Authorize) Với Lark Suite: "Chìa Khóa" Để Mở Cánh Cửa Tự Động Hóa

Để kết nối LarkBase với n8n và khai thác tối đa sức mạnh của API, bạn cần thực hiện quy trình xác thực để cấp quyền cho ứng dụng của bạn. Quy trình này sẽ giúp bạn có được access_token - "chìa khóa" để gọi các API của Lark Suite.

Bước 1: Thiết Lập Ứng Dụng Trên Lark Developer Platform - "Sân Chơi" Của Các Nhà Phát Triển

1. Đăng nhập:

   • Truy cập Lark Developer Platform.
   • Đăng nhập bằng tài khoản Lark Suite của bạn.

2. Tạo ứng dụng mới:

   • Chọn "Create Custom App" (Tạo Ứng Dụng Tùy Chỉnh).
   • Điền thông tin cơ bản:
     • Tên ứng dụng (ví dụ: "n8n Integration - HebumTeam").
     • Mô tả ứng dụng (ví dụ: "Kết nối n8n với LarkBase để tự động hóa quy trình làm việc").
     • Logo ứng dụng (tải lên logo của HebumTeam hoặc một biểu tượng phù hợp).

3. Cấu hình quyền truy cập:

   • Trong menu bên trái, chọn "Permission" (Quyền).
   • Tìm và thêm các quyền liên quan đến Base:
     • base:record:read – Quyền đọc dữ liệu từ LarkBase.
     • base:record:write – Quyền ghi dữ liệu vào LarkBase.
     • base:table:read – Quyền đọc cấu trúc bảng trong LarkBase.

4. Thiết lập Redirect URL (URL Chuyển Hướng):

   • Trong menu bên trái, chọn "Security & Certification" (Bảo Mật & Chứng Nhận).
   • Tại mục "Redirect URLs" (URL Chuyển Hướng), thêm URL của webhook n8n.
     • Lưu ý: URL webhook có định dạng: http://your-n8n-url/webhook/lark-authorize (bạn có thể tìm thấy URL này trong node Webhook của template n8n).
     • Ví dụ: Nếu bạn đang sử dụng localhost, URL sẽ là http://localhost:5678/webhook/lark-authorize.

5. Lấy App ID và App Secret (Mật Khẩu Ứng Dụng):

   • Trong menu bên trái, chọn "Credentials" (Thông Tin Xác Thực).
   • Sao chép "App ID" (ID Ứng Dụng) và "App Secret" (Mã Bí Mật Ứng Dụng). Bạn sẽ cần chúng cho bước tiếp theo.

Bước 2: Thiết Lập Webhook Authorize Trong n8n - "Trạm Trung Chuyển" Dữ Liệu

1. Import template workflow authorize (Nhập Mẫu Workflow):

   • Mở n8n và import template workflow đã được HebumTeam cung cấp.
   • Hoặc: Tạo một workflow mới và đặt tên là "Lark Base Authorize".

2. Thiết lập node Webhook:

   • Thêm node "Webhook" vào workflow.
   • Cấu hình node Webhook:
     • Method: GET (Phương Thức).
     • Path: /lark-authorize (Đường Dẫn).
     • Authentication: None (Xác Thực).
     • Respond: Immediately (Phản Hồi Ngay Lập Tức).

3. Tạo URL Authorization (URL Cấp Quyền):

   • URL này được sử dụng để truy cập vào Lark Suite và cấp quyền cho ứng dụng của bạn. Sau khi bạn cấp quyền thành công, Lark Suite sẽ chuyển hướng đến URL webhook để tạo access_token.

   • Tạo link thủ công:

     • Sử dụng mẫu URL sau:

       https://open.larksuite.com/open-apis/authen/v1/index?app_id=YOUR_APP_ID&redirect_uri=YOUR_WEBHOOK_URL
       

     • Thay YOUR_APP_ID bằng App ID bạn đã sao chép ở bước trước.
     • Thay YOUR_WEBHOOK_URL bằng URL webhook bạn đã lưu ở bước trước.
     • Lưu ý quan trọng: Đảm bảo URL webhook đã được mã hóa (URL encode) nếu có ký tự đặc biệt. Bạn có thể sử dụng các công cụ trực tuyến để mã hóa URL.

   • Trong template của HebumTeam, bạn sẽ tìm thấy cơ chế gia hạn token tự động. Điều này có nghĩa là bạn không cần phải lo lắng về việc token hết hạn.

Sau khi hoàn tất quy trình xác thực, bạn đã sẵn sàng chuyển sang bước 2 để gọi API và bắt đầu tự động hóa quy trình làm việc của mình!

Sử Dụng Template n8n Lark Suite Để Gọi API: "Sức Mạnh" Trong Tay Bạn

Template n8n Lark Suite của HebumTeam đã được trang bị sẵn một số node hữu ích, bao gồm:

• Thêm record (Insert Record).
• Tìm kiếm record (Find Record).
• Cập nhật record (Update Record).

Bạn chỉ cần kết nối các node này với access_token và chuẩn bị dữ liệu cho API là có thể bắt đầu sử dụng.

Dưới đây là mô tả chi tiết về các API, bao gồm liên kết và đầu vào của chúng, để bạn tham khảo:

Thao Tác Với Lark Base (Bitable): "Làm Chủ" Dữ Liệu Của Bạn

1. Tạo record mới (Insert Record):

   • Thêm node "HTTP Request" với cấu hình sau:
     • Method: POST
     • URL: https://open.larksuite.com/open-apis/bitable/v1/apps/{BASE_ID}/tables/{TABLE_ID}/records
     • Headers:
       • Authorization: Bearer {TOKEN}
       • Content-Type: application/json
     • Body:

       JSON

        

       1{ 2 "fields": { 3 "Tên": "Nguyễn Văn A", 4 "SĐT": "0912345678", 5 "Email": "example@gmail.com" 6 } 7}

       • Trong đó:
         • {BASE_ID}: ID của Lark Base (lấy từ URL).
         • {TABLE_ID}: ID của bảng cần thêm dữ liệu.
         • {TOKEN}: Token từ file đã lưu (template của HebumTeam đã xử lý phần này).

2. Tìm kiếm record (Find Record):

   • Thêm node "HTTP Request" với cấu hình sau:
     • Method: GET
     • URL: https://open.larksuite.com/open-apis/bitable/v1/apps/{BASE_ID}/tables/{TABLE_ID}/records?filter=SĐT="0912345678"
     • Headers:
       • Authorization: Bearer {TOKEN}

3. Cập nhật record (Update Record):

   • Thêm node "HTTP Request" với cấu hình sau:
     • Method: PUT
     • URL: https://open.larksuite.com/open-apis/bitable/v1/apps/{BASE_ID}/tables/{TABLE_ID}/records/{RECORD_ID}
     • Headers:
       • Authorization: Bearer {TOKEN}
       • Content-Type: application/json
     • Body:

       JSON

        

       1{ 2 "fields": { 3 "Tên": "Nguyễn Văn A (Đã cập nhật)", 4 "Email": "new_email@gmail.com" 5 } 6}

Lưu Ý Quan Trọng Khi Sử Dụng: "Bí Quyết" Để Thành Công

• Cách lấy các ID cần thiết:

  • Lấy BASE_ID:
    • Mở Lark Base của bạn.
    • ID nằm trong URL: https://appxxxxxxxx.feishu.cn/base/bascnxxxxxxxxxx
    • bascnxxxxxxxxxx là BASE_ID.
  • Lấy TABLE_ID:
    • Mở bảng cần thao tác.
    • ID nằm trong URL sau tbl:
    • Ví dụ: .../tblxxxxxx/... → TABLE_ID là tblxxxxxx.

• Kiểm tra token và sự cố:

  • Token không hoạt động: Truy cập lại URL webhook authorize.
  • Lỗi quyền truy cập: Kiểm tra quyền trong Lark Developer Platform.
  • Lỗi định dạng dữ liệu: In ra JSON dữ liệu để kiểm tra.

Tổng Kết: "Tự Động Hóa" Trong Tầm Tay

Với hướng dẫn chi tiết này, bạn đã có thể:

• Thiết lập ứng dụng Lark và quy trình authorize.
• Tạo URL authorize và webhook để xử lý callback.
• Lưu và tự động làm mới token.
• Thao tác CRUD (Create, Read, Update, Delete) với dữ liệu trong Lark Base.
• Xử lý dữ liệu động từ nhiều nguồn khác nhau.

Hãy nhớ rằng template của HebumTeam đã xử lý phần phức tạp nhất là xác thực và làm mới token. Bạn chỉ cần:

• Cập nhật App ID và App Secret.
• Truy cập URL webhook authorize để bắt đầu.
• Tập trung vào việc thao tác dữ liệu và xây dựng các quy trình tự động hóa sáng tạo!

HebumTeam chúc bạn thành công trên hành trình chinh phục tự động hóa!