从这里开始
你的第一个要求,分四步走
连接电话并启用呼叫同步.
从仪表盘复制API密钥.
呼叫缺失或即将到来的列表终点 。
标有限制并抵消和存储时间戳在协调世界时.
此 API 的 WEBHOOK V2
仅订阅您的工作流所需的移动事件。
一个目标可以接收全部事件,或者您可以将生产系统、分析和运维告警分开。每个事件都有精确的名称,使您的应用能够可预测地处理它们。
call.missed未接来电
已从已连接的手机同步了一个未接来电。
call.incoming来电
已从已连接的手机同步了一个来电。
call.outgoing呼出通话
已从已连接的手机同步了一个呼出通话。
验证
在服务器上保存证书
调用端点使用 apikey 查询参数. API在返回呼叫活动之前验证密钥和主动订阅.
- 背景操作系统限制可以将移动调用同步延迟数分钟. 打开应用程序以请求在测试时手动同步.
历史管理
安全清除历史: 预览、 删除、 跟踪进度
这些端点清除您所选服务器历史 API 键,而不是电话或外部服务中的信息。 它们不能提供账号的去除。 新的活性可以在删除后出现.
读取 request_id 和重试指南
默认情况下,链接或处理记录仍然可见. 只使用 include_linked=1 或正在处理的软件。
怎样 request_id 工作内容
- 预览计数方式 action=preview。无 request_id 需要删除任何记录。
- 生成一个独特的 request_id 用于删除新内容,例如a UUID。发送前保存它 action=delete. . . . . . . . . . . .
- 重复、超时或 HTTP 202,再利用相同 API 键,历史终点, request_id 财务报告和已审计财务报表 include_linked 值。 错误发生后, 绝不自动生成新的 ID 。
- 何时 completed=true,操作结束。 重用其ID返回的相同结果,而不是删除新到的记录. 仅为有意进行新清理而使用新ID.
request_id 识别您的删除操作, 而不是个人 SMS允许的格式:16-128 ASCII 字母、数字、连字符或下划线。 A. 国家 UUID 用 Crypto.randomUUID () 生成是合适的。
删除按批次执行。如果返回 HTTP 202 且 continue_required=true,请在 3 秒后再次请求 action=delete。没有后台 cron 任务。action=status 只读取进度,不会继续删除,即使返回 HTTP 200 也是如此。
删除和查询状态的示例
替换样本 request_id 开始前,有你独特的价值。 以下删除请求更改真实账户历史; 它们不是预览 。
curl -X POST "https://api.smsmobileapi.com/delete-history-calls-missed/" \
--data-urlencode "apikey=YOUR_API_KEY" \
-d "action=delete" -d "include_linked=0" \
-d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"curl -X POST "https://api.smsmobileapi.com/delete-history-calls-missed/" \
-H "Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN" \
-d "action=delete" -d "include_linked=0" \
-d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"curl -G "https://api.smsmobileapi.com/delete-history-calls-missed/" \
--data-urlencode "apikey=YOUR_API_KEY" \
-d "action=status" \
-d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"GET 也接受 action=preview 或 或 双 action=delete. . . . . . . . . . . . POST 建议: URL参数可以被泄露到浏览器历史和服务器日志中. 永远不要将删除的 URL 放在公共链接, 图像或预选中 。
用于 POST,以窗体或一个格式发送所有参数 JSON 对象,从查询字符串中选择。 未知参数被拒绝;日期或移动过滤器不支持.
历史记录接口的身份验证
使用 apikey 或 一种 Authorization: 调取 Bearer 由 SMSMobileAPI OAuth2。不要发送刷新符号或 API 键为 a Bearer 符号。 过期的代币被拒绝.
瞄准镜设定完毕后 history:read 允许预览/状态和 history:delete 也允许删除。 对象征和 OAuth 客户端申请。 遗物无范围可查保留其现有的账户访问权.
OAuth2 选择唯一的主机 API 键。 如果存在几个主密钥,则还提供 apikey 以选择账户所属的账户。 次要钥匙从来不允许访问主要钥匙历史。
继续操作之前请先检查响应
count_delete 是该操作所删除的累积数。 selected_at_start 是初始选择; protected_at_start 记录不计在内。 使用 preview.linked_or_processing 以计算链接记录,即使 include_linked=1. . . . . . . . . . . .
{
"result": {
"error": 0,
"history": "calls-missed",
"action": "delete",
"request_id": "6d54ac58-41f1-4fbc-9a39-6e6c86089451",
"status": "processing",
"completed": false,
"count_delete": 100,
"total_before": 250,
"selected_at_start": 200,
"protected_at_start": 50,
"include_linked": 0,
"continue_required": true,
"message": "Repeat GET or POST with the same request_id and include_linked to continue. Status requests do not run deletion."
}
}- 200 与 . completed=true: 完成( 完成) 。 仅200个预览或状态回复并不能证明完成 。
- 400,000 个 INVALID_REQUEST_ID:检查格式。 404 (中文(简体) ). REQUEST_NOT_FOUND: 没有为此ID操作, API 键和历史。
- 401: 证书无效或过期. 403: 不足 OAuth 范围或未经授权的账户。
- 409 (中文(简体) ). HISTORY_BUSY: 正在运行另一个清理; 从原客户端继续. 409 (中文(简体) ). INCLUDE_LINKED_CONFLICT: 恢复原样 include_linked 值。
- 409 (中文(简体) ). OAUTH_ACCOUNT_AMBIGUOUS: 提供 API 属于此账户的密钥。
- 503或网络中断:一些批次可能已经完成. 检查配置, 然后用原版重试 request_id中,不自动创建替换操作。
得到
列出未拨打的电话
https://api.smsmobileapi.com/call/missed/list/返回时没有接到最新到最老的电话。
使用它来触发回调工作流程和失联呼叫警报.
参数
| 姓名 | 类型 | 所需经费 | 描述 |
|---|---|---|---|
apikey |
细绳 | 必需的 | 您的 API 密钥。 |
offset |
整数 | 可选 | 平分相冲; 默认为 0. |
limit |
整数 | 可选 | 每个请求行;默认为100行,最高为500行. |
search |
细绳 | 可选 | 搜索呼叫器号码或缓存名称 。 |
date_start |
年-月-月-月 | 可选 | 包括从今天00: 00打电话来 |
date_end |
年-月-月-月 | 可选 | 包括电话,直到23:59:59,59在这一天。 |
请求示例
curl "https://api.smsmobileapi.com/call/missed/list/?apikey=YOUR_API_KEY&offset=0&limit=100"
示例回复
{
"success": true,
"offset": 0,
"limit": 100,
"count": 1,
"data": [{"number": "+15551230001", "name": "Alex Carter", "date": "2026-03-20 16:12:28"}]
}
想听这个请求吗?连接页面上方的 API 键以解锁交互式测试器 。
连接密钥 QQ
得到
列出接获的电话
https://api.smsmobileapi.com/call/incoming/list/返回答复了接收到的电话,并附有时间戳和缓存联系方式。
用于呼叫报告,客户关系管理历史和客户服务计量.
参数
| 姓名 | 类型 | 所需经费 | 描述 |
|---|---|---|---|
apikey |
细绳 | 必需的 | 您的 API 密钥。 |
limit |
整数 | 可选 | 默认50,最高200。 |
offset |
整数 | 可选 | 平分处: |
sort_by |
语句 | 可选 | 电话: date ms, call datetime utc, view sec, 电话: 号码: 创建: at, 缓存: 名称: 或地理: 位置: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: |
sort_dir |
国家 | 可选 | 默认 desc. |
date_from_ms |
离子毫秒( 秒) | 可选 | 最低调用时间戳。 |
date_to_ms |
离子毫秒( 秒) | 可选 | 最大呼叫时间戳。 |
q |
细绳 | 可选 | 搜索电话号码或缓存名称. |
请求示例
curl "https://api.smsmobileapi.com/call/incoming/list/?apikey=YOUR_API_KEY&limit=50&sort_by=call_date_ms&sort_dir=desc"
示例回复
{
"success": true,
"count": 1,
"rows": [{
"phone_number": "+15551230010",
"cached_name": "Jordan Blake",
"call_date_ms": 1774027779390,
"call_datetime_utc": "2026-03-20 17:29:39",
"duration_sec": 23,
"geo_location": "Canada"
}]
}
想听这个请求吗?连接页面上方的 API 键以解锁交互式测试器 。
连接密钥 QQ
得到
列出已发送的呼叫
https://api.smsmobileapi.com/call/outgoing/list/从连接设备中调回电话 。
使用它来完成调用时间和分析出站活动.
参数
| 姓名 | 类型 | 所需经费 | 描述 |
|---|---|---|---|
apikey |
细绳 | 必需的 | 您的 API 密钥。 |
limit |
整数 | 可选 | 默认50,最高200。 |
offset |
整数 | 可选 | 平分处: |
sort_by |
语句 | 可选 | 电话: date ms, call datetime utc, view sec, 电话: 号码: 创建: at, 缓存: 名称: 或地理: 位置: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: 名称: |
sort_dir |
国家 | 可选 | 默认 desc. |
date_from_ms |
离子毫秒( 秒) | 可选 | 最低调用时间戳。 |
date_to_ms |
离子毫秒( 秒) | 可选 | 最大呼叫时间戳。 |
q |
细绳 | 可选 | 搜索电话号码或缓存名称. |
请求示例
curl "https://api.smsmobileapi.com/call/outgoing/list/?apikey=YOUR_API_KEY&limit=50&offset=0&sort_by=call_date_ms&sort_dir=desc"
示例回复
{
"success": true,
"count": 1,
"rows": [{
"phone_number": "+15551230020",
"cached_name": "Casey Morgan",
"call_date_ms": 1774025965645,
"call_datetime_utc": "2026-03-20 16:59:25",
"duration_sec": 61,
"geo_location": "Canada"
}]
}
想听这个请求吗?连接页面上方的 API 键以解锁交互式测试器 。
连接密钥 QQ
后 获得
清空未接来电记录
https://api.smsmobileapi.com/delete-history-calls-missed/清除账户历史中遗漏的通话记录,而不是电话中的通话日志.
首先使用预览,检查计数,然后明确请求删除. 清除了全部选取的历史 API 键,没有日期、电话或信件过滤器。
参数
| 姓名 | 类型 | 所需经费 | 描述 |
|---|---|---|---|
apikey |
细绳 | 可选 | 需要时无需 OAuth2与 OAuth2,可选择选择 API 属于同一账户的密钥。 |
action |
预览 QQ 删除 QQ 状态 | 可选 | preview 只统计而不删除;delete 启动或继续删除;status 只查看进度。API 默认使用 delete,此测试工具默认使用 preview。 |
include_linked |
0 | 1 | 可选 | 默认 0: 保留链接或处理记录. 设定1以包含,有破坏整合的风险. 继续删除时保持此值不变 。 |
request_id |
细绳 | 可选 | delete 和 status 必须提供,preview 可不提供。使用 16–128 个 ASCII 字母、数字、连字符 (-) 或下划线 (_)。每次新的删除操作生成一个唯一 ID,并在所有重试中保留同一个 ID。它不是消息 ID,也不是 API 密钥。 |
请求示例
curl -X POST "https://api.smsmobileapi.com/delete-history-calls-missed/" \
--data-urlencode "apikey=YOUR_API_KEY" \
-d "action=preview" -d "include_linked=0"
删除和查询状态的示例
替换样本 request_id 开始前,有你独特的价值。 以下删除请求更改真实账户历史; 它们不是预览 。
curl -X POST "https://api.smsmobileapi.com/delete-history-calls-missed/" \
--data-urlencode "apikey=YOUR_API_KEY" \
-d "action=delete" -d "include_linked=0" \
-d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"curl -X POST "https://api.smsmobileapi.com/delete-history-calls-missed/" \
-H "Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN" \
-d "action=delete" -d "include_linked=0" \
-d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"curl -G "https://api.smsmobileapi.com/delete-history-calls-missed/" \
--data-urlencode "apikey=YOUR_API_KEY" \
-d "action=status" \
-d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"示例回复
{
"result": {
"error": 0,
"history": "calls-missed",
"action": "preview",
"total": 120,
"simple": 100,
"linked_or_processing": 20,
"selected": 100,
"include_linked": 0,
"operation_in_progress": false,
"active_include_linked": null
}
}
想听这个请求吗?连接页面上方的 API 键以解锁交互式测试器 。
连接密钥 QQ- 以上示例为预览,而非删除. 计数是说明;删除开始时确定选择。
- include_linked=1 可能破坏 GHL, , , , , , , , Zapier,自动化,不订阅链接或发送跟踪. 它从不绕过账户所有权或存储完整性检查.
后 获得
清空呼入通话记录
https://api.smsmobileapi.com/delete-history-calls-incoming/清除账户历史中收到的通话记录,而不是电话中的通话日志.
首先使用预览,检查计数,然后明确请求删除. 清除了全部选取的历史 API 键,没有日期、电话或信件过滤器。
参数
| 姓名 | 类型 | 所需经费 | 描述 |
|---|---|---|---|
apikey |
细绳 | 可选 | 需要时无需 OAuth2与 OAuth2,可选择选择 API 属于同一账户的密钥。 |
action |
预览 QQ 删除 QQ 状态 | 可选 | preview 只统计而不删除;delete 启动或继续删除;status 只查看进度。API 默认使用 delete,此测试工具默认使用 preview。 |
include_linked |
0 | 1 | 可选 | 默认 0: 保留链接或处理记录. 设定1以包含,有破坏整合的风险. 继续删除时保持此值不变 。 |
request_id |
细绳 | 可选 | delete 和 status 必须提供,preview 可不提供。使用 16–128 个 ASCII 字母、数字、连字符 (-) 或下划线 (_)。每次新的删除操作生成一个唯一 ID,并在所有重试中保留同一个 ID。它不是消息 ID,也不是 API 密钥。 |
请求示例
curl -X POST "https://api.smsmobileapi.com/delete-history-calls-incoming/" \
--data-urlencode "apikey=YOUR_API_KEY" \
-d "action=preview" -d "include_linked=0"
删除和查询状态的示例
替换样本 request_id 开始前,有你独特的价值。 以下删除请求更改真实账户历史; 它们不是预览 。
curl -X POST "https://api.smsmobileapi.com/delete-history-calls-incoming/" \
--data-urlencode "apikey=YOUR_API_KEY" \
-d "action=delete" -d "include_linked=0" \
-d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"curl -X POST "https://api.smsmobileapi.com/delete-history-calls-incoming/" \
-H "Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN" \
-d "action=delete" -d "include_linked=0" \
-d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"curl -G "https://api.smsmobileapi.com/delete-history-calls-incoming/" \
--data-urlencode "apikey=YOUR_API_KEY" \
-d "action=status" \
-d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"示例回复
{
"result": {
"error": 0,
"history": "calls-incoming",
"action": "preview",
"total": 120,
"simple": 100,
"linked_or_processing": 20,
"selected": 100,
"include_linked": 0,
"operation_in_progress": false,
"active_include_linked": null
}
}
想听这个请求吗?连接页面上方的 API 键以解锁交互式测试器 。
连接密钥 QQ- 以上示例为预览,而非删除. 计数是说明;删除开始时确定选择。
- include_linked=1 可能破坏 GHL, , , , , , , , Zapier,自动化,不订阅链接或发送跟踪. 它从不绕过账户所有权或存储完整性检查.
后 获得
清空呼出通话记录
https://api.smsmobileapi.com/delete-history-calls-outgoing/清除账户历史中即将发送的通话记录,而不是电话中的通话日志.
首先使用预览,检查计数,然后明确请求删除. 清除了全部选取的历史 API 键,没有日期、电话或信件过滤器。
参数
| 姓名 | 类型 | 所需经费 | 描述 |
|---|---|---|---|
apikey |
细绳 | 可选 | 需要时无需 OAuth2与 OAuth2,可选择选择 API 属于同一账户的密钥。 |
action |
预览 QQ 删除 QQ 状态 | 可选 | preview 只统计而不删除;delete 启动或继续删除;status 只查看进度。API 默认使用 delete,此测试工具默认使用 preview。 |
include_linked |
0 | 1 | 可选 | 默认 0: 保留链接或处理记录. 设定1以包含,有破坏整合的风险. 继续删除时保持此值不变 。 |
request_id |
细绳 | 可选 | delete 和 status 必须提供,preview 可不提供。使用 16–128 个 ASCII 字母、数字、连字符 (-) 或下划线 (_)。每次新的删除操作生成一个唯一 ID,并在所有重试中保留同一个 ID。它不是消息 ID,也不是 API 密钥。 |
请求示例
curl -X POST "https://api.smsmobileapi.com/delete-history-calls-outgoing/" \
--data-urlencode "apikey=YOUR_API_KEY" \
-d "action=preview" -d "include_linked=0"
删除和查询状态的示例
替换样本 request_id 开始前,有你独特的价值。 以下删除请求更改真实账户历史; 它们不是预览 。
curl -X POST "https://api.smsmobileapi.com/delete-history-calls-outgoing/" \
--data-urlencode "apikey=YOUR_API_KEY" \
-d "action=delete" -d "include_linked=0" \
-d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"curl -X POST "https://api.smsmobileapi.com/delete-history-calls-outgoing/" \
-H "Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN" \
-d "action=delete" -d "include_linked=0" \
-d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"curl -G "https://api.smsmobileapi.com/delete-history-calls-outgoing/" \
--data-urlencode "apikey=YOUR_API_KEY" \
-d "action=status" \
-d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"示例回复
{
"result": {
"error": 0,
"history": "calls-outgoing",
"action": "preview",
"total": 120,
"simple": 100,
"linked_or_processing": 20,
"selected": 100,
"include_linked": 0,
"operation_in_progress": false,
"active_include_linked": null
}
}
想听这个请求吗?连接页面上方的 API 键以解锁交互式测试器 。
连接密钥 QQ- 以上示例为预览,而非删除. 计数是说明;删除开始时确定选择。
- include_linked=1 可能破坏 GHL, , , , , , , , Zapier,自动化,不订阅链接或发送跟踪. 它从不绕过账户所有权或存储完整性检查.
后 获得
清空规则执行记录
https://api.smsmobileapi.com/delete-history-call-rules/清除系统只使用自动化执行记录。 规则本身不作删除。
首先使用预览,检查计数,然后明确请求删除. 清除了全部选取的历史 API 键,没有日期、电话或信件过滤器。
参数
| 姓名 | 类型 | 所需经费 | 描述 |
|---|---|---|---|
apikey |
细绳 | 可选 | 需要时无需 OAuth2与 OAuth2,可选择选择 API 属于同一账户的密钥。 |
action |
预览 QQ 删除 QQ 状态 | 可选 | preview 只统计而不删除;delete 启动或继续删除;status 只查看进度。API 默认使用 delete,此测试工具默认使用 preview。 |
include_linked |
0 | 1 | 可选 | 默认 0: 保留链接或处理记录. 设定1以包含,有破坏整合的风险. 继续删除时保持此值不变 。 |
request_id |
细绳 | 可选 | delete 和 status 必须提供,preview 可不提供。使用 16–128 个 ASCII 字母、数字、连字符 (-) 或下划线 (_)。每次新的删除操作生成一个唯一 ID,并在所有重试中保留同一个 ID。它不是消息 ID,也不是 API 密钥。 |
请求示例
curl -X POST "https://api.smsmobileapi.com/delete-history-call-rules/" \
--data-urlencode "apikey=YOUR_API_KEY" \
-d "action=preview" -d "include_linked=0"
删除和查询状态的示例
替换样本 request_id 开始前,有你独特的价值。 以下删除请求更改真实账户历史; 它们不是预览 。
curl -X POST "https://api.smsmobileapi.com/delete-history-call-rules/" \
--data-urlencode "apikey=YOUR_API_KEY" \
-d "action=delete" -d "include_linked=0" \
-d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"curl -X POST "https://api.smsmobileapi.com/delete-history-call-rules/" \
-H "Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN" \
-d "action=delete" -d "include_linked=0" \
-d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"curl -G "https://api.smsmobileapi.com/delete-history-call-rules/" \
--data-urlencode "apikey=YOUR_API_KEY" \
-d "action=status" \
-d "request_id=6d54ac58-41f1-4fbc-9a39-6e6c86089451"示例回复
{
"result": {
"error": 0,
"history": "call-rules",
"action": "preview",
"total": 120,
"simple": 100,
"linked_or_processing": 20,
"selected": 100,
"include_linked": 0,
"operation_in_progress": false,
"active_include_linked": null
}
}
想听这个请求吗?连接页面上方的 API 键以解锁交互式测试器 。
连接密钥 QQ- 以上示例为预览,而非删除. 计数是说明;删除开始时确定选择。
- include_linked=1 可能破坏 GHL, , , , , , , , Zapier,自动化,不订阅链接或发送跟踪. 它从不绕过账户所有权或存储完整性检查.
故障排除
错误和安全的重试
在重试前读取 HTTP 状态和 JSON 错误字段 。 不先更正请求, 不重试验证或认证失败 。
| HTTP | 代码 | 怎么办 |
|---|---|---|
| 400 | missing_apikey | 缺少或空出 apikey 参数 。 |
| 403 | invalid_apikey | 关键不为所认. |
| 403 | api_expired | 与密钥相链接的订阅已过期 。 |
| 500 | server_error | 呼叫服务无法完成请求。 |
需要帮助吗?
带上请求的背景 而不是你的秘密
共享端点,时间戳,HTTP状态和消毒响应. 永远不要包括API密钥,指使或私人消息内容.


