## 文档基础信息
- 接口类型：国际语音客户回访接口
- 参考融合源：国内语音通知接口、国际短信接口文档
- 编码统一：UTF-8
- 请求方式：GET / POST 均支持，7×24小时全天候提交

## 一、接口描述
本接口为**国际语音客户回访接口**，用于向全球境外手机、固话号码发起语音回访呼叫，支持IVR按键交互能力，可自动采集用户满意度按键数据并异步回传，广泛适用于国际订单售后回访、服务质量调研、用户身份核验、业务通知确认等场景，帮助企业实现国际客户回访全流程自动化。

接口核心能力：
- 双鉴权模式：支持固定APIKEY鉴权、动态MD5密码鉴权，适配不同安全等级的对接需求
- 单号码提交：单次请求仅支持提交1个境外号码，支持批量串行发起呼叫
- 多格式适配：响应同时兼容JSON / XML两种格式，自动匹配请求接收类型
- 灵活话术配置：支持完整文本播报与模板变量两种模式，动态替换回访内容
- 按键数据回传：带交互的回访模板支持用户按键采集，结果通过回调异步推送，可直接对接企业内部CRM、客服系统

## 二、接入前准备
1. **账号与权限开通**
 使用国际语音客户回访接口需先开通对应服务权限，未注册用户可通过[官方注册链接]完成账号注册，提交企业资质后申请开通国际语音通知业务。
2. **获取API鉴权凭证**
 登录商户后台，进入【云语音】-【国际语音通知】-【产品总览】页面，获取APIID（对应接口account参数）与APIKEY（固定鉴权密码）。
3. **IP白名单配置**
 在产品总览页面添加服务器出口IP至白名单，未备案的IP请求将被拦截，返回400非法IP访问错误。
4. **回访模板报备**
 带按键交互的满意度回访话术需提前在后台提交模板报备，审核通过后获取对应templateid，即可调用接口发起带按键采集的回访呼叫。

## 三、请求头说明
| 参数名称 | 参数固定值 | 类型 | 必填 |
| ---- | ---- | ---- | ---- |
| Content-Type | application/x-www-form-urlencoded | string | 是 |

## 四、请求参数说明
| 参数名称 | 参数说明 | 示例 | 类型 | 必填 |
| ---- | ---- | ---- | ---- | ---- |
| account | APIID 获取路径：用户中心【云语音】-【国际语音通知】-【产品总览】 | 12345678 | string | 是 |
| password | 鉴权密码二选一： 1. 固定鉴权：APIKEY（产品总览查看） 2. 动态鉴权：MD5加密动态密码（文末提供加密代码） | abcdef123456 | string | 是 |
| mobile | 国际接收号码，单次仅传1个；格式规范：国家区号+空格+手机号 港澳台/国际固话同理：区号空格号码 | 1 978234523 852 61234567 | string | 是 |
| content | 语音回访播报内容，两种使用模式： 1. 完整播报模式：直接填写完整回访话术文本 2. 模板变量模式：多变量使用英文竖线 `\|` 分隔 | 您好，本次国际订单已签收，满意请按1，不满意请按2 HK20260731\|顺丰国际\|180美元 | string | 否 |
| templateid | 国际语音回访模板ID，使用模板变量播报或带按键交互时必填 调试测试模板ID：2361 默认测试模板内容：您的国际订单号：【变量】，承运商：【变量】，金额：【变量】，请注意接听 | 2361 | int | 否 |
| time | 10位Unix时间戳 仅使用**动态密码鉴权**时必填 | 1754064000 | string | 动态鉴权必填 |

## 五、响应返回参数
| 参数名称 | 参数说明 | 成功示例 | 类型 | 是否必返回 |
| ---- | ---- | ---- | ---- | ---- |
| code | 业务状态码，2=提交成功 | 2 / 1 | int | 是 |
| msg | 提交结果文字描述 | 提交成功 / 手机号格式错误 | string | 是 |
| ivmid | 语音呼叫唯一流水号，可用于后续匹配按键回传数据；失败返回0或空字符串 | 17540640009876 | string | 提交成功返回 |

## 六、响应状态码对照表
| code | msg 提示 | 问题说明 |
| ---- | ---- | ---- |
| 0 | 提交失败 | 通用未知提交异常 |
| 2 | 提交成功 | 呼叫任务已受理排队 |
| 400 | 非法ip访问 | 服务器出口IP未备案/未添加白名单 |
| 401 | 帐号不能为空 | account参数缺失 |
| 402 | 密码不能为空 | password参数缺失 |
| 403 | 手机号码不能为空 | mobile参数为空 |
| 4030 | 手机号码已被列入黑名单 | 该境外号码限制外呼 |
| 404 | 语音内容不能为空 | 未传content且未传合法templateid |
| 405 | 用户名或密码不正确 | account/APIKEY不匹配 |
| 4050 | 账号被冻结 | 账户欠费/违规冻结，联系客服 |
| 40505 | 没有签定合同 | 未开通国际语音业务权限 |
| 4051 | 剩余条数不足 | 国际语音余额不足 |
| 4052 | 访问 ip 与备案 ip 不符 | 服务器出口IP和后台备案不一致 |
| 406 | 手机格式不正确 | 境外号码缺少国家区号、格式不规范 |
| 407 | 语音内容含有敏感字符 | 播报文本包含违规敏感词 |
| 4071 | 没有提交备案模板 | 使用templateid但模板未报备审核 |
| 4072 | 提交的语音内容必须与报备过的模板格式相匹配 | 传入变量数量与备案模板变量数量不一致 |
| 40722 | 变量内容超过指定的长度 | 单个变量文本超出模板限制字数 |
| 4077 | 播报内容未在运营商报备 | 完整文本播报模式未提前报备文案 |
| 408 | 您的帐户疑被恶意利用，已被自动冻结，如有疑问请与客服联系。 | 风控检测异常自动冻结账号 |
| 4080 | 同一手机号码同一秒钟之内发送频率不能超过1条 | 单号码每秒呼叫上限1次 |
| 4081 | 同一手机号一分钟之内发送超过3条 | 单号码每分钟呼叫上限3次 |
| 4082 | 超出同一手机号一天之内10条语音限制 | 单号码单日最大呼叫10次 |
| 4086 | 提交失败 | 接口服务内部异常，稍后重试 |

