Kết nối Webhook & Bot (Telegram, Generic)

Telegram Bot

Tạo bot qua @BotFather trên Telegram → lấy bot token (dạng 123456:ABC-DEF...).
Wizard New inbox → Connect a new channel → Telegram Bot. Nhập tên connection + bot token. Hệ thống hiện Webhook URL + Secret token.
Bấm Continue → Create inbox để lưu connection + inbox.
Đăng ký webhook với Telegram (một lần) — mở URL này trên trình duyệt (thay <bot_token>):
```
https://api.telegram.org/bot<bot_token>/setWebhook?url=<Webhook URL>&secret_token=<Secret token>
```
Telegram trả {"ok":true,...} là xong. Từ giờ khách nhắn bot → tạo ticket; agent reply → bot gửi lại cho khách.

Generic Webhook

Dùng khi hệ thống của bạn (hoặc một kênh chưa có adapter riêng) muốn đẩy tin nhắn vào Helpdesk qua HTTP.

Wizard New inbox → Connect a new channel → Generic Webhook. Nhập tên + (tuỳ chọn) Reply URL (nơi nhận agent reply). Hệ thống sinh Webhook URL + Signing secret.
Create inbox để lưu.

Hệ thống của bạn POST tới Webhook URL, body JSON:

{
  "thread_id": "cust-42",
  "message_id": "m1",
  "from": { "id": "u-42", "name": "Nguyen Van A", "email": "a@example.com" },
  "text": "Xin chào, tôi cần hỗ trợ"
}

Kèm header ký:

X-Signature: hex(HMAC_SHA256(rawBody, <Signing secret>))

thread_id giữ hội thoại liên tục; message_id để chống trùng.

(tuỳ chọn) Nếu đặt Reply URL, mỗi agent reply sẽ được POST về đó: body { thread_id, conversation_id, message_id, text } kèm X-Signature ký bằng chính secret trên — hệ thống của bạn verify rồi hiển thị cho khách.

Kết nối Webhook & Bot (Telegram, Generic)

Telegram Bot

Generic Webhook

Đọc tiếp