logo

Khái niệm

Event Subscriptions chính là các thông báo khi có sự thay đổi từ một đối tượng nào đó mà ở đây chúng ta đang đề cập đến Attendance.

Các Event sẽ khác nhau tùy thuộc vào quyền hạn mà chúng ta đã xin cấp phát cho Bot.

Event Subscriptions

Hãy truy cập vào Event Subscriptions

EventSubscription

Các bạn có thể bỏ qua bước bên dưới nếu đã có Encrypt Key.
Tiếp tục nhấn vào nút Reset ở mục Encrypt Key để khởi tạo key mới.

ResetEncryptKey

Chúng ta sẽ sử dụng Encrypt Key này ở các bước sau. Do đó hãy sao chép chúng ra bên ngoài để tiện chuẩn bị sẵn trước khi sử dụng !

Tài khoản Lakium.com

Để có thể tương tác với các sự kiện Attendance trên Workspace, bạn cần đăng ký tài khoản trên Lakium.com. Lakium sẽ giúp bạn phân tích và xử lý các sự kiện này.

Hãy truy cập vào https://my.larkhub.com để đăng ký tài khoản và tiến hành tích hợp với hệ thống.

Sau khi đăng ký tài khoản thành công, các bạn nhấn vào mục Rules của nhóm Attendance ở menu bên trái để tiến hành cập nhật các thông tin của Bot App.

Rules

Bạn cần khởi tạo một Attendance Group hoặc sử dụng một group có sẵn trước khi tiếp tục các bước bên dưới.

Các bạn tiến hành cập nhật các thông tin theo các mục đánh số thứ tự và cuối cùng bấm Save để kiểm tra và kết nối.

AttendanceBot
  • Bot App ID của Custom App
  • Bot App Secret của Custom App
  • Encrypt Key của Event Subscriptions
  • Tên Attendance Group mà bạn đã tạo trên Workspace (lưu ý cần chính xác!)
  • Bật Debug để nhận thông tin debug của bot nhắn vào group.

Nếu tất cả các thông tin đều chính xác thì bạn sẽ nhận được một địa chỉ ở phần Your Endpoint phía trên xuất hiện.
Đây chính là địa chỉ bạn cần cập nhật vào mục Request URL của phần Event Subscriptions bên trên.

Endpoint

Đăng ký Event Subscriptions

Sau khi đã cập nhật xong Request URL chúng ta kéo xuống phía dưới để tiến hành Add Events cần thiết sau đó nhấn Confirm để hoàn thành bước này:

  • Bot added to group
  • user_task_change
BotAdded UserTaskChanged

Tiếp tục thêm các Event Permissions bên dưới để hoàn thành quá trình đăng ký cho Bot App:

  • Obtain group information
  • Export attendance data
EventClick AddEvent

Sau khi đã thêm được các events, chúng ta cần phát hành một phiên bản mới cho Bot App của mình hoạt động.
Vui lòng tham khảo hướng dẫn Tạo phiên bản mới cho app để tiếp tục.

Đối với các thay đổi không mang tính ảnh hưởng thì việc phát hành phiên bản mới sẽ không cần phải thông qua bước kiểm duyệt từ quản trị workspace nữa. Nghĩa là bot app của bạn sẽ được phát hành ngay sau đó.

Thêm Bot vào Group Messenger

Hãy truy cập vào Messenger và tạo nhóm mới hoặc sử dụng nhóm có sẵn của bạn sau đó thêm Custom Bot App mà bạn đã tạo ở các bước trên vào nhóm.

Nếu bạn nhận được một tin nhắn như bên dưới thì nghĩa là Bot App của chúng ta đã sẵn sàng hoạt động rồi đấy!

LarkhubBot