> ## Documentation Index
> Fetch the complete documentation index at: https://chatbotx.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

> Hướng dẫn tạo và cấu hình Webhook trong ChatbotX để tự động gửi dữ liệu đến ứng dụng bên ngoài khi có sự kiện xảy ra.

**Webhook** là cách để ChatbotX tự động thông báo cho một ứng dụng khác khi có sự kiện xảy ra — thay vì bạn phải thủ công kiểm tra và đồng bộ dữ liệu.

Ví dụ đơn giản: Khi có khách hàng mới nhắn tin → ChatbotX tự động gửi thông tin đó đến hệ thống CRM của bạn qua Webhook — không cần làm tay, không bị bỏ sót.

## Giao diện Webhooks

Trang Webhooks gồm 2 phần:

* **Folders**: Nhóm các Webhook để dễ quản lý.
* **Webhooks**: Danh sách tất cả các Webhook đã tạo — có thể bật/tắt từng cái bằng nút toggle.
* **Để tạo Webhooks**: Nhấn **+ Create Webhook** → Nhập tên

<Frame>
  <img src="https://mintcdn.com/chatbotx/6419eoAF_uo2OCBi/images/image-133.png?fit=max&auto=format&n=6419eoAF_uo2OCBi&q=85&s=0221b0c64311556add9d4a4b8cb59268" alt="webhooks_create" width="3004" height="1163" data-path="images/image-133.png" />
</Frame>

### When this happens (Khi nào gửi?)

Chọn sự kiện sẽ kích hoạt Webhook. Danh sách điều kiện giống với Triggers:

**Tags:** Tag Applied, Tag Removed

**Custom Fields:** Custom Field Changed, DateTime Based Trigger, Conversation transferred to human/bot, New Contact, Contact Unsubscribed From Broadcast, Archived, Follow Up, Conversation Assigned/Unassigned

**Sequences:** Subscribed To Sequence, Unsubscribed From Sequence

**Entry Point Link:** Contact Referred A New Contact, Contact Referred Existing Contact

### URL (Gửi đến đâu?)

Dán URL endpoint của ứng dụng bên ngoài vào đây,  đây là địa chỉ mà ChatbotX sẽ gửi dữ liệu đến mỗi khi điều kiện được đáp ứng.

4. Nhấn **Save** để lưu lại.

<Frame>
  <img src="https://mintcdn.com/chatbotx/6419eoAF_uo2OCBi/images/image-134.png?fit=max&auto=format&n=6419eoAF_uo2OCBi&q=85&s=f9a6e226554b2de57a1d71d4d44779ce" alt="webhooks_rule" width="3014" height="1815" data-path="images/image-134.png" />
</Frame>

## Webhook hoạt động như thế nào?

Khi điều kiện xảy ra → ChatbotX tự động gửi một **HTTP POST request** chứa thông tin của liên hệ đến URL bạn đã cài đặt.

Ứng dụng đích (CRM, Google Sheets, Zapier, Make...) nhận dữ liệu đó và xử lý theo logic của nó.

**Dữ liệu thường được gửi kèm:**

* Tên, ID liên hệ
* Kênh (Messenger, WhatsApp, Zalo...)
* Tag, Custom Fields hiện có
* Thông tin về sự kiện đã kích hoạt

## Ví dụ thực tế

| Tình huống                        | Webhook làm gì?                                              |
| --------------------------------- | ------------------------------------------------------------ |
| Khách vừa được gán Tag "Chốt đơn" | Gửi thông tin khách vào Google Sheets để đội sale theo dõi   |
| Cuộc chat chuyển sang nhân viên   | Tạo ticket mới trong hệ thống hỗ trợ (Freshdesk, Zendesk...) |
| Có liên hệ mới từ quảng cáo       | Tạo lead trong CRM (HubSpot, Salesforce...)                  |
| Khách đăng ký Sequence            | Gửi email chào mừng qua hệ thống email marketing ngoài       |

> **Lưu ý:** Mỗi Webhook có nút toggle để bật/tắt mà không cần xóa. Dùng Folders để nhóm các Webhook theo chiến dịch hoặc kênh cho dễ quản lý.