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 Messenger.

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

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 !

Sau khi khởi tạo thành công Encrypt Key mới, bạn kéo xuống phía dưới mục Request URL configuration và điền theo hướng dẫn sau để tích hợp với dịch vụ của Lakium:

RequestUrl

Request URL có định dạng

https://openai.cunglark.com/api/v1/listener/appId/appSecret/encryptKey/openaiSecretKey/replyWhen

Diễn giải các tham số trên url:

  • appId: chính là App ID của Custom App
  • appSecret: chính là App Secret của Custom App
  • encryptKey: chính là Encrypt Key của Event Subscriptions
  • openaiSecretKey: chính là OpenAI Secret Key trên tài khoản OpenAI của bạn
  • replyWhen: giá trị không bắt buộc có thể để trống. Giá trị có thể điền là: all (sẽ trả lời tất cả các tin nhắn trong messenger) hoặc mention (chỉ trả lời khi được nhắc đến tên bot)

Sau khi điền đúng theo cú pháp hướng dẫn bên trên, hãy bấm vào Save để Larksuite kiểm tra Request URL của chúng ta đã "chính xác" hay chưa.

Nếu nhận được thông báo Challenge code didn't get response hoặc Response data is not valid JSON format thì nghĩa là các tham số bạn điền vào Request URL chưa chính xác, hãy kiểm tra và thử lại.

DidnotGetResponse

Còn ngược lại thì hệ thống sẽ tự động lưu Request URL lại và hiển thị như bên dưới

RequestUrlValidated

Tiếp tục kéo xuống mục Event added và bấm vào nút Add events để thêm sự kiện muốn lắng nghe.

AddEvent

Chúng ta sẽ chọn Messenger và tích vào Message received sau đó bấm Confirm để thêm sự kiện

MessageReceived

Các events mà chúng ta sẽ nhận được gồm có:

  • Read group chat messages mentioning the bot
  • Obtain group messages mentioning the bot
  • Read all messages in associated group chat
  • Obtain all messages in the associated group chats
  • Read private messages sent to the bot
  • Obtain private messages sent to the bot
EventAdded

Lần lượt bấm vào từng dòng đã được đánh số thứ tự để áp dụng và thêm sự kiện quyền hạn cho bot app.

AddEventConfirm

Sau khi đã thêm đượ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 đó.