## 七、GET 请求完整调用示例
### 完整话术回访示例
```
https://api.ihuyi.com/ivm/Submit.json?account=12345678&password=abcdef123456&mobile=1 978234523&content=您好，本次国际订单已签收，服务满意请按1，一般请按2，不满意请按3
```

### 模板变量模式GET示例
```
https://api.ihuyi.com/ivm/Submit.json?account=12345678&password=abcdef123456&mobile=852 61234567&templateid=2361&content=HK20260731|顺丰国际|180美元
```

### 动态密码鉴权GET示例（带time时间戳）
```
https://api.ihuyi.com/ivm/Submit.json?account=12345678&password=md5加密后字符串&mobile=1 978234523&templateid=2361&content=HK20260731|顺丰国际|180美元&time=1754064000
```

## 八、接口返回响应示例
### 1. 成功返回 JSON
```json
{
 "code": 2,
 "msg": "提交成功",
 "ivmid": "17540640009876"
}
```

### 2. 成功返回 XML
```xml
<?xml version="1.0" encoding="utf-8"?>
<SubmitResult>
 <code>2</code>
 <msg>提交成功</msg>
 <ivmid>17540640009876</ivmid>
</SubmitResult>
```

### 3. 失败返回 JSON
```json
{
 "code": 406,
 "msg": "手机格式不正确"
}
```

### 4. 失败返回 XML
```xml
<?xml version="1.0" encoding="utf-8"?>
<SubmitResult>
 <code>406</code>
 <msg>手机格式不正确</msg>
</SubmitResult>
```

## 九、PHP 动态密码 MD5 加密代码示例
动态密码加密规则：`md5(account + 原始APIKEY + mobile + content + time)`
所有拼接内容必须统一 UTF-8 编码后加密，适用于国际语音客户回访接口高安全级别的鉴权场景。
```php
<?php
$account = '12345678';
$apikey = 'abcdef123456';
$mobile = '1 978234523';
$content = 'HK20260731|顺丰国际|180美元';
$time = '1754064000';

// 拼接明文
$originStr = $account . $apikey . $mobile . $content . $time;
// 生成动态密码
$password = md5($originStr);

// 最终请求参数 $password 传入加密后字符串
?>
```

## 十、满意度按键回传回调说明
使用带按键交互的回访模板时，用户按键结果与呼叫状态将通过商户后台配置的回调地址异步推送，企业可通过回调接口自动采集满意度数据，实现回访数据闭环。

### 回调推送参数示例（JSON）
```json
{
 "ivmid": "17540640009876",
 "mobile": "1 978234523",
 "call_status": "已接听",
 "press_key": "1",
 "call_duration": "25",
 "call_time": "1754064010"
}
```

### 回调字段说明
- ivmid：呼叫唯一流水号，与提交接口返回的ivmid一一对应
- mobile：被叫号码
- call_status：呼叫状态（已接听、未接听、占线等）
- press_key：用户按键值，未按键则返回空
- call_duration：通话时长，单位秒
- call_time：呼叫发起时间戳

## 十一、多语言代码示例目录
- Java
- PHP
- Python
- C
- C++
- C#
- Go
- Shell
- Ruby
- Node.js
- Objective-C

本接口为国际语音客户回访接口，用于向全球境外手机、固话号码发起语音回访呼叫，支持IVR按键交互能力，可自动采集用户满意度按键数据并异步回传，广泛适用于国际订单售后回访、服务质量调研、用户身份核验、业务通知确认等场景，帮助企业实现国际客户回访全流程自动化。

国际语音客户回访接口自动化：通过API获取用户满意度按键回传数据

本接口为**国际语音客户回访接口**，用于向全球境外手机、固话号码发起语音回访呼叫，支持IVR按键交互能力，可自动采集用户满意度按键数据并异步回传，广泛适用于国际订单售后回访、服务质量调研、用户身份核验、业务通知确认等场景，帮助企业实现国际客户回访全流程自动化。

音视频

国际语音客户回访接口支持全球号码批量外呼，具备IVR按键满意度采集与异步回调能力，提供固定/动态MD5双鉴权，兼容JSON/XML格式，适用于售后回访、调研核验等场景，助力企业实现国际回访全流程自动化。

代码解释

Objective-C

服务器

短信

JSON

Unix

2026上云采购 | AI焕新·智启新局

国内短信特惠0.04元/条起，接入便捷，稳定可靠


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

国际语音客户回访接口自动化：通过API获取用户满意度按键回传数据-腾讯云开发者社区-腾讯云

国际语音客户回访接口自动化：通过API获取用户满意度按键回传数据

国际语音客户回访接口自动化：通过API获取用户满意度按键回传数据

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