OMICX Documentation

OMICX Public API cho phép các đối tác bên thứ ba tích hợp trực tiếp với nền tảng OMICX qua HTTP, gồm 4 nhóm năng lực:

Nhóm	Dùng để	Xem chi tiết
Khách hàng	Tạo, tra cứu, tìm kiếm, cập nhật khách hàng CRM; ghi chú, đánh giá, chuyển phụ trách, gán người liên quan	Khách hàng
Cấu hình	Danh mục tham chiếu dùng kèm Khách hàng — thuộc tính, tiêu chí AI Insights, Tag, Nhóm, nhân viên, quy trình	Cấu hình
Tích hợp	Speech to Text, Text to Speech, và Webhook nhận sự kiện bất đồng bộ	Tích hợp
Hệ thống	Health check	Hệ thống

Xác thực

Tất cả endpoint (trừ GET /health) đều yêu cầu header X-Api-Key — xem chi tiết tại trang API Keys.

Base URL

https://api.omicx.one cho toàn bộ endpoint, trừ health check dùng base URL riêng — xem Health Check. Luôn dùng HTTPS, không gửi API key qua HTTP thường.

Đồng bộ và bất đồng bộ

Khách hàng, Speech to Text, Text to Speech, Cấu hình xử lý đồng bộ (synchronous) — kết quả trả về ngay trong response HTTP, không cần polling.
Webhook hoạt động theo chiều ngược lại: bạn đăng ký một endpoint HTTP của mình để nhận sự kiện (ví dụ khi một job Speech to Text/Text to Speech hoàn tất) — xem Webhook và Callback Events.

Content-Type theo từng endpoint

Endpoint	Content-Type
`POST /customers`, `PATCH /customers`, `POST /customers/search`, …	`application/json`
`POST /tts`	`application/json`
`POST /stt`	`multipart/form-data`
`GET /health`	— (không cần xác thực)