01 / BOT API
机器人 API
通过 Bot Token 收发消息、管理命令,并用 Webhook 或轮询接收事件。
- Webhook / getUpdates
- Node.js / Java SDK
- 投递日志与重试
49热聊 · 开放平台
用统一账号和 API 接入机器人与联享券。控制台负责配置,SDK 负责交付。
const response = await fetch(
`${API}/api/v1/open-platform/vouchers/issue`,
{
method: 'POST',
headers: {
Authorization: `Bearer ${APP_TOKEN}`,
'Idempotency-Key': orderId,
'Content-Type': 'application/json',
},
body: JSON.stringify({
template_id: templateId,
external_issue_id: orderId,
recipient_user_id: customerId,
}),
},
)
const voucher = await response.json()同一个幂等键不会重复发券。
开放能力
按业务选择能力,不强制绑定其他产品。凭证、配置与运行状态统一在开发者控制台管理。
01 / BOT API
通过 Bot Token 收发消息、管理命令,并用 Webhook 或轮询接收事件。
02 / VOUCHERS
创建开放应用并通过 sop_ Token 发放、验券、核销和冲正。
查看接入指南 →VOUCHER API
开放平台提供模板审核、券状态、幂等处理和核销接口。开发者决定发给谁、兑换什么,以及如何完成线下或线上履约。
填写券名称、权益说明、有效期和使用规则。
审核通过后,模板才能用于正式发券。
通过用户 ID 指定接收人,平台生成券码和二维码凭证。
服务端先查询状态,再核销;误操作可按权限冲正。
接入流程
使用 IM 账号登录控制台,按业务创建机器人或开放应用。
消息使用 sbot_,联享券使用 sop_;凭证只保存在可信服务端。
接入消息或联享券;两项能力可以独立使用。
通过投递日志和接口返回定位问题,再切换到正式流量。