✎ zh:二次开发者指南:如何使用第三方短信平台发送短信 [asterCC, hosted call center solution based asterisk]

本页面只读。您可以查看源文件，但不能更改它。如果您觉得这是系统错误，请联系管理员。
====== asterCC使用第三方短信平台发送短信 ======

===== 一. 流程介绍 =====
首先，在系统内填写短信内容，点击[发送]按钮，系统将信息存入cc10_batchcontacts和cc10_batchcontact_archives表。

其次，你需要编写一个程序文件，从系统读取待发短信，然后按照第三方平台的要求，将短信内容送至第三方服务器。

最后，根据第三方的返回值，更新系统内短信数据的状态值，标识其发送是否成功。

===== 二. 数据表说明 =====
cc10_batchcontacts表，存储短信目标号码，发送者帐号，发送状态。
  * **batchcontact_archive_id**，关联cc10_batchcontact_archives表的数据id,此表用于存储短信详细内容。
  * **target**，短信接收者的电话号码。
  * **status**，短信发送状态。
初始状态为“new”，表示待发的，新的。你的程序需要获取此类短信进行发送。

一旦短信进入发送状态，请在程序中将值变更为“pending”，表示正在发送中。

发送完毕后，根据第三方返回值，将状态更为“error”遇到错误，“failed”发送失败，“success”发送成功。
  * **schedulertime**，预约发送时间，“0000-00-00 00:00:00”代表立即发送。其余值代表指定时间发送。程序中需要查找此字段小于当前时间的数据。
  * **contacttime**，向第三方推送短信的时间，程序中获取到第三方返回值后与状态字段status一起更新即可。
  * **creby**，短信创建者的帐号。
  * **created**，短信的创建时间。
  * **error_msg**，短信发送失败或遇到错误，请将原因填写在此处。
  * **responsenote**，接收者回复的短信内容，由第三方平台提供，程序收到回复内容后，更新到此字段即可。

cc10_batchcontact_archives表，存储待发短信的实际内容。cc10_batchcontacts表通过字段“batchcontact_archive_id”关联本表数据。
  * **archivetype**，信息类型，email代表邮件，sms代表短信。
  * **content**，短信内容。
===== 三. 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}}