Tiện ích tích hợp

Tổng quan

Các Tiện ích tích hợp tùy chỉnh được khách hàng của Workplace sử dụng để phát triển nội bộ (hoặc phát triển riêng cho một khách hàng Workplace duy nhất sử dụng) nhằm tích hợp các công cụ hoặc hệ sinh thái phần mềm của riêng họ với Workplace.

Trong phần này, chúng ta sẽ học cách tạo và định cấu hình Tiện ích tích hợp tùy chỉnh trên Workplace.

Tạo tiện ích tích hợp

Để tạo tiện ích tích hợp, hãy đăng nhập với vai trò Quản trị viên có quyền thay đổi phần cài đặt của công ty và định cấu hình tiện ích tích hợp. Sau khi đăng nhập, bạn có thể hoàn tất các bước sau để tạo tiện ích tích hợp:

Sau khi đã tạo tiện ích tích hợp, bạn có thể tiến hành định cấu hình.

Cấu hình cơ bản

Trong phần Tiện ích tích hợp của Bảng điều khiển quản trị, nhấp vào tên của tiện ích tích hợp sẽ được định cấu hình. Đây là các trường thông tin bạn có thể tìm thấy trong màn hình chi tiết Tiện ích tích hợp.

• Chi tiết tiện ích tích hợp: Bạn có thể sửa Tên, logo và mô tả của tiện ích tích hợp, xem ID ứng dụng và khóa bí mật của ứng dụng, đồng thời tạo hoặc đặt lại Mã truy cập của tiện ích tích hợp.
  Cần phải có Mã truy cập để gửi mọi yêu cầu API thì Workplace mới có thể xác minh và xác thực rằng tiện ích tích hợp đang gửi những yêu cầu đó. Bạn nên lưu Mã truy cập vào một nơi an toàn vì mã này có thể được sử dụng để thực hiện các hành động quan trọng trên Workplace, chẳng hạn như tạo hoặc hủy kích hoạt tài khoản người dùng (với điều kiện tiện ích tích hợp có quyền tương ứng).
• Khả năng hiển thị: Bạn có thể bật hoặc tắt tiện ích tích hợp. Nếu tắt, tiện ích tích hợp sẽ không thể thực hiện bất kỳ yêu cầu API nào.
  Ngoài ra, bạn còn có thể bật hoặc tắt khả năng khám phá tiện ích tích hợp. Điều này sẽ khiến cho tiện ích tích hợp của bạn xuất hiện trong danh sách các bot có sẵn trên Workplace.
• Yêu cầu API mới nhất: Bạn có thể xem ngày cuối cùng mà tiện ích tích hợp thực hiện một yêu cầu API và số lượng yêu cầu được thực hiện trong bảy ngày qua.
• Xóa tiện ích tích hợp: Bạn có thể xóa tiện ích tích hợp. Hành động này không thể hoàn tác và sẽ xóa tiện ích tích hợp và nội dung liên quan.

Quyền

Trên màn hình cấu hình của tiện ích tích hợp, có một phần gọi là Quyền, nơi bạn có thể chọn các quyền mà tiện ích tích hợp của bạn sẽ cần truy cập. Sau đây là danh sách các quyền.

Để tìm hiểu thêm về các quyền của Tiện ích tích hợp tùy chỉnh, vui lòng truy cập Tài liệu dành cho nhà phát triển.

Webhooks

Một phần khác có sẵn để định cấu hình cho mỗi tiện ích tích hợp là Webhooks. Với Webhooks, bạn có thể đăng ký các sự kiện cụ thể và nhận thông tin mới theo thời gian thực. Khi có thay đổi trong Workplace, một yêu cầu HTTPS POST sẽ được gửi đến URL gọi lại cho mỗi ứng dụng tiện ích tích hợp tùy chỉnh đã đăng ký chủ đề webhook liên quan.

Một ví dụ về webhook có thể là việc nhận thông tin mới trong URL gọi lại khi có một bình luận đã được tạo trong bài viết.

Chủ đề
Webhooks được chia thành các chủ đề và bạn có thể đặt một URL gọi lại khác nhau cho mỗi chủ đề. Bạn có thể xem Tài liệu dành cho nhà phát triển để biết thêm thông tin về chủ đề và gói đăng ký hiện có.

Đăng ký webhook
Bạn có thể xem Tài liệu dành cho nhà phát triển để biết thêm thông tin về cách đăng ký và thực hiện webhook.

Bảo mật

Phần cuối cùng của cấu hình cho tiện ích tích hợp là Bảo mật. Bạn có thể đặt hai loại cấu hình tại đây:

• Danh sách IP máy chủ cho phép, trong đó bạn có thể cho phép các địa chỉ IP trong danh sách chỉ chấp nhận các lệnh gọi API đến từ các địa chỉ IP đó.
• Cần bằng chứng khóa bí mật của ứng dụng, trong đó bạn có thể bật một lớp bảo mật bổ sung đòi hỏi bạn phải vượt qua các chi tiết khóa bí mật của ứng dụng khi thực hiện lệnh gọi API.