Webhooks

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.

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

​

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.

​

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ế

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ý.