这里会显示出您选择的修订版和当前版本之间的差别。
| 两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 | ||
|
zh:二次开发者指南:如何使用第三方短信平台发送短信 [2013/07/01 04:51] menglj |
zh:二次开发者指南:如何使用第三方短信平台发送短信 [2017/12/12 03:05] (当前版本) |
||
|---|---|---|---|
| 行 2: | 行 2: | ||
| ===== 一. 流程介绍 ===== | ===== 一. 流程介绍 ===== | ||
| - | 首先,在系统内填写短信内容,点击【发送】按钮,系统将信息存入cc10_batchcontacts和cc10_batchcontact_archives表。 | + | 首先,在系统内填写短信内容,点击[发送]按钮,系统将信息存入cc10_batchcontacts和cc10_batchcontact_archives表。 |
| 其次,你需要编写一个程序文件,从系统读取待发短信,然后按照第三方平台的要求,将短信内容送至第三方服务器。 | 其次,你需要编写一个程序文件,从系统读取待发短信,然后按照第三方平台的要求,将短信内容送至第三方服务器。 | ||
| 行 10: | 行 10: | ||
| ===== 二. 数据表说明 ===== | ===== 二. 数据表说明 ===== | ||
| cc10_batchcontacts表,存储短信目标号码,发送者帐号,发送状态。 | cc10_batchcontacts表,存储短信目标号码,发送者帐号,发送状态。 | ||
| - | **batchcontact_archive_id**,关联cc10_batchcontact_archives表的数据id,此表用于存储短信详细内容。 | + | * **batchcontact_archive_id**,关联cc10_batchcontact_archives表的数据id,此表用于存储短信详细内容。 |
| - | **target**,短信接收者的电话号码。 | + | * **target**,短信接收者的电话号码。 |
| - | **status**,短信发送状态。 | + | * **status**,短信发送状态。 |
| - | 初始状态为“new”,表示待发的,新的。你的程序需要获取此类短信进行发送。 | + | 初始状态为“new”,表示待发的,新的。你的程序需要获取此类短信进行发送。 |
| - | 一旦短信进入发送状态,请在程序中将值变更为“pending”,表示正在发送中。 | + | |
| - | 发送完毕后,根据第三方返回值,将状态更为“error”遇到错误,“failed”发送失败,“success”发送成功。 | + | 一旦短信进入发送状态,请在程序中将值变更为“pending”,表示正在发送中。 |
| - | **schedulertime**,预约发送时间,“0000-00-00 00:00:00”代表立即发送。其余值代表指定时间发送。程序中需要查找此字段小于当前时间的数据。 | + | |
| - | **contacttime**,向第三方推送短信的时间,程序中获取到第三方返回值后与状态字段status一起更新即可。 | + | 发送完毕后,根据第三方返回值,将状态更为“error”遇到错误,“failed”发送失败,“success”发送成功。 |
| - | **creby**,短信创建者的帐号。 | + | * **schedulertime**,预约发送时间,“0000-00-00 00:00:00”代表立即发送。其余值代表指定时间发送。程序中需要查找此字段小于当前时间的数据。 |
| - | **created**,短信的创建时间。 | + | * **contacttime**,向第三方推送短信的时间,程序中获取到第三方返回值后与状态字段status一起更新即可。 |
| - | **error_msg**,短信发送失败或遇到错误,请将原因填写在此处。 | + | * **creby**,短信创建者的帐号。 |
| - | **responsenote**,接收者回复的短信内容,由第三方平台提供,程序收到回复内容后,更新到此字段即可。 | + | * **created**,短信的创建时间。 |
| + | * **error_msg**,短信发送失败或遇到错误,请将原因填写在此处。 | ||
| + | * **responsenote**,接收者回复的短信内容,由第三方平台提供,程序收到回复内容后,更新到此字段即可。 | ||
| cc10_batchcontact_archives表,存储待发短信的实际内容。cc10_batchcontacts表通过字段“batchcontact_archive_id”关联本表数据。 | cc10_batchcontact_archives表,存储待发短信的实际内容。cc10_batchcontacts表通过字段“batchcontact_archive_id”关联本表数据。 | ||
| - | **archivetype**,信息类型,email代表邮件,sms代表短信。 | + | * **archivetype**,信息类型,email代表邮件,sms代表短信。 |
| - | **content**,短信内容。 | + | * **content**,短信内容。 |
| ===== 三. php代码示例 ===== | ===== 三. php代码示例 ===== | ||
| + | 创建一个sms.php文件,本示例采用了第三方提供的http接口进行短信发送,以下为php代码截图 | ||
| + | |||
| + | 定义变量 | ||
| + | |||
| + | {{:zh:二次开发者指南:如何使用第三方短信平台发送短信_定义变量.jpg?768}} | ||
| + | |||
| + | 查询待发短信,调用发送方法,更新第三方返回信息。 | ||
| + | |||
| + | {{:zh:二次开发者指南:如何使用第三方短信平台发送短信_处理数据.jpg?768}} | ||
| + | |||
| + | 定义发送方法 | ||
| + | |||
| + | {{:zh:二次开发者指南:如何使用第三方短信平台发送短信_发送方法.jpg?768}} | ||
| + | |||
| + | 设置此脚本的执行周期,如果你需要每分钟执行一次,可以把此文件加入到"crontab -e"中 | ||
| + | |||
| + | {{:zh:二次开发者指南:如何使用第三方短信平台发送短信_执行周期.jpg}} | ||
| + | |||
| + | "* * * * *"代表每分钟执行一次。 | ||
| + | |||
| + | 你也可以在代码中做一个死循环,在服务器中执行一次此php文件,让程序不断循环查找新短信。 | ||
| + | |||
| + | {{:zh:二次开发者指南:如何使用第三方短信平台发送短信_执行周期2.jpg?768}} | ||
| + | |||
| + | 当然,你也可以使用其它方法执行此程序,只要保证能查出新短信,并送达第三方服务器即可。 | ||
| + | |||
| + | ===== 四. 测试系统中短信发送 ===== | ||
| + | 登录坐席平台,点击工具栏上的 [消息] 按钮发送短信 | ||
| + | |||
| + | {{:zh:二次开发者指南:发送消息界面.png}} | ||
| + | |||
| + | 确定填写的信息没有遗漏后,点击[发送]按钮,会得到如下提示 | ||
| + | |||
| + | {{:zh:二次开发者指南:发送提示.png}} | ||
| + | |||
| + | 对于待发和发送失败的信息数据要在 [群发信息管理]-> [待发信息管理] 页面可以查看到。 | ||
| + | {{:zh:二次开发者指南:待发信息管理.png?768}} | ||
| + | |||
| + | 如果短信发送成功,在 [群发信息管理]->[已发信息管理] 页面进行查看,如下 | ||
| - | ===== 四. 测试短信发送 ===== | + | {{:zh:二次开发者指南:已发信息管理.png?768}} |