eSIM Middleware · Viettel M2M
Một API cho toàn bộ vòng đời eSIM IoT.
Kết nối thiết bị của bạn với mạng Viettel M2M. Quản lý pool data, kích hoạt, tạm dừng và thu hồi eSIM — qua REST API, dashboard trực quan và webhook realtime.
Data pool
500 GB
eSIM active
128
+12 trong 7 ngày
8984 0480 …0001
meter-hn-014
8984 0480 …0002
camera-hcm-07
8984 0480 …0003
tracker-dn-21
Webhook
SIM_STATUS_CHANGED · 200 OK
REST API
x-api-key
Queue
BullMQ · Redis
Webhook
HMAC-SHA256
Telco
Viettel M2M
Vận hành eSIM, không vận hành Excel
Quản lý SIM IoT không nên là
một file Excel.
Khi fleet lớn dần, thao tác thủ công trên portal telco trở thành điểm nghẽn. KOVITEL đưa toàn bộ vòng đời eSIM vào một luồng có kiểm soát, có trạng thái và có audit.
Cách vận hành cũ
Portal, email và bảng tính rời rạc
- Thao tác thủ công trên portal Viettel cho từng SIM
- Excel, email và tin nhắn rời rạc giữa các team
- Không có audit trail khi tạm dừng hoặc thu hồi SIM
- Khó biết job nào đã chạy, job nào còn treo
Với KOVITEL
Một lớp middleware cho cả đội kỹ thuật và vận hành
- Một REST API cho allocate, activate, suspend, resume, release
- Dashboard chung cho vận hành, kỹ thuật và kinh doanh
- Mọi thao tác có jobId, trạng thái và audit log
- Webhook realtime khi SIM đổi trạng thái hoặc vượt 90% data
Năng lực nền tảng
Một lớp middleware. Sáu năng lực vận hành.
Không cần tự xây hàng đợi, retry, session telco hay webhook signing. Tập trung vào thiết bị và khách hàng của bạn.
Pool data dùng chung
Theo dõi total, used và remaining quota theo từng pool. Cảnh báo hết hạn, phân bổ SIM và kiểm soát dung lượng tập trung.
Vòng đời eSIM có kiểm soát
Activate, suspend, resume và release qua một endpoint. Trạng thái SIM, job và lịch sử thao tác luôn đồng bộ.
Batch 500 ICCID
Gửi một request cho cả lô thiết bị. Hệ thống fan-out thành job riêng và tổng hợp tiến độ.
Telemetry & usage
Tra cứu data gần realtime, tổng hợp usage theo pool và cảnh báo khi SIM chạm 90%.
Webhook đã ký
Mỗi sự kiện có HMAC-SHA256, delivery ID và retry. Không cần polling liên tục.
Luồng xử lý
API trả jobId ngay.
Worker xử lý phần còn lại.
Telco không phải lúc nào cũng phản hồi trong vài giây. KOVITEL tách request khỏi xử lý telco để API luôn nhanh, worker kiểm soát retry và bạn không phải giữ kết nối chờ.
Partner gọi API
Allocate eSIM hoặc yêu cầu đổi trạng thái. API xác thực, ghi job và trả 202 kèm jobId ngay lập tức.
Worker nhận job
BullMQ giới hạn tốc độ, retry khi lỗi mạng và đảm bảo không spam cổng Viettel.
Telco xử lý
Reverse API gọi Viettel M2M; nếu cổng không ổn định, Playwright RPA có thể tiếp quản.
Webhook & audit
Kết quả được ghi vào cơ sở dữ liệu, ký HMAC và gửi webhook về hệ thống của bạn.
PUT /api/v1/sim/8984048000000000001/status
x-api-key: kov_live_…
{ "action": "SUSPEND" }
HTTP/1.1 202 Accepted
{
"jobId": "8f3c2d1a-9b04-4b6c-…",
"status": "PENDING",
"action": "SUSPEND"
}{
"jobId": "8f3c2d1a-…",
"type": "SIM_SUSPEND",
"status": "COMPLETED",
"result": {
"iccid": "8984048000000000001",
"status": "SUSPENDED",
"channel": "REVERSE"
}
}Retry 3 lần với exponential backoff. Nếu chuyển sang RPA, cùng một job vẫn giữ nguyên trạng thái và audit.
Use cases
Một pool data. Nhiều mô hình thiết bị.
Từ đồng hồ đo từ xa đến camera giám sát, cùng một lớp quản lý eSIM giúp đội vận hành giảm thao tác thủ công và kiểm soát chi phí data.
Smart metering
Đồng hồ điện & nước
Quản lý fleet thiết bị đo từ xa, tạm dừng SIM chưa thanh toán và theo dõi hạn mức theo pool.
Video surveillance
Camera & giám sát
Kích hoạt SIM khi lắp đặt, theo dõi data theo camera và thu hồi khi thiết bị ngừng hoạt động.
Fleet tracking
Logistics & telematics
Batch activate cho lô thiết bị mới, webhook khi SIM bị chặn và tra cứu usage gần realtime.
Smart agriculture
Nông nghiệp thông minh
Pool dùng chung cho trạm cảm biến theo mùa vụ, giảm lãng phí data ngoài thời gian canh tác.
Developer experience
Tích hợp trong một buổi chiều.
REST thuần, JSON quen thuộc, tài liệu OpenAPI và ví dụ chạy được. Không SDK độc quyền, không lock-in.
API key theo partner
Xác thực bằng header x-api-key, có thể rotate bất kỳ lúc nào.
Job bất đồng bộ
Nhận jobId ngay, poll hoặc chờ webhook — tùy cách hệ thống của bạn vận hành.
OpenAPI 3.1
Contract đầy đủ cho Postman, code generator và API reference.
Webhook có chữ ký
HMAC-SHA256, delivery log, retry và test button ngay trên dashboard.
import { KOVITEL_API_URL, KOVITEL_API_KEY } from './config';
const res = await fetch(
`${KOVITEL_API_URL}/sim/8984048000000000001/status`,
{
method: 'PUT',
headers: {
'x-api-key': KOVITEL_API_KEY,
'content-type': 'application/json',
},
body: JSON.stringify({ action: 'SUSPEND' }),
},
);
const { jobId, status } = await res.json();
// { jobId: "8f3c...", status: "PENDING" }Base URL
/api/v1
Auth
x-api-key
Rate limit
5 req/s
Bảng giá
Bắt đầu nhỏ. Mở rộng theo fleet.
Chi phí nền tảng tính theo quy mô pool và số eSIM hoạt động. Cước viễn thông Viettel được báo riêng theo hợp đồng M2M.
Sandbox
dùng thử
0đ
Cho đội kỹ thuật kiểm chứng luồng tích hợp trước khi ký hợp đồng.
- 1 pool dữ liệu test
- 20 eSIM demo
- Đầy đủ REST API & webhook test
- Tài liệu API + API reference
- Hỗ trợ qua email
Business
pool & số eSIM
Theo quy mô
Vận hành production trên hạ tầng Viettel M2M với SLA và hỗ trợ vận hành.
- Pool data production
- Không giới hạn job xử lý nền
- Webhook + retry tự động
- Batch tối đa 500 ICCID / request
- SLA 99.9% theo hợp đồng
- Hỗ trợ 8x5 · kênh riêng
Enterprise
triển khai riêng
Liên hệ
Cho doanh nghiệp cần pool riêng, tích hợp sâu hoặc yêu cầu hạ tầng nội bộ.
- Pool riêng / dedicated quota
- RPA fallback & private APN
- SSO, RBAC, audit log
- Triển khai VPC / on-prem
- Tích hợp hệ thống nội bộ
- Hỗ trợ 24/7
Giá hiển thị chưa bao gồm VAT và cước telco. Sandbox không gọi lệnh thật lên mạng lõi. SLA và quota production được xác nhận trong hợp đồng.
Câu hỏi thường gặp
Trước khi bắt đầu.
Những điểm đội kỹ thuật và vận hành thường hỏi trước khi đưa eSIM IoT vào production.
Không thấy câu trả lời? Gửi câu hỏi
KOVITEL IoT là gì?
Là lớp middleware kết nối nền tảng quản lý thiết bị của doanh nghiệp với mạng Viettel M2M. Thay vì thao tác thủ công trên cổng Viettel, đội vận hành dùng REST API, dashboard và webhook để quản lý pool data, kích hoạt, tạm dừng hoặc thu hồi eSIM.
Tôi có cần hợp đồng riêng với Viettel không?
Có. KOVITEL cung cấp lớp tích hợp và vận hành, còn dung lượng, đầu số và chính sách cước tuân theo hợp đồng M2M giữa doanh nghiệp và Viettel. KOVITEL phối hợp trong quá trình onboarding và đấu nối.
Bao lâu thì tài khoản partner được duyệt?
Tài khoản đăng ký ở trạng thái PENDING và có thể đăng nhập ngay để xem dashboard, tài liệu. KOVITEL liên hệ xác minh nhu cầu, hợp đồng và cấu hình pool trước khi kích hoạt API key — thường trong 1 ngày làm việc sau khi đủ thông tin.
Có môi trường sandbox để test không?
Có. Sandbox cung cấp pool test, eSIM demo và đầy đủ endpoint để kiểm tra luồng allocate, đổi trạng thái, batch, polling job và webhook. Sandbox không gọi lệnh thật lên mạng lõi.
Hệ thống xử lý thao tác chậm hay đồng bộ?
Các thao tác thay đổi trạng thái SIM được đưa vào BullMQ và xử lý nền. API trả jobId ngay, sau đó bạn poll GET /jobs/{jobId} hoặc nhận webhook khi hoàn tất. Cách này tránh timeout và bảo vệ cổng Viettel khỏi quá tải.
Webhook có bảo mật không?
Mỗi delivery được ký HMAC-SHA256 trên timestamp + raw body, gửi kèm header x-kovitel-signature. Hệ thống retry theo exponential backoff và lưu lịch sử delivery để đối soát.
Có giới hạn số request không?
Mặc định 5 request/giây tới Viettel cho mỗi worker để tuân thủ giới hạn của cổng telco. API phía partner có rate limit riêng và có thể điều chỉnh theo hợp đồng. Batch hỗ trợ tối đa 500 ICCID mỗi request.
Dữ liệu của tôi được lưu ở đâu?
Metadata vận hành (client, pool, SIM, job, webhook delivery) lưu trong PostgreSQL; session và queue lưu trong Redis. KOVITEL không lưu nội dung traffic của thiết bị. Chính sách chi tiết nằm trong hợp đồng xử lý dữ liệu.
Bắt đầu từ sandbox
Đưa eSIM IoT vào vận hành, không cần chờ hạ tầng.
Tạo tài khoản partner, nhận API key và thử toàn bộ luồng trên sandbox. KOVITEL đồng hành từ lúc thiết kế tích hợp đến khi pool chạy production.