eSIM 中间件 · Viettel M2M
一套 API，覆盖 物联网 eSIM 全生命周期
将设备接入 Viettel M2M 网络。通过 REST API、可视化控制台和实时 Webhook 管理数据池，并激活、暂停或回收 eSIM。
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
队列
BullMQ · Redis
Webhook
HMAC-SHA256
运营商
Viettel M2M
运营 eSIM，而不是运营表格
物联网 SIM 管理不应是一份 Excel 文件。
随着设备规模增长，手动操作运营商门户会成为瓶颈。KOVITEL 将整个 eSIM 生命周期放入一个可控、可追踪、可审计的流程。
传统方式
门户、邮件和分散的表格
- 每张 SIM 都需要在 Viettel 门户手动操作
- Excel、邮件和聊天记录分散在各团队
- 暂停或回收 SIM 时没有审计记录
- 无法知道哪些任务已完成、哪些卡住了
使用 KOVITEL
一套同时服务技术与运营团队的中间件
- 一套 REST API 完成分配、激活、暂停、恢复和回收
- 运营、技术和商务团队共享一个控制台
- 每个操作都有 jobId、状态和审计日志
- SIM 状态变化或数据达到 90% 时实时推送 Webhook
平台能力
一层中间件，六项运营能力。
无需自行构建队列、重试、运营商会话或 Webhook 签名。专注于设备和客户。
共享数据池
按数据池跟踪总额、已用和剩余配额。支持到期提醒、SIM 分配和集中容量控制。
可控的 eSIM 生命周期
通过一个接口完成激活、暂停、恢复和回收。SIM 状态、任务和操作历史始终保持同步。
批量处理 500 个 ICCID
一次请求处理整批设备。系统自动拆分为独立任务并汇总进度。
遥测与用量
近实时查询用量，按数据池汇总，并在 SIM 达到 90% 时发出提醒。
签名 Webhook
每个事件都带有 HMAC-SHA256 签名、投递 ID 和重试机制。无需持续轮询。
处理流程
API 立即返回 jobId。
后台 Worker 处理其余工作。
运营商响应并非总是即时。KOVITEL 将请求与运营商执行分离，让 API 保持快速，由 Worker 控制重试，你无需保持连接等待。
合作伙伴调用 API
分配 eSIM 或请求状态变更。API 完成鉴权、记录任务并立即返回 202 和 jobId。
Worker 接收任务
BullMQ 限制速率、在网络故障时重试，并避免对 Viettel 门户造成压力。
运营商执行
反向 API 调用 Viettel M2M；若门户不稳定，可切换到 Playwright RPA。
Webhook 与审计
结果写入数据库，使用 HMAC 签名，并通过 Webhook 推送到你的系统。
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"
}
}最多重试 3 次，采用指数退避。即使切换到 RPA，任务状态和审计记录也保持不变。
应用场景
一个数据池，适配多种设备。
从远程抄表到监控摄像头，统一的 eSIM 管理能力可减少人工操作并控制数据成本。
智能抄表
电表与水表
管理远程抄表设备，暂停欠费 SIM，并按数据池监控配额。
视频监控
摄像头与监控
安装时激活 SIM，按摄像头跟踪流量，设备退役时回收。
车队管理
物流与车联网
批量激活新设备，SIM 被停用时接收 Webhook，并查询近实时用量。
智慧农业
智慧农业
按季节在传感器站点间共享数据池，减少非种植期的流量浪费。
开发者体验
一个下午完成集成。
原生 REST、熟悉的 JSON、OpenAPI 文档和可运行示例。没有专有 SDK，也没有锁定。
按合作伙伴隔离的 API 密钥
使用 x-api-key 请求头鉴权，可随时轮换密钥。
异步任务
立即获得 jobId，然后轮询或等待 Webhook —— 按你的系统方式选择。
OpenAPI 3.1
完整契约，适用于 Postman、代码生成器和 API 参考。
带签名的 Webhook
HMAC-SHA256、投递日志、重试和控制台内测试按钮。
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" }基础 URL
/api/v1
鉴权
x-api-key
速率限制
5 req/s
价格
从小规模开始，随设备规模扩展。
平台费用按数据池规模和活跃 eSIM 数量计算。Viettel 通信费用根据 M2M 合同单独报价。
价格不含增值税和运营商费用。沙盒不会向核心网发送真实指令。生产 SLA 和配额以合同为准。
常见问题
开始之前。
技术和运营团队在将物联网 eSIM 投入生产前最常问的问题。
没有找到答案？ 发送问题
KOVITEL IoT 是什么？
一层中间件，将企业的设备管理平台连接到 Viettel M2M 网络。团队无需在 Viettel 门户手动操作，而是通过 REST API、控制台和 Webhook 管理数据池，并激活、暂停或回收 eSIM。
我需要与 Viettel 单独签约吗？
需要。KOVITEL 提供集成和运营层，数据、号码和资费遵循企业与 Viettel 签订的 M2M 合同。KOVITEL 会协助完成入驻和对接。
合作伙伴审核需要多久？
新账号初始状态为 PENDING，可立即登录查看控制台和文档。KOVITEL 会核实需求、合同和数据池配置后激活 API 密钥，通常在资料齐全后 1 个工作日内完成。
有沙盒环境吗？
有。沙盒提供测试数据池、演示 eSIM 和全部接口，可验证分配、状态变更、批量任务、任务轮询和 Webhook。沙盒不会向核心网发送真实指令。
操作是同步还是异步？
状态变更通过 BullMQ 在后台执行。API 立即返回 jobId，随后可轮询 GET /jobs/{jobId} 或在任务完成时接收 Webhook。这样可以避免超时并保护 Viettel 门户。
Webhook 安全吗？
每次投递都使用时间戳和原始请求体进行 HMAC-SHA256 签名，并通过 x-kovitel-signature 请求头传递。系统采用指数退避重试，并保存投递日志用于核对。
有请求限制吗？
默认每个 Worker 对 Viettel 的请求限制为每秒 5 次，以遵守运营商限制。合作伙伴 API 有独立速率限制，可按合同调整。批量请求最多支持 500 个 ICCID。
我的数据存储在哪里？
运营元数据（客户、数据池、SIM、任务、Webhook 投递）存储在 PostgreSQL；会话和队列存储在 Redis。KOVITEL 不存储设备流量内容。详细信息见数据处理协议。
从沙盒开始
无需等待基础设施，即可将物联网 eSIM 投入运营。
创建合作伙伴账号，获取 API 密钥并在沙盒中测试完整流程。KOVITEL 将从集成设计到生产数据池全程支持。