Cách thiết lập webhook

Webhook gửi các sự kiện TicketingHub đã chọn đến một hệ thống khác ngay khi chúng xảy ra.

Trước khi bắt đầu

• Webhook phải được bật cho tài khoản TicketingHub của bạn. Hãy liên hệ với TicketingHub nếu phần Webhook không hiển thị.
• Bạn cần quyền truy cập của quản trị viên hoặc người quản lý.
• Hệ thống nhận phải cung cấp một URL HTTPS công khai.

Thêm webhook

1. Đi tới Cài đặt → Nâng cao.
2. Tìm Webhook và chọn Chỉnh sửa.
3. Chọn Webhook mới.
4. Nhập URL HTTPS sẽ nhận các sự kiện.
5. Chọn các loại sự kiện cần gửi, chẳng hạn như đặt chỗ đã được xác nhận hoặc đã hủy.
6. Không bắt buộc: nhập một khóa bí mật mạnh để hệ thống nhận có thể xác minh từng yêu cầu.
7. Tạo webhook, sau đó thực hiện một trong các sự kiện đã chọn để kiểm tra.

Nếu thêm khóa bí mật, TicketingHub sẽ ký từng yêu cầu và gửi chữ ký trong tiêu đề X-TicketingHub-Signature-256. Nhà phát triển của bạn nên xác minh chữ ký này trước khi chấp nhận dữ liệu.

Duy trì webhook hoạt động

Hệ thống nhận nên nhanh chóng phản hồi bằng mã trạng thái thành công 2xx. TicketingHub sẽ thử gửi lại những lần gửi bị hết thời gian chờ hoặc trả về phản hồi không thành công. Một endpoint liên tục gặp lỗi sẽ tự động bị vô hiệu hóa; hãy khắc phục hệ thống nhận, sau đó quay lại trang Webhook và bật lại webhook.

TicketingHub chỉ gửi sự kiện đến các địa chỉ công khai. Nếu URL trỏ đến một địa chỉ mạng riêng, chẳng hạn như máy chủ trong mạng riêng của bạn, TicketingHub sẽ không gửi sự kiện và ngay lập tức vô hiệu hóa webhook. Trang Webhook sẽ hiển thị “URL trỏ đến một địa chỉ mạng riêng” và quản trị viên tài khoản của bạn sẽ nhận được email. Hãy đổi URL thành một địa chỉ HTTPS công khai, sau đó bật lại webhook.

Chỉ chọn những sự kiện bạn cần và tránh sử dụng URL kiểm thử trong tài khoản đang hoạt động. Để gửi sự kiện đến Zapier mà không cần tự xây dựng hệ thống nhận, hãy xem Cách kết nối TicketingHub với Zapier. Để xây dựng một tích hợp cũng có thể yêu cầu dữ liệu từ TicketingHub, hãy xem Cách tạo và sử dụng mã thông báo API.