Knowledge BaseWhats NewFAQPrivacy Policy

Nhóm hành động Data ops

Hành động Gửi webhook (Gửi webhook từ Caresoft đến một ứng dụng khác) và định dạng dữ liệu (Áp dụng các quy tắc định dạng cho dữ liệu)

Trong nhóm hành động data ops có hai hành động gửi webhook và định dạng dữ liệu sử dụng cho các mục đích khác nhau

1, Hành động gửi webhook

Sử dụng webhooks trong quy trình làm việc để gửi hoặc nhận thông tin giữa hệ thống CareSoft và các công cụ bên ngoài khác. Có rất nhiều cách sử dụng webhooks. Ví dụ về các trường hợp sử dụng webhooks phổ biến bao gồm:

  • Đăng dữ liệu liên hệ của CareSoft lên hệ thống khác, chẳng hạn như CRM, khi liên hệ đó điền vào biểu mẫu cụ thể trên trang web của bạn.

  • Gửi dữ liệu giao dịch đến hệ thống xử lý lô hàng bên ngoài để tạo đơn đặt hàng.

  • Lấy dữ liệu từ hệ thống khác để cập nhật hồ sơ lên hệ thống của bạn.

Bạn có thể gửi cả yêu cầu POST và GET bằng quy trình làm việc. CareSoft điều chỉnh lưu lượng webhook riêng biệt với các quy trình làm việc khác. Điều này được thực hiện để hợp lý hóa hiệu suất quy trình làm việc và webhook. Khi webhook chậm hoặc hết thời gian chờ, hành động quy trình làm việc có thể mất nhiều thời gian hơn dự kiến để thực thi.

1.1 Thiết lập yêu cầu POST

  1. Trong tài khoản CareSoft của bạn, hãy điều hướng đến màn hình cấu hình Workflow

  2. Để chỉnh sửa quy trình công việc hiện có, hãy nhấp vào tên quy trình công việc. Hoặc, tạo workflow mới

  3. Trong trình chỉnh sửa quy trình làm việc, hãy nhấp vào biểu tượng + cộng để thêm hành động.

  4. Trong bảng điều khiển bên trái, trong phần Thao tác dữ liệu , chọn Gửi webhook .

  1. Nhấp vào menu thả xuống Phương thức và chọn POST .

  1. Nhập URL webhook .

  • URL webhook bị giới hạn ở giao thức bảo mật và phải bắt đầu bằng HTTPS.

  • Để yêu cầu thông tin cụ thể, bạn có thể thêm các tham số truy vấn như ?queryparameter=abcvào URL Webhook.

  • Nếu không có tham số truy vấn nào được thêm vào, yêu cầu POST hoặc GET chung sẽ được gửi.

  1. Thiết lập loại xác thực để xác thực các yêu cầu đến webhook của bạn. Bạn có thể sử dụng một trong hai cách thiết lập loại xác thực: không xác thực và khóa bí mật

  • Để sử dụng khóa bí mất chọn option khóa bí mật

  • Nhấp vào menu thả xuống Loại xác thực . Sau đó, chọn Khóa bí mật

  • Nhập tên khóa bí mật ( khóa API ) của bạn .

  • Nhấp vào menu thả xuống vị trí khóa API . Sau đó, chọn Query parameters(tham số truy vấn) hoặc Request header (Tiêu đề yêu cầu) .

  1. Để thêm header, hãy chọn Add Header

  2. Nhập Request Body

  3. Chọn Định dạng dữ liệu kiểu thời gian và kiểu lựa chọn theo mong muốn

  4. Nhấp vào Lưu .

Để chọn nhiều đầu ra, phản hồi phải được cấu trúc dưới dạng đối tượng JSON.

1.2 Thiết lập yêu cầu GET

  1. Trong tài khoản CareSoft của bạn, hãy điều hướng đến màn hình cấu hình Workflow

  2. Để chỉnh sửa quy trình công việc hiện có, hãy nhấp vào tên quy trình công việc. Hoặc, tạo workflow mới

  3. Trong trình chỉnh sửa quy trình làm việc, hãy nhấp vào biểu tượng + cộng để thêm hành động.

  4. Trong bảng điều khiển bên trái, trong phần Thao tác dữ liệu , chọn Gửi webhook .

  1. Nhấp vào menu thả xuống Phương thức và chọn GET .

  1. Nhập URL webhook .

  • URL webhook bị giới hạn ở giao thức bảo mật và phải bắt đầu bằng HTTPS.

  • Để yêu cầu thông tin cụ thể, bạn có thể thêm các tham số truy vấn như ?queryparameter=abcvào URL Webhook.

  • Nếu không có tham số truy vấn nào được thêm vào, yêu cầu POST hoặc GET chung sẽ được gửi.

  1. Thiết lập loại xác thực để xác thực các yêu cầu đến webhook của bạn. Bạn có thể sử dụng một trong hai cách thiết lập loại xác thực: không xác thực và khóa bí mật

  • Để sử dụng khóa bí mất chọn option khóa bí mật

  • Nhấp vào menu thả xuống Loại xác thực . Sau đó, chọn Khóa bí mật

  • Nhập tên khóa bí mật ( khóa API ) của bạn .

  • Nhấp vào menu thả xuống vị trí khóa API . Sau đó, chọn Query parameters(tham số truy vấn) hoặc Request header (Tiêu đề yêu cầu) .

  1. Để thêm header, hãy chọn Add Header

  2. Nhập Query Parameters

  3. Chọn Định dạng dữ liệu kiểu thời gian và kiểu lựa chọn theo mong muốn

  4. Nhấp vào Lưu .

1.3 Kiểm tra webhook

Tính năng này cho phép bạn kiểm tra webhook để xem phản hồi trả về, từ đó chọn các trường dữ liệu cần sử dụng cho các bước tiếp theo trong quy trình.

  • Tham số truy vấn (Query params) Nhập giá trị các tham số truy vấn nếu webhook của bạn yêu cầu.

Ví dụ: user_id=123 hoặc status=active

  • Bước kiểm tra webhook Nhập giá trị vào trường "Query params" nếu cần.

  • Nhấn nút Test webhook để gửi yêu cầu thử đến webhook.

  • Hệ thống sẽ hiển thị phản hồi từ webhook sau khi kiểm tra thành công.

  • Outputs (Kết quả đầu ra) Sau khi kiểm tra webhook, bạn có thể chọn các trường dữ liệu từ phần thân phản hồi để sử dụng trong các hành động khác của flow.

  • Các trường này sẽ được liệt kê trong bảng dưới mục Outputs với tên trường tương ứng.

2, Hành động định dạng dữ liệu

Sử dụng thao tác quy trình Định dạng dữ liệu để sửa, định dạng và duy trì dữ liệu CRM của bạn. Ví dụ: bạn có thể viết hoa tên liên hệ hoặc tên công ty, hoặc tính toán giá trị dựa trên các thuộc tính.

Định dạng dữ liệu bằng quy trình làm việc là một quy trình gồm hai bước. Đầu tiên, bạn sẽ chuẩn bị dữ liệu bằng cách thiết lập hành động Định dạng dữ liệu . Sau đó, bạn sẽ thiết lập một hành động quy trình làm việc khác để sử dụng dữ liệu.

Cập nhật các thuộc tính hiện có với dữ liệu được định dạng

Thiết lập hành động Chỉnh sửa bản ghi để cập nhật thuộc tính với dữ liệu mới được định dạng. Hành động này có thể sử dụng dữ liệu đã định dạng từ bất kỳ hành động Định dạng dữ liệu nào trước đó.

  1. Trong tài khoản CareSoft của bạn, hãy điều hướng đến Workflow .

  2. Nhấp vào tên của quy trình công việc hiện có hoặc tạo workflow mới .

  3. Trong trình chỉnh sửa quy trình làm việc, hãy nhấp vào biểu tượng + cộng để thêm hành động quy trình làm việc.

  4. Trong bảng hành động, chọn Chỉnh sửa bản ghi .

  5. Ở bảng bên trái, nhấp vào menu thả xuống Hàm xử lý dữ liệu , sau đó chọn một hàm xử lý dữ liệu .

Danh sách các hàm bạn có thể sử dụng:

Hàm

Mô tả chức năng

add

Cộng hai số.

Ví dụ: add(3, 4) → 7

subtract

Trừ một số khỏi số khác.

Ví dụ: subtract(10, 3) → 7

multiply

Nhân hai giá trị.

Ví dụ: multiply(2, 5) → 10

divide

Chia hai số.

Ví dụ: divide(10, 2) → 5

md5

Mã hóa dữ liệu đầu vào bằng thuật toán MD5.

Ví dụ: md5("abc") → 900150983cd24fb0d6963f7d28e17f72

base64_encode

Mã hóa chuỗi thành định dạng Base64.

Ví dụ: base64_encode("hello") → aGVsbG8=

rsa_sha256

Ký chuỗi bằng thuật toán RSA-SHA256. Cần cấu hình khóa phù hợp.

replace

Thay thế một chuỗi con bằng chuỗi khác.

Ví dụ: replace("abc_def", "_", "-") → abc-def

split_get

Tách chuỗi bằng dấu phân cách và lấy phần tử theo vị trí.

Ví dụ: split_get("a,b,c", ",", 1) → b

  1. Nhập giá trị hoặc biến cần xử lý

Bạn có thể sử dụng các biến hệ thống hoặc giá trị tĩnh làm đầu vào cho hàm. Nhấn vào biểu tượng Insert variable nếu cần chèn biến động.

  1. Lưu hành động

Sau khi định nghĩa xong công thức định dạng, nhấn Lưu để hoàn tất.

Last updated

Was this helpful?