> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.omicx.one/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.omicx.one/_mcp/server.

# Tạo Webhook

Hướng dẫn tạo Webhook để nhận thông báo tự động khi có kết quả từ các dịch
vụ AI (ví dụ Speech to Text) gửi về hệ thống bên ngoài của bạn.

## 1. Truy cập trang Webhooks

Vào **Tích hợp → Webhooks**. Trang này hiển thị danh sách webhook hiện có
(tên, URL, sự kiện đăng ký, ngày tạo/sửa đổi, lần hoạt động gần nhất, trạng
thái) và tab **Lịch sử gửi** để xem lại lịch sử gửi dữ liệu.

![Trang danh sách Webhooks](/_fern-files/_img/fa5d2e2d9d9721a75181d14760e2ccdb411dc0e8fd9cbf0904ad2f4d9ecbc917.webp)

Bấm **Thêm mới** để mở form tạo webhook.

## 2. Điền thông tin webhook

Ở tab **Thông tin**, điền:

| Trường                   | Mô tả                                                                                                                           |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
| **Tên Webhook**          | Bắt buộc — đặt tên để dễ nhận biết.                                                                                             |
| **Loại sự kiện**         | Bắt buộc — chọn sự kiện sẽ kích hoạt webhook, ví dụ `Speech to Text`.                                                           |
| **URL**                  | Bắt buộc — endpoint của bạn sẽ nhận dữ liệu, dạng `https://yourdomain.com/webhooks`.                                            |
| **Gửi lại khi thất bại** | Nếu bật, hệ thống tự động thử gửi lại tối đa 2 lần, mỗi lần cách nhau 60 giây, nếu server đích trả về lỗi HTTP (ngoài 200–299). |

![Form Thêm webhook mới — tab Thông tin](/_fern-files/_img/85882a04c628ac9e3e3de2213103c5251ab7807ce96a58d39fd0969ac3dd1627.webp)

## 3. Cấu hình bảo mật

Chuyển sang tab **Bảo mật** để chọn phương thức xác thực cho request gửi đến
webhook của bạn:

* **Không xác thực** — không kèm thông tin xác thực.
* **API Key** — hệ thống tự sinh một API key, gửi kèm trong header
  `x-api-key`. Có thể bấm **Tạo lại** để sinh key mới bất cứ lúc nào.
* **Custom Header** — tự định nghĩa header xác thực riêng.

![Form Thêm webhook mới — tab Bảo mật](/_fern-files/_img/353f67552b98ebc5992e76a2998b91dc933b5836a48aacee8717479f0750fb56.webp)

## 4. Cấu hình cảnh báo

Chuyển sang tab **Cảnh báo** để bật thông báo khi webhook gặp sự cố:

* **Cảnh báo khi Webhook gặp lỗi liên tiếp** — bật/tắt tính năng cảnh báo.
* **Số lần lỗi liên tiếp** — ngưỡng số lần lỗi liên tục trước khi gửi cảnh
  báo (mặc định `3`).
* **Sự kiện cảnh báo**:
  * *Webhook gặp lỗi* — gửi cảnh báo khi webhook trả về lỗi hoặc không nhận
    được phản hồi từ máy chủ đích.
  * *Webhook khôi phục* — gửi cảnh báo khi webhook hoạt động trở lại sau
    thời gian gặp lỗi.

![Form Thêm webhook mới — tab Cảnh báo](/_fern-files/_img/0f0d1705f8e47e050368f94bf49f53d6f66ec8824012aa324141561fa5862281.webp)

## 5. Hoàn tất

Có thể bấm **Gửi thử nghiệm** để kiểm tra webhook trước khi lưu. Khi đã sẵn
sàng, bấm **Tạo mới** để tạo webhook — webhook sẽ xuất hiện trong danh sách
ở bước 1.