> ## Documentation Index > Fetch the complete documentation index at: https://docs-agents.fpt.ai/llms.txt > Use this file to discover all available pages before exploring further. # Nhận câu trả lời (callback) > Kiểm chứng webhook, cấu trúc sự kiện callback, các khối nội dung và cơ chế gửi lại Câu trả lời của Agent được gửi tới webhook của bạn bằng một lệnh `POST` đã ký, theo đúng [cách ký](/tich-hop/live-chat-api/kenh-api/xac-thuc-chu-ky) của chiều gửi lên. ```mermaid theme={null} sequenceDiagram participant D as Message Dispatching participant Y as API Webhook của bạn D->>Y: POST callback_url (nội dung sự kiện + X-Hub-Signature-256) Note over Y: Kiểm tra chữ ký Y->>Y: Xác thực HMAC-SHA256 Y->>Y: Chống trùng theo eventId Y->>Y: Gửi trả lời tới người dùng Y-->>D: 200 OK Note over D,Y: Không phải 2xx thì nền tảng thử lại tối đa 3 lần (1s, 3s, 9s) ``` ## Kiểm chứng điểm cuối webhook Trước khi tin nhắn thật đầu tiên tới, nút **Kiểm tra callback** trên Console gửi một yêu cầu đã ký để xác nhận điểm cuối của bạn hoạt động đúng. ```mermaid theme={null} sequenceDiagram participant P as FPT AI Agents Platform participant Y as Webhook Server của bạn P->>Y: POST callback_url type = verification, challenge Y->>Y: Xác thực chữ ký X-Hub-Signature-256 Y-->>P: 200 OK + challenge P->>P: Đối chiếu challenge Note over P: Khớp: ok. Không khớp: challenge_mismatch ``` ```json Yêu cầu kiểm chứng theme={null} { "type": "verification", "challenge": "6326e43c9f0b4a1d8e77c0b511a2d3f4", "occurredAt": "2026-09-07T11:08:40Z" } ``` Để vượt qua, hãy trả về mã 2xx kèm phần thân JSON lặp lại đúng giá trị `challenge`: ```javascript theme={null} app.post('/agent-replies', (req, res) => { // ... xác thực chữ ký ... const event = JSON.parse(raw.toString('utf8')); if (event.type === 'verification') { return res.json({ challenge: event.challenge }); } res.sendStatus(200); handleAsync(event); }); ``` * Yêu cầu kiểm chứng được ký bằng **đúng cách ký** như mọi gói tin khác. * Trường `type` **chỉ xuất hiện trên yêu cầu kiểm chứng**, không bao giờ có trên tin nhắn thật. * **Bắt buộc phải lặp lại `challenge`.** Trả 200 suông là chưa đủ, vì một tên miền bỏ trống hay trang báo lỗi của CDN cũng trả về 200. * Mỗi lần kiểm chứng dùng một `challenge` khác nhau. * Chúng tôi **không đi theo chuyển hướng** 301/302/303; hãy trỏ thẳng tới địa chỉ cuối cùng. * Kết quả đạt chỉ có nghĩa điểm cuối trả lời đúng **tại thời điểm đó**, không phải một chứng nhận được lưu lại. | Lý do thất bại | Ý nghĩa và cách xử lý | | - | - | | `no_secret` | Chưa có khóa ký nên chúng tôi không ký được, **không có yêu cầu nào được gửi đi**. Hãy tạo khóa trước. | | `url_forbidden` | Không phải URL https tuyệt đối, hoặc phân giải ra địa chỉ không công khai. | | `unreachable` | Không kết nối được. Dịch vụ đã chạy và mở ra Internet chưa? | | `http_status` | Điểm cuối trả về mã ngoài 2xx; mã cụ thể nằm ở trường `httpStatus`. | | `challenge_mismatch` | Trả về 2xx nhưng không lặp lại đúng `challenge`. | ## Cấu trúc sự kiện callback ```http theme={null} POST Content-Type: application/json User-Agent: fpt-agent-platform-channel-gateway/1 X-Hub-Timestamp: 1755763260 X-Hub-Signature-256: sha256= ``` | Trường | Kiểu | Mô tả | | - | - | - | | `eventId` | string | ID sự kiện, **ổn định qua các lần gửi lại**. Dùng làm khóa chống trùng. | | `integrationKey` | string | Khóa định tuyến của kênh. | | `conversationId` | string | ID cuộc hội thoại, dùng cho [API đọc lịch sử](/tich-hop/live-chat-api/kenh-api/lich-su-hoi-thoai). **Hãy lưu lại giá trị này.** | | `runId` | string | ID của một lượt trả lời. Mỗi lượt một giá trị. | | `from` | `bot` hoặc `operator` | Lượt nói do Agent trả lời hay do nhân viên của bạn tiếp quản. | | `user.id` | string | ID khách hàng, đúng giá trị bạn đã gửi lên. | | `text` | string | Nội dung văn bản. **Luôn có mặt**, kể cả khi có nút bấm hay carousel. | | `buttons` | `Array