狄阁老智能AI客服接口文档

狄阁老机器人是AI人工智能时代专为企业量身打造的AI+SaaS全智能营销客服系统平台。在呼叫中心系统的基础上,融入人工智能技术,通过自动外呼、自动应答进行电话营销与客户服务,助力企业提升电话营销与客服效率、优化运营成本,最终实现降本增效。


5.7.2新建外呼任务接口(json方式)

<p><strong>简要描述:</strong> </p> <ul> <li>新建外呼任务接口(json方式)</li> </ul> <p>添加营销任务。有俩种方式添加,一种是新建一条营销任务的数据,一种是在原来数据的基础上添加外呼数据。俩种区别就是是否传入营销任务的唯一标识符(dial_task_main_sn)参数。如果当前任务状态为《发送中》,则会在后面继续添加,如果当前营销任务状态《已发送》,添加后任务状态会由《已发送》状态改为《暂停发送》状态。需要手动开启来继续任务。此接口只适用于json数据格式导入的方式。</p> <p><strong>新建外呼任务每天有限量100次调用,如果需要频繁的创建任务,请使用追加的方式,追加只需要多传一个dial_task_main_sn字段值,这个值通过创建任务时返回,或者通过获取任务列表获得</strong></p> <hr /> <p><strong>异步请求URL:</strong> </p> <ul> <li><code>{BaseUrl}/api/addJsonOfAsync</code></li> </ul> <p><strong>请求方式:</strong></p> <ul> <li>POST </li> </ul> <p><strong>参数:</strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">project_sn</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>营销项目模板的唯一标识符(sn号)</td> </tr> <tr> <td style="text-align: left;">source</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>营销任务名称 只支持中英文小括号数字</td> </tr> <tr> <td style="text-align: left;">client_info_json</td> <td style="text-align: left;">是</td> <td style="text-align: left;">json</td> <td>导入对象(限Json)格式:字段根据模板不同而不同。</td> </tr> <tr> <td style="text-align: left;">ai_user_sn</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>销售人员的唯一标识符(sn号)</td> </tr> <tr> <td style="text-align: left;">is_zidong</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>呼叫类型:设置型字段,提供该字段且值为 on:自动启动,off:手动启动,2:定时启动)</td> </tr> <tr> <td style="text-align: left;">mark</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>备注</td> </tr> <tr> <td style="text-align: left;">dial_task_main_sn</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>营销任务唯一标识符(sn号),追加到对应的外呼任务</td> </tr> <tr> <td style="text-align: left;">is_append</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>是否是追加外呼(0否 1是)</td> </tr> <tr> <td style="text-align: left;">timed_started_at</td> <td style="text-align: left;">否</td> <td style="text-align: left;">datetime</td> <td>定时任务开启时间,(时间格式YYYY-mm-dd xx:xx:xx)</td> </tr> <tr> <td style="text-align: left;">is_auto_fail_recall</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>开启自动失败重呼(0:不开启,1:开启)</td> </tr> <tr> <td style="text-align: left;">total_fail_recall_times</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>重呼次数,开启自动失败重呼时,只能取1到5的值,当未开启自动失败重呼,值为0</td> </tr> <tr> <td style="text-align: left;">fail_recall_interval</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>重呼间隔(分钟),开启自动失败重呼时,只能取大于1的值,当未开启自动失败重呼,值为0</td> </tr> <tr> <td style="text-align: left;">fail_recall_of_reason</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>选择通话结果,可选的值参考文档([号码状态识别结果](<a href="http://wiki.ciopaas.com:8888/web/#/4?page_id=172">http://wiki.ciopaas.com:8888/web/#/4?page_id=172</a> &quot;号码状态识别结果&quot;)),当未开启自动失败重呼,值为空</td> </tr> <tr> <td style="text-align: left;">nextday_auto_stop</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>是否隔天自动暂停(0否 1是)</td> </tr> <tr> <td style="text-align: left;">is_open_remove_duplication</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>是否根据号码去重 1 是 0 否</td> </tr> <tr> <td style="text-align: left;">task_type</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>任务类型 0AI外呼 1人工预测式 2人工预览式 3AI预测式 (6.6版本新增)</td> </tr> <tr> <td style="text-align: left;">ai_distribution_type</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>预览式外呼 1抢拨 0平均 (6.6版本新增)</td> </tr> <tr> <td style="text-align: left;">percentage</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>预测式倍率 (6.6版本新增)</td> </tr> <tr> <td style="text-align: left;">yd_display_phone</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>外呼主叫号码,存储格式:user_sn@vos:9003#id:002@@user_sn!vos:9003#id:002 ( user_sn对应子账号sn,跟@符号拼接多个主叫号码,多个主叫号码用#拼接,主叫号码又分vos跟自定义网关的主叫,vos主叫填“vos”,网关的主叫填写对应的ID,多个子账号的主叫按@@符号拼接),例如单个主叫就可以:user_sn@vos:主叫</td> </tr> <tr> <td style="text-align: left;">ai_count</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>任务共享ai数时所需的ai数</td> </tr> <tr> <td style="text-align: left;">is_open_number_check</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>是否开启大数据号码检查 1是 0否 (7.1异步接口支持)</td> </tr> <tr> <td style="text-align: left;">is_open_second_dialing</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>是否开启二次拨号 1是 0否 (7.3异步接口支持)</td> </tr> <tr> <td style="text-align: left;">time_bitmap</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>外呼时间段(09:30-12:00,14:00-18:00)(7.6版本新增 只在定时任务下生效该参数)</td> </tr> <tr> <td style="text-align: left;">date_bitmap</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>呼叫星期,节假日外呼(week1,week2,week3,week4,week5,week6,week7,holiday)有&quot;holiday&quot;值表示开启节假日外呼(7.6版本新增 只在定时任务下生效该参数)</td> </tr> <tr> <td style="text-align: left;">timed_end_at</td> <td style="text-align: left;">否</td> <td style="text-align: left;">datetime</td> <td>结束任务时间,(时间格式YYYY-mm-dd xx:xx:xx )(7.6版本新增 只在定时任务下生效该参数)</td> </tr> <tr> <td style="text-align: left;">model_type</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>任务模式 0单任务 1多任务 (7.7版本新增)</td> </tr> <tr> <td style="text-align: left;">auto_intervention</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>任务临停 0否 1是 (7.7版本新增)</td> </tr> <tr> <td style="text-align: left;">push_client_users</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>RPA助手推送对象 对应user_sn 多个用英文,隔开 (7.8版本新增)</td> </tr> <tr> <td style="text-align: left;">task_open_auto_add_wechat</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>RPA助手 0关闭 1开启 (7.8版本新增)</td> </tr> <tr> <td style="text-align: left;">number_check_rule_id</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>号码检测规则id (7.8版本新增)</td> </tr> <tr> <td style="text-align: left;">user_group_sn</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>子账号组 多个用英文,分开 (7.8版本新增)</td> </tr> <tr> <td style="text-align: left;">customer_type</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>自动分配 off关闭 0自动分配开启并且选择企业预设 1 自动分配开启并且选择自定义 customer_set_json字段有json数据 (7.8版本新增)</td> </tr> <tr> <td style="text-align: left;">recall_auto</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>自动重呼方式 0新建任务重呼 1原任务呼完重呼 2原任务立即重呼 (7.8版本新增)</td> </tr> <tr> <td style="text-align: left;">talktimesmin_recall_of_reason</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>重呼条件 &lt;=通话时长 (7.8版本新增)</td> </tr> <tr> <td style="text-align: left;">talktimesmax_recall_of_reason</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>重呼条件 &amp;=通话时长 (7.8版本新增)</td> </tr> <tr> <td style="text-align: left;">success_recall_of_reason</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>重呼条件 选择成功结果 可选 &quot;接通后客户挂机,接通后我方挂机&quot; (7.8版本新增)</td> </tr> <tr> <td style="text-align: left;">classify_recall_of_reason</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>重呼条件 通话分类 &quot;A,B,C&quot;(7.8版本新增)</td> </tr> <tr> <td style="text-align: left;">is_push_crm</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>公众号接收客户分配提醒:0、关;1、开(默认)(7.8版本新增)</td> </tr> <tr> <td style="text-align: left;">start_at</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>外呼开始时间段。跟time_bitmap配合使用 (7.8版本新增)默认值 00:00</td> </tr> <tr> <td style="text-align: left;">end_at</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>外呼结束时间段。跟time_bitmap配合使用 (7.8版本新增)默认值 239:59</td> </tr> <tr> <td style="text-align: left;">customer_set_json</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>自定义分配规则 json格式 (7.8版本新增)任务自定义进入crm条件设置(格式 display1私海,2公海,0不处理</td> </tr> </tbody> </table> <p><strong>Json传参格式:</strong></p> <pre><code> { &amp;quot;user_sn&amp;quot;:&amp;quot;{{aiusn}}&amp;quot;, &amp;quot;api_key&amp;quot;:&amp;quot;{{aikey}}&amp;quot;, &amp;quot;source&amp;quot;:&amp;quot;新建任务1&amp;quot;, &amp;quot;project_sn&amp;quot;:&amp;quot;{{pj}}&amp;quot;, &amp;quot;ai_user_sn&amp;quot;:&amp;quot;{{aius}}&amp;quot;, &amp;quot;is_zidong&amp;quot;:&amp;quot;on&amp;quot;, &amp;quot;time_bitmap&amp;quot;:&amp;quot;09:30-12:00,14:00-18:00&amp;quot;, &amp;quot;date_bitmap&amp;quot;:&amp;quot;week1,week2,week3,week4,week5,week6,week7,holiday&amp;quot;, &amp;quot;timed_end_at&amp;quot;:&amp;quot;2024-07-09&amp;quot;, &amp;quot;timed_started_at&amp;quot;:&amp;quot;2024-07-09&amp;quot;, &amp;quot;start_at&amp;quot;:&amp;quot;08:30:00&amp;quot;, &amp;quot;end_at&amp;quot;:&amp;quot;21:00:00&amp;quot;, &amp;quot;client_info_json&amp;quot;:{ &amp;quot;data&amp;quot;:[ { &amp;quot;姓名&amp;quot;:&amp;quot;xxxx&amp;quot;, &amp;quot;电话&amp;quot;:&amp;quot;12345678901&amp;quot;, &amp;quot;地址&amp;quot;:&amp;quot;深圳&amp;quot;, &amp;quot;公司名称&amp;quot;:&amp;quot;xxxx&amp;quot;, &amp;quot;备注&amp;quot;:&amp;quot;xxxx&amp;quot; }, { &amp;quot;姓名&amp;quot;:&amp;quot;xxx&amp;quot;, &amp;quot;电话&amp;quot;:&amp;quot;12345678901&amp;quot;, &amp;quot;地址&amp;quot;:&amp;quot;深圳&amp;quot;, &amp;quot;公司名称&amp;quot;:&amp;quot;xxxx&amp;quot;, &amp;quot;备注&amp;quot;:&amp;quot;xxxx&amp;quot; } ] }, &amp;quot;recall_auto&amp;quot;:&amp;quot;0&amp;quot;, &amp;quot;is_auto_fail_recall&amp;quot;:1, &amp;quot;total_fail_recall_times&amp;quot;:1, &amp;quot;fail_recall_interval&amp;quot;:1, &amp;quot;fail_recall_of_reason&amp;quot;:&amp;quot;关机,来电提醒,稍后再拨,停机,无法接通,正在通话中,用户正忙,用户拒接,欠费,无人应答,其他&amp;quot;, &amp;quot;talktimesmin_recall_of_reason&amp;quot;:1, &amp;quot;talktimesmax_recall_of_reason&amp;quot;:100, &amp;quot;success_recall_of_reason&amp;quot;:&amp;quot;接通后客户挂机,接通后我方挂机&amp;quot;, &amp;quot;classify_recall_of_reason&amp;quot;:&amp;quot;A,B,C&amp;quot;, &amp;quot;is_open_remove_duplication&amp;quot;:1, &amp;quot;yd_display_phone&amp;quot;:&amp;quot;{{aius}}@vos:900002&amp;quot;, &amp;quot;model_type&amp;quot;:1 }</code></pre> <p><strong>异步返回示例</strong></p> <pre><code> { &amp;quot;code&amp;quot;: 0, &amp;quot;data&amp;quot;: { &amp;quot;total&amp;quot;: 1, &amp;quot;dial_task_main_sn&amp;quot;: &amp;quot;dial_task_main_sn|xxxxxx&amp;quot;, &amp;quot;dial_task_main_id&amp;quot;: &amp;quot;33&amp;quot; }, &amp;quot;msg&amp;quot;: &amp;quot;新建成功,等待处理&amp;quot; }</code></pre> <p><strong>返回参数说明</strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">total</td> <td style="text-align: left;">int</td> <td>导入总数</td> </tr> <tr> <td style="text-align: left;">dial_task_main_sn</td> <td style="text-align: left;">string</td> <td>任务sn</td> </tr> <tr> <td style="text-align: left;">dial_task_main_id</td> <td style="text-align: left;">int</td> <td>导入任务id</td> </tr> </tbody> </table> <p><strong>备注</strong> </p> <p><strong>Json传输方式:</strong> 对需要导入client_info_json数据有明文跟密文俩种传输方式,明文传输只需传入原生json即可。 密文传输采用的是AES加密模式,以防数据被抓包。如果需要密文传输则需要传入一个aes字段,值为true, 另外得到的密串在client_info_json字段传入即可。AES加密各个参数说明如下</p> <p><strong> AES加密模式:</strong></p> <table> <thead> <tr> <th>键</th> <th>值</th> </tr> </thead> <tbody> <tr> <td>CBC</td> <td>pkcs7</td> </tr> <tr> <td>数据块</td> <td>128位</td> </tr> <tr> <td>密码</td> <td>user_sn的后面(SYSUSER后面)前16位字符串</td> </tr> <tr> <td>偏移量</td> <td>1234567890123456</td> </tr> <tr> <td>输出</td> <td>base64</td> </tr> <tr> <td>字符集</td> <td>utf8</td> </tr> </tbody> </table> <p><strong>Json数据格式:</strong> json数据格式为一般以下载的模板文档为主,第一第二个字段必须为姓名,电话,其余字段根据每个项目的不同传入不同的数据。</p> <p><strong>明文示例:</strong></p> <pre><code class="language-json">{ &amp;quot;data&amp;quot;:[ { &amp;quot;姓名&amp;quot;:&amp;quot;xxxx&amp;quot;, &amp;quot;电话&amp;quot;:&amp;quot;12345678901&amp;quot;, &amp;quot;地址&amp;quot;:&amp;quot;深圳&amp;quot;, &amp;quot;公司名称&amp;quot;:&amp;quot;xxxx&amp;quot;, &amp;quot;备注&amp;quot;:&amp;quot;xxxx&amp;quot; }, { &amp;quot;姓名&amp;quot;:&amp;quot;xxx&amp;quot;, &amp;quot;电话&amp;quot;:&amp;quot;12345678901&amp;quot;, &amp;quot;地址&amp;quot;:&amp;quot;深圳&amp;quot; &amp;quot;公司名称&amp;quot;:&amp;quot;xxxx&amp;quot;, &amp;quot;备注&amp;quot;:&amp;quot;xxxx&amp;quot; } ] }</code></pre> <p><strong>密文示例:</strong></p> <pre><code>WN0a5NVF6idFYVU23Zl4LgBxujTsZmaJiMHWDPFHK42VaD7IeGtMBaZn8Ni9P9CHxHehltg5boSX9pCaoUFkpw53KrvyeCXjppx+4GjKjSMhq2e9kh5pxudgBv8R0pgTD7p9sV+MbBRi7kZ23pI+voaDDbakijQHC3wb5GP4wIs=</code></pre> <ul> <li>更多返回错误代码请看首页的错误代码描述</li> </ul>

页面列表

ITEM_HTML