Webhook: Cách kết nối từ Request sang Office in

Đã sửa đổi vào: Thu, 1 Tháng 5, 2025 lúc 11:53 CH

Bài toán: Sau khi request được tạo hoặc duyệt >> Tạo thành 1 văn bản thông báo trên office.

Để cài đặt kết nối Request sang Onboard, bạn thao tác theo hướng dẫn sau nhé

1. Tạo trường tuỳ chỉnh trên request

• Bước 1: Cần tạo danh sách các trường tuỳ chỉnh bắt buộc sau

Đối với loại văn bản thông báo: Chọn loại văn bản là ann

• Bước 2: Vào loại văn bản để copy API

Bạn Copy API này:

• Bước 3: Dán vào webhook của request:

Request Created: Tạo văn bản khi đề xuất được tạo

Request Created: Tạo văn bản khi đề xuất được duyệt

Request Rejected: Tạo văn bản khi đề xuất từ chối

• Bước 4: Lấy ID của kho lưu trữ, nhóm thư mục…..

Truy cập Base Office → Tùy chỉnh → Liên kết API → Lấy các API “Tạo văn bản”

1.Collection_id: Mã nhóm nội dung. Mỗi nhóm nội dung cài đặt hệ thống sẽ tự động tạo thành ID tương ứng. Click vào hình mũi tên để biết mỗi nhóm nội dung có ID là gì

2. Folder_id: Mã thư mục. Mỗi mã thư mục cài đặt hệ thống sẽ tự động tạo thành ID tương ứng. Click vào hình mũi tên để biết mỗi thư mục có ID là gì

3.Storeage_id: Mã kho lưu trữ. Mỗi kho lưu trữ khi cài đặt hệ thống sẽ tự động tạo thành ID tương ứng. Click vào hình mũi tên để biết mỗi kho lưu trữ có ID là gì

4.Book_id: số sổ văn bản:

5. Mã đơn vị ban hành: Team_id

6.Người nhận văn bản. Nếu người nhận là cá nhân thì cần gõ họ tên đầy đủ của cá nhân (@username của cá nhân), nếu người nhận là nhóm thì cần gõ đầy đủ tên nhóm (@username của nhóm). Ví dụ Trịnh Thị Thảo (@thaotrinh)

7. Người theo dõi văn bản

• Bước 5: Cài đặt transfomer

Lưu ý: Với các trường tuỳ chỉnh cần liên kết giữa 2 app, bạn setup theo cấu trúc

- Original key: custom_key_request

- Final key: {custom_key_office}                    

• Bước 6: Tạo request

Tạo 1 request và điền các trường tuỳ chỉnh

+ Hệ thống tự động tạo thông báo bên office vào Loại văn bản tương ứng.

+ Với mã bộ đếm, mã sổ văn bản được tự động chạy theo cài đặt của loại văn bản

+ Bạn nên tạo mã bộ đếm theo cấu trúc từ Office, văn bản tạo tự động từ Request sẽ tự động sinh theo mã cài đặt tương ứng

Lưu ý:

• Chỉ điền trường thông tin người duyệt nếu ô trạng thái chọn là 0 ( chờ ban hành)

• Cây thư mục, kho lưu trữ, sổ văn bản, thư mục, người gửi: Cần điền ID ( ko điền tên dạng text)

Câu trả lời này có giúp ích cho bạn không? Yes No