给 Agent 读的原文

# 玲声开放平台 · 给 Agent 的接入说明

你正在帮一位用户接入玲声开放平台：它让 Agent 能**替人打电话**，按分钟计费，每通一行账单。
按下面的顺序做，每做完一步用一句话告诉用户结果。

## 1. 拿到令牌

先问用户要他的令牌（以 `lsk_` 开头）。提醒他：令牌只发给你，别贴到公开的地方。

令牌是一把只能碰你自己账号的钥匙：改你的人设、拨你验证过的号、查你自己的账单，碰不到别人的。撤销之后原来那把立刻失效。

用户还没有令牌，就带他走这三步：

1. **先开一个试用账号**：去后台登录页点「微信扫码登录」，扫一下就开好；或者打我们那个号码，在电话里说一声也行。两条都不填表、不等审批。注意：网页上「配一下让它打给你」那一级不注册账号，走完只会接到一通电话，没有账号，也就没有令牌。
2. **进后台顶栏的「接入令牌」**：它是顶栏那一排上的一格，不在「设置」底下 —— 那个前缀是平台运维区，普通账号进不去。找到它，点「建一把」。
3. **明文只显示一次，当场存好**：那串明文只在建出来的那一次回给你，我们不留第二份。丢了就撤掉这一把、重新建一把。

## 2. 连上 MCP

- 地址：https://aicall.lingshengai.com/api/mcp
- 认证：请求头 `Authorization: Bearer <令牌>`
- 你的客户端支持远程 MCP 服务器就直接添加。命令行示例：

```bash
claude mcp add --transport http lingsheng https://aicall.lingshengai.com/api/mcp \
  --header "Authorization: Bearer lsk_你的令牌"
```

## 3. 拨一通试试

1. 问清这一通要办什么事、开场说什么。
2. 拨一通到用户**自己验证过的手机号**，让他听一下效果。
3. 告诉他在哪里看这一通的时长、费用、摘要和录音。

## 先告诉用户的边界

- 缺省只能拨你自己验证过的号码。要拨别的号码得我们这边先审，审的是用途。
- 夜里不拨。同一个号码一天之内不重复骚扰，每天有条数上限。
- 额度用完就拨不出去了，接口会直说，不会静悄悄失败。
- 回调只往 https 的公网地址推；内网地址、回环地址建不出来。

## 不用 MCP，直接调 REST

接口地址：https://aicall.lingshengai.com，认证同上。

### 拨一通

```bash
curl -X POST https://aicall.lingshengai.com/api/v1/calls \
  -H "Authorization: Bearer lsk_你的令牌" \
  -H "Content-Type: application/json" \
  -d '{
        "to": "13800000000",
        "instructions": "提醒对方今晚八点吃药，确认一声就挂",
        "greeting": "您好，是张先生吗？"
      }'
```

回来的 callId 拿去查这一通：GET /api/v1/calls/{callId}。

### 登记一个回调地址

```bash
curl -X POST https://aicall.lingshengai.com/api/v1/webhooks \
  -H "Authorization: Bearer lsk_你的令牌" \
  -H "Content-Type: application/json" \
  -d '{
        "url": "https://你的域名/hooks/lingsheng",
        "events": ["call.ended"]
      }'
```

回来的 secret 用来验签：X-Lingsheng-Signature 是 sha256=<hex>，hex 是用 secret 对「X-Lingsheng-Timestamp 的值 + . + 原始 body」算的 HMAC-SHA256。摘要有时比挂机晚一点 —— 那一条会先带 pending，就绪后再推一条。

### 看用了多少

```bash
curl https://aicall.lingshengai.com/api/v1/usage \
  -H "Authorization: Bearer lsk_你的令牌"
```

每个接口的字段说明：https://lingshengai.com/developers/docs/rest；回调的推送格式与验签：https://lingshengai.com/developers/docs/webhook

## 价格

没有月费，送 30 分钟；之后 ¥0.49/分钟，不足一分钟按一分钟。

## 更多

给人看的完整文档：https://lingshengai.com/developers/docs
所有文档的纯文本目录：https://lingshengai.com/llms.txt