把消息能力接进你的产品

用统一账号和 API 接入机器人与联享券。控制台负责配置,SDK 负责交付。

鉴权
JWT / sbot_ / sop_
消息接收
Webhook / getUpdates
SDK
Node.js / Java
voucher.tsissueVoucher
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

机器人 API

通过 Bot Token 收发消息、管理命令,并用 Webhook 或轮询接收事件。

  • Webhook / getUpdates
  • Node.js / Java SDK
  • 投递日志与重试

02 / VOUCHERS

联享券

创建开放应用并通过 sop_ Token 发放、验券、核销和冲正。

查看接入指南 →

券由你发行,也由你履约

开放平台提供模板审核、券状态、幂等处理和核销接口。开发者决定发给谁、兑换什么,以及如何完成线下或线上履约。

能力边界平台不售券、不代收款,也不承诺开发者提供的商品或服务。
查看联享券指南
  1. 01

    创建模板

    填写券名称、权益说明、有效期和使用规则。

  2. 02

    提交审核

    审核通过后,模板才能用于正式发券。

  3. 03

    发放给用户

    通过用户 ID 指定接收人,平台生成券码和二维码凭证。

  4. 04

    验券与核销

    服务端先查询状态,再核销;误操作可按权限冲正。

从注册到上线,步骤清楚可追踪

  1. 01

    注册与创建

    使用 IM 账号登录控制台,按业务创建机器人或开放应用。

  2. 02

    保存凭证

    消息使用 sbot_,联享券使用 sop_;凭证只保存在可信服务端。

  3. 03

    选择能力

    接入消息或联享券;两项能力可以独立使用。

  4. 04

    联调与观察

    通过投递日志和接口返回定位问题,再切换到正式流量。

创建所需的开放能力

登录后可创建机器人或开放应用,并按业务场景选择对应能力。