Webhook gửi yêu cầu đến máy chủ của bạn mỗi khi có sự kiện xảy ra trong Notiondesk, chẳng hạn như tin nhắn liên hệ mới hoặc bài viết được xuất bản. Sử dụng nó để cập nhật CRM, kho dữ liệu hoặc các công cụ nội bộ của bạn mà không cần tự mình kiểm tra Notiondesk.
Trước khi bạn bắt đầu
- Bạn là chủ sở hữu không gian làm việc hoặc quản trị viên. Các vai trò khác không thể mở trang Webhooks.
- Máy chủ của bạn có một địa chỉ công khai bắt đầu bằng
https://, sử dụng tên miền (không phải địa chỉ IP) và chấp nhận các yêu cầu POST.
Thêm một điểm cuối
- Trong bảng điều khiển Notiondesk của bạn, hãy nhấp vào Cài đặt .
- Trong mục Workspace , mở Developers , sau đó mở Webhooks .
- Nhấp vào Thêm điểm cuối .
- Nhập URL sẽ nhận các yêu cầu, ví dụ:
https://hooks.acme-support.com/notiondesk.
- Nhập Tên thể hiện mục đích của điểm cuối này, ví dụ:
CRM sync.
- Trong mục Sự kiện , nhấp vào Thêm sự kiện và chọn các sự kiện mà điểm cuối này nên nhận. Nhập vào hộp tìm kiếm để tìm sự kiện nhanh chóng.

- Nhấp vào Thêm điểm cuối .
Một điểm cuối duy nhất sẽ nhận các sự kiện từ không gian làm việc của bạn và từ mọi trung tâm trợ giúp trong đó, vì vậy bạn không cần một điểm cuối cho mỗi trung tâm trợ giúp. Bạn có thể thêm tối đa 10 điểm cuối.
Sao chép bí mật ký kết
Ngay sau khi bạn thêm điểm cuối, Notiondesk sẽ hiển thị mã bí mật ký của nó. Máy chủ của bạn sử dụng mã này để kiểm tra xem mỗi yêu cầu có thực sự đến từ Notiondesk hay không.
- Nhấp vào Sao chép .
- Hãy lưu trữ thông tin bí mật ở nơi mà máy chủ của bạn có thể đọc được, chẳng hạn như biến môi trường hoặc trình quản lý bí mật.

- Nhấp vào "Tôi đã lưu" .
Gửi sự kiện thử nghiệm
- Trên trang điểm cuối, hãy nhấp vào Gửi sự kiện kiểm thử .
- Trong mục "Các lần giao hàng gần đây" , hãy kiểm tra xem sự kiện kiểm thử có hiển thị dấu tích màu xanh lá cây và mã phản hồi
200hay không. Điều này có nghĩa là máy chủ của bạn đã nhận được gói tin.
Nhấp vào một lần gửi để xem phản hồi của máy chủ và yêu cầu Notiondesk đã gửi. Nếu sự kiện kiểm tra thất bại, hãy kiểm tra xem máy chủ của bạn có trả lời bằng mã 2xx trong vòng vài giây hay không.
Câu hỏi thường gặp
Tôi có cần một điểm cuối (endpoint) riêng cho mỗi trung tâm trợ giúp không?
Không. Một điểm cuối duy nhất nhận các sự kiện từ không gian làm việc của bạn và từ tất cả các trung tâm trợ giúp của nó. Mục " Các lần gửi gần đây" cho biết mỗi sự kiện đến từ trung tâm trợ giúp nào.
Tôi có thể thêm bao nhiêu điểm cuối?
Tối đa 10 người mỗi không gian làm việc.
Ai có thể thêm điểm cuối (endpoint)?
Chỉ chủ sở hữu không gian làm việc và quản trị viên mới có thể thêm, thay đổi và xóa điểm cuối.
Tôi có thể sử dụng những URL nào?
Địa chỉ công cộng bắt đầu bằng https:// và sử dụng tên miền. Các địa chỉ trên mạng riêng của bạn và địa chỉ IP thông thường sẽ bị từ chối. Notiondesk không theo dõi các lệnh chuyển hướng, vì vậy hãy nhập địa chỉ cuối cùng.
Nếu tôi làm mất bí mật ký tên thì sao?
Mở trang điểm cuối và nhấp vào Xoay (Rotate) bên dưới Bí mật ký (Signing secret ). Bí mật mới sẽ được hiển thị một lần và bí mật cũ sẽ ngừng hoạt động ngay lập tức, vì vậy hãy cập nhật máy chủ của bạn cùng lúc.
Tôi có thể thay đổi các sự kiện sau này được không?
Vâng. Mở trang điểm cuối, thêm hoặc xóa sự kiện trong mục Sự kiện , sau đó nhấp vào Lưu thay đổi .