Tích hợp Lark Base

Tích hợp Lark Base

Tài liệu cần đọc:

Thiết lập Webhook thủ công của Casso: https://developer.casso.vn/webhook/thiet-lap-webhook-thu-cong
Hướng dẫn sử dụng Lark Anycross: https://anycross-sg.larksuite.com/documentation/index

Sau khi tích hợp thành công, Casso sẽ tự động thêm 1 dòng mới vào bảng trong Base mỗi khi có giao dịch mới trong tài khoản ngân hàng mà người dùng đã định sẵn.

CÁC BƯỚC THỰC HIỆN

Bước 1: Tạo Base chứa dữ liệu chuyển khoản

Ở Lark Docs, chọn + New --> New Base

Thiết lập các trường thông tin của Bảng

Các thông tin (data) mà Casso cung cấp:"id": 6785, //mã định danh duy nhất của giao dịch (Casso quy định)"tid": "BANK_REF_ID", //Mã giao dịch từ phía ngân hàng"description": "giao dich thu nghiem", // nội dung giao dịch"amount": 79000, // số tiền giao dịch"cusum_balance": 20079000, // số tiền còn lại sau giao dịch"when": "2020-10-14 00:34:57", // thời gian ghi có giao dịch ở ngân hàng"bank_sub_acc_id": "123456789", // Mã tài khoản ngân hàng mà giao dịch thuộc về"subAccId" : "123456789" // tương tự field bank_sub_acc_id, nhằm tương thích với code cũ."virtualAccount": "", // tài khoản ảo"virtualAccountName": "", // tên tài khoản ảo"corresponsiveName": "", // tên tài khoản đối ứng"corresponsiveAccount": "", // tài khoản đối ứng"corresponsiveBankId": "", // mã ngân hàng đối ứng"corresponsiveBankName": "" // tên ngân hàng đối ứng

Lưu ý:

id, amount, cusum_balance: để kiểu dữ liệu là số (number)
Các trường còn lại để kiểu dữ liệu là text (multiline)

Bước 2: Tạo workflow trong Anycross

Truy cập Anycross tại: https://anycross-sg.larksuite.com/console/admin
Chọn Intergration --> + New Project

Điền tên và mô tả --> Chọn Create

Chọn + --> Create workflow

Điền tên, mô tả, và chọn Trigger là Webhook --> Chọn Create

Bước 3: Cài đặt Webhook Trigger

Ở tab Setting, copy Callback URL để dùng cho Bước 4

Bước 4: Thêm kết nối ở Casso

Mở Casso và chọn + Thêm tích hợp

Chọn Webhook

Chọn Webhook

Chọn Tích hợp

Chọn ngân hàng --> chọn Tiếp tục

Dán Callback URL ở bước 3 vào Webhook URL và chọn Tiếp tục

Sang bước Cấu hình dữ liệu --> chọn Tiếp tục

Đến bước gọi thử (Tạm dừng ở đây, chúng ta sang bước 5 tiếp tục set-up trên Anycross)

Bước 5: Tiếp tục thiết lập workflow trên Anycross

Quay lại tab Anycross
Thêm 1 node là Synchronous Callback

Ở tab Action chọn Trigger Callback

Ở tab Input, điền 200 vào ô Return Status

Tại sao điền giá trị ô Return Status là 200?Casso yêu cầu phản hồi khi thành công:

"Phản hồi khi thành công

Sau khi xử lý, webhook của bạn phải phản hồi với status code là 200 OK. Và đáp ứng thời gian phản hồi dưới 5 giây ( Casso sẽ thiết lập timeout cho request post bắn webhook là 5s)"

Chọn Done --> Publish

Bước 6: Gọi thử và test workflow

Quay lại tab Casso
Chọn Gọi thử

Sau khi gọi thành công --> chon Lưu

Giữ nguyên tab Casso này để gọi thử khi log data vào Base

Bước 7: Đẩy data vào Lark Base

Mở tab Anycross
Chọn Edit để chỉnh sửa

Thêm 1 node là Lark Base

Ở tab Action, chọn Add Record

Ở tab Auth chọn app Base API

Đây là 1 custom app được cấp quyền edit BaseTìm hiểu về custom app tại https://open.larksuite.com/document/uQjL04CN/ukzM04SOzQjL5MDN

Ở tab input chọn Base và Table
- tên Base là file đã tạo ở bước 1
- Table là 1 bảng trong Base

Thiết lập data từ Casso theo từng trường dữ liệu
- Đổi kiểu dữ liệu sang expression

Tìm Jsonpath phù hợp
- Gõ dấu $ và tìm tên dữ liệu phù hợp với tên cột trong Base

Ví dụ: Đây là Mã giao dịch từ phía ngân hàng (bạn có thể đặt tên khác) và Casso quy định tên của dữ liệu này là "tid" --> cần tìm tid để điền vào ô này