Giới thiệu về Webhook

eTelecom sẽ gửi các request http (method POST) đến Webhook url của Shop/Partner khi có các thay đổi liên quan đến lịch sử cuộc gọi, bao gồm: lịch sử cuộc gọi được tạo, lịch sử cuộc gọi được cập nhật file ghi âm.

Hướng dẫn cấu hình Webhook

eTelecom cho phép khách hàng cấu hình webhook trực tiếp trên trang quản trị cs.etelecom.vn hoặc thông qua API:

Tiêu chí phản hồi của Webhook

  • Thành công khi đáp ứng:

    • http status code = 200

    • Response body = ok hoặc ok\n (chính xác, phân biệt hoa thường)

    • Thời gian phản hồi < 60 giây

  • Thất bại nếu: timeout, lỗi mạng, status ≠ 200, body khác "ok", hoặc response > 60 giây.

Retry Event Webhook

  • eTelecom hỗ trợ gửi lại sự kiện về địa chỉ webhook đã tạo đối với những sự kiện gửi không thành công. Hệ thống retry theo Hybrid Exponential Backoff tối đa 14 lần, từ 30 giây → 24h.

  • Nếu vẫn thất bại, webhook sẽ bị disable và cần cấu hình lại.

Last updated