I. Giới thiệu
Quy trình làm việc tự động trong Base có thể được kích hoạt khi nhận được một webhook. Cả hệ thống nội bộ và hệ thống ngoại vi có thể bắt đầu quy trình làm việc tự động bằng cách sử dụng yếu tố kích hoạt webhook. Yếu tố kích hoạt webhook tăng tính linh hoạt của quy trình làm việc tự động, cho phép bạn tích hợp dữ liệu Base với các hệ thống ngoại vi khác nhau.
Lưu ý: Chức năng này có độ phức tạp kỹ thuật và yêu cầu một số kiến thức lập trình và quen thuộc với các chức năng cơ bản.
Dòng thông tin như sau: Một hệ thống ngoại vi khởi tạo một thay đổi và gửi một Yêu cầu HTTP (phải là một yêu cầu POST) đến quy trình làm việc tự động Base. Quy trình làm việc tự động Base nhận thông tin và sau đó kích hoạt hành động tương ứng.
250px|700px|reset
Nếu bạn nghĩ về quá trình này như một cuộc gọi điện thoại, thì hệ thống ngoại vi là người gọi và Base là người nhận. Điều này có nghĩa là các bước phải được thực hiện theo trình tự sau:
- Lấy địa chỉ webhook: Địa chỉ webhook tương đương với số điện thoại của người nhận và được cung cấp bởi Base. Mỗi quy trình làm việc tự động được kích hoạt bởi một webhook sẽ tương ứng với một địa chỉ webhook duy nhất.
- Cấu hình URL yêu cầu và viết Yêu cầu HTTP (thông tin cần truyền).
- Thiết lập một quy trình làm việc tự động trong Base, đặt yếu tố kích hoạt là Khi nhận webhook, và chọn các hành động bạn muốn thực hiện.
Sử dụng phổ biến:
- Kết nối hệ thống bên ngoài với cơ sở: Ví dụ, bạn có thể cấu hình phần mềm quản lý dự án của mình để gửi Yêu cầu HTTP đến cơ sở và kích hoạt quy trình làm việc tự động để thông báo cho các thành viên liên quan thông qua Lark khi một bản ghi thay đổi.
- Kết nối cơ sở: Bạn có thể chạy quy trình làm việc tự động trên các cơ sở khác nhau. Ví dụ, khi có thay đổi được Thêm thành công vào cơ sở "Thông tin khách hàng", một Yêu cầu HTTP được gửi đến cơ sở "Thông tin đơn hàng" để tự động tạo một hồ sơ mới trong cơ sở "Thông tin đơn hàng".
- Đồng bộ dữ liệu: Các nguồn dữ liệu hiện tại tự động cập nhật mỗi giờ, nhưng yếu tố kích hoạt webhook có thể được sử dụng để tự động đồng bộ dữ liệu ngay lập tức bất cứ khi nào dữ liệu được Thêm thành công hoặc chỉnh sửa.
II. Các bước thao tác
Mở cơ sở và nhấp vào Automations (Tự động hóa) ở góc trên bên phải để tạo một quy trình làm việc tự động mới.
Lấy địa chỉ webhook
Chọn Khi webhook nhận được từ các yếu tố kích hoạt ở bên trái để xem địa chỉ webhook duy nhất cho quy trình làm việc.
Mỗi quy trình làm việc tự động được kích hoạt bởi một webhook có một địa chỉ webhook duy nhất. Địa chỉ này không thể được làm mới hoặc chỉnh sửa theo cách thủ công, và cần được điền vào để gửi yêu cầu HTTP. Chúng là cần thiết để bạn có thể truy cập được vào hệ thống mà bạn luôn liên kết, cũng như giúp cho các yêu cầu HTTP được gửi.
250px|700px|reset
250px|700px|reset
Cấu hình cài đặt bảo mật
Bạn có thể tăng cường bảo mật cuộc gọi theo nhu cầu bằng cách cấu hình hạn chế IP, mã thông báo mang, và các cài đặt khác.
Hạn chế IP: Khi được kích hoạt, chỉ những yêu cầu được gửi bởi các địa chỉ IP trên danh sách trắng sẽ kích hoạt quy trình làm việc tự động. Có thể Thêm thành công tối đa 10 địa chỉ IP. Nhấn Enter (Nhập) sau mỗi địa chỉ IP để thêm thành công một địa chỉ IP khác.
Mã thông báo mang: Điều này tương đương với việc áp dụng mật khẩu cho yếu tố kích hoạt webhook. Khi được kích hoạt, tất cả các yêu cầu phải mang theo mã thông báo này để kích hoạt quy trình làm việc tự động. Bạn có thể sao chép và đặt lại mã thông báo. Mã thông báo đặt lại sẽ có hiệu lực khi bạn nhấp vào Lưu và Kích hoạt cho quy trình làm việc tự động.
250px|700px|reset
Cấu hình cài đặt cấu trúc dữ liệu
Định nghĩa đầu ra webhook trong cài đặt cấu trúc dữ liệu để sử dụng trong các quy trình làm việc tự động tiếp theo. Có ba cài đặt cho cấu trúc dữ liệu: Gửi yêu cầu mẫu, Thiết lập thủ công, và Để trống.
250px|700px|reset
- Gửi yêu cầu mẫu: Gửi một yêu cầu mẫu đến địa chỉ webhook cho quy trình làm việc tự động và nhấp vào Tạo để cấu hình cài đặt.
- Yêu cầu sẽ được giám sát trong ba phút cuối cùng cho đến khi việc tải hoàn tất.
- Thời gian tải được giới hạn là năm giây. Nếu một yêu cầu chưa được nhận sau năm giây, việc tải sẽ dừng lại và yêu cầu sẽ cần được gửi lại. Nếu một yêu cầu được nhận sau năm giây, cấu trúc hoàn chỉnh của yêu cầu sẽ được hiển thị và không thể chỉnh sửa. Nếu nhiều yêu cầu được nhận trong vòng năm giây, yêu cầu mới nhất sẽ được sử dụng.
- Nhấp vào Tạo lại để gửi một yêu cầu mới và tạo cài đặt mới.
Một khi yêu cầu được nhận, một ví dụ đầu ra (lược đồ JSON) sẽ được tự động tạo theo cấu trúc của yêu cầu mẫu. Cấu trúc mục hoàn chỉnh có thể được phân tích.
Lưu ý rằng, nếu bạn đang chỉnh sửa hoặc sửa đổi một quy trình làm việc tự động đã được kích hoạt, việc gửi một yêu cầu mẫu sẽ kích hoạt toàn bộ quy trình làm việc tự động một lần.
250px|700px|reset
250px|700px|reset
- Thiết lập thủ công: Nhập thủ công một mẫu JSON của yêu cầu trong trường Yêu cầu mẫu.
- Để trống: Chọn tùy chọn này nếu các bước tiếp theo trong quy trình làm việc tự động không cần tham chiếu đến yêu cầu bên ngoài.
Nếu bạn chuyển sang phương pháp cấu hình cấu trúc dữ liệu khác khi chỉnh sửa, chỉnh sửa gốc của bạn sẽ được lưu tạm thời và sau đó sẽ được xóa hoàn toàn khi bạn đóng cửa sổ cài đặt quy trình làm việc tự động.
Sử dụng thông tin nhận được thông qua webhook
Thông tin webhook có thể được tham chiếu trong các bước quy trình làm việc tự động tiếp theo sau khi schema đã được xây dựng.
Nhấp vào biểu tượng ⊕ trong hộp văn bản bạn muốn tham chiếu và di chuột qua Giá trị trả về của yêu cầu được gửi trong bước 1. Bạn có thể trực tiếp nhấp vào Chọn để tham chiếu nó hoặc nhấp vào Tiếp theo để xem thêm chi tiếp, và sau đó chọn cấu hình, phần tử, hoặc tiêu đề.
250px|700px|reset
250px|700px|reset
Nếu bạn chỉnh sửa schema JSON sau khi một bước tiếp theo đã tham chiếu thông tin webhook, tham chiếu sẽ bị vô hiệu hóa.
III. Câu hỏi thường gặp
Giới hạn kích thước cho yêu cầu HTTP là gì?
Bạn có thể nhận yêu cầu lên đến 4 MB kích thước.
Giới hạn tần suất nào áp dụng cho yếu tố kích hoạt webhook?
- Mỗi Base có thể xử lý tối đa 50 sự kiện yếu tố kích hoạt webhook mỗi giây.
- Mỗi quy trình làm việc tự động có thể xử lý tối đa năm sự kiện yếu tố kích hoạt webhook mỗi giây.
- Mỗi quy trình làm việc tự động không có mã thông báo chứng thực được kích hoạt có thể xử lý tối đa một sự kiện yếu tố kích hoạt webhook mỗi giây.
Để biết thêm thông tin về lỗi yếu tố kích hoạt webhook, xem Tổng quan về tham số webhook trong quy trình làm việc tự động Base.
Làm thế nào để giữ hoặc cập nhật cấu hình khi tôi sao chép quy trình làm việc tự động được kích hoạt bởi webhook (sử dụng mẫu để tạo quy trình làm việc hoặc nhập/xuất dòng)?
- Địa chỉ webhook sẽ được tạo lại.
- Mã thông báo cũng sẽ được tạo lại nếu bạn đã chọn Mã thông báo chứng thực.
- Giới hạn IP, cài đặt cấu trúc dữ liệu, và các cài đặt khác sẽ không thay đổi.
IV. Liên quan