> For the complete documentation index, see [llms.txt](https://econtract-docs.matbao.in/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://econtract-docs.matbao.in/he-thong/webhook.md).

# Webhook

### A. Thêm Webhook mới

**Bước 1:** Mở màn hình tạo Webhook: Nhấn + Thêm webhook ở góc trên bên phải.

**Bước 2:** Khai báo thông tin

Điền các thông tin theo yêu cầu:

\| Trường thông tin | Mô tả | | --- | --- | | URL Callback | Địa chỉ API của hệ thống sẽ nhận dữ liệu từ Mắt Bão Invoice. Ví dụ: <https://domain.com/webhook/signDone> | | Loại (Type) | Chọn loại sự kiện cần nhận thông báo (ví dụ: Hoàn tất ký, Người ký đã ký...). | | Trạng thái | Bật để kích hoạt Webhook ngay sau khi tạo. |

Sau khi hoàn tất, nhấn Lưu.

### B. Quản lý danh sách Webhook

Sau khi tạo, danh sách Webhook sẽ hiển thị các thông tin:

* URL Callback
* Loại sự kiện
* Ngày tạo
* Ngày cập nhật
* Trạng thái
* Thao tác

### C. Bật hoặc tắt Webhook

Để thay đổi trạng thái hoạt động:

Tại cột Trạng thái, gạt công tắc:

* Hoạt động: Hệ thống sẽ gửi dữ liệu đến URL Callback khi phát sinh sự kiện.
* Vô hiệu: Hệ thống sẽ tạm dừng gửi dữ liệu. Lưu ý: Khi Webhook ở trạng thái Vô hiệu, hệ thống sẽ không gửi bất kỳ thông báo nào đến URL Callback.

### D. Chỉnh sửa Webhook

Nếu cần thay đổi URL Callback hoặc cấu hình:

1. 1\. Chọn biểu tượng Chỉnh sửa () tại cột Thao tác.
2. 2\. Cập nhật thông tin.
3. 3\. Nhấn Lưu để hoàn tất.

### E. Xóa Webhook

Để xóa Webhook:

Chọn biểu tượng Thùng rác ().

Xác nhận thao tác xóa.

Lưu ý: Sau khi xóa, Webhook sẽ không thể khôi phục. Nếu cần sử dụng lại, Quý khách phải tạo mới.

### F. Tìm kiếm Webhook

Sử dụng ô Tìm kiếm phía trên danh sách để tra cứu nhanh Webhook theo:

* URL Callback.
* Loại sự kiện (Type). Lưu ý khi sử dụng:
* URL Callback phải là địa chỉ mà hệ thống của Quý khách có thể truy cập từ Internet.
* Khuyến nghị sử dụng giao thức HTTPS để đảm bảo an toàn dữ liệu.
* Máy chủ nhận Webhook cần phản hồi thành công (HTTP Status 200 OK) để xác nhận đã nhận dữ liệu.
* Trường hợp sử dụng địa chỉ nội bộ như localhost, hệ thống Mắt Bão sẽ không thể gửi dữ liệu nếu máy chủ không được công khai ra Internet.
* Nếu thay đổi URL Callback, Quý khách cần cập nhật lại trên Webhook để đảm bảo hệ thống gửi dữ liệu đến đúng địa chỉ.

![Hình minh họa trang 41 - ảnh 1](https://econtract-images.matbaoflow.io.vn/d/1sfIku_GqtwQzDpL5nbaydWXE8xIyPCW-/)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://econtract-docs.matbao.in/he-thong/webhook.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.