✎ zh:二次开发者指南:接口开发手册_v2.0:http接口:数据导入接口 [asterCC, hosted call center solution based asterisk]

本页面只读。您可以查看源文件，但不能更改它。如果您觉得这是系统错误，请联系管理员。
====== 数据导入接口 ======

  * 请求内容:
<code>EVENT=Import&orgidentity=orgidentity&usertype=usertype&user=user&pwdtype=pwdtype&password=password&modeltype=modeltype&model_id=model_id&source=source&context=context&source_user=source_user&source_pwd=source_pwd&exetime=exetime&delrow=delrow&phone_field=phone_field&priority_field=priority_field&dialtime_field=dialtime_field&emptyagent=emptyagent&resetstatus=resetstatus&dupway=dupway&dupdiallist=dupdiallist&changepackage=changepackage</code>
  * 作用说明:
向某个外呼营销任务的客户包导入客户数据
  * 参数说明:

^ 参数名称      ^ 类型       ^ 描述信息          ^
|EVENT|String|请求目的：数据导入接口(Import)|
|orgidentity|String|团队唯一标识|
|usertype|String|agent(坐席) / account(帐号)|
|user|String|坐席工号 / 用户名|
|pwdtype|String|密码类型  明文(plaintext) / MD5加密(md5)|
|password|String|密码|
|modeltype|String|外拨营销任务(Campaign)|
|model_id|String|外拨营销任务ID|
|source|String|<code>待导入数据的来源
data,即时数据，每次限导入一条，组成格式如下:
字段名称1=字段值1||字段名称2=字段值2||…..||字段名称N=字段值N
举例
姓名=客户A||phone1=138xxxx88x8
http,使用http方式获取导入文件,仅支持csv文件。
ftp,使用ftp方式获取导入文件,仅支持csv文件。</code>|
|context|String|<code>参照source参数。
当source=data时，填写待导入数据的内容，即
姓名=客户A||phone1=138xxxx88x8   ||为分隔符
姓名为系统中字段多语言后的显示名称,phone1（电话号码一）为表结构中的字段名称，两种形式均可当作字段名称使用。
当source=http时，填写文件的http获取地址，例如
http://192.168.1.88/xxx.csv
当source=ftp时，填写文件的ftp获取地址，例如
ftp://192.168.1.88/xxx.csv</code>|
| source_user | String | 当source=http或ftp时，如果文件服务器设置了用户名，请填写用户名，否则请传递空参数，即source_user=""。 |
| source_pwd | String | 当source = http或ftp时，如果文件服务器设置了密码，请填写密码，否则请传递空参数，即source_pwd=""。|
|exetime|String|当source=http或ftp时，设置导入任务的执行时间。参数为空或0000-00-00 00:00:00时，代表立即执行导入任务。|
|delrow|String|填写数字，代表文件中前N行数据不导入进系统。一般去除第1行，文件首行为标题行，不是数据。当source=http或ftp时，此参数有效。|
|phone_field|String|如需将数据同时导入预拨号列表，请指定号码列的字段名称。例如phone1或电话号码一|
|priority_field|String|预拨号优先级所对应的字段名称。|
|dialtime_field|String|预拨号时间所对应的字段名称。|
|emptyagent|String|当待导入数据已经存在于客户包时，是（yes）否(no)清空归属坐席,向预拨号导入数据时，参考此参数进行数据归属重置。|
|resetstatus|String|当待导入数据已经存在于客户包时，是（yes）否(no)重置客户处理状态。|
|dupway|String|当待导入数据已经存在于客户包时，是(update)否（skip）使用文件中的数据更新已存在的数据。|
|dupdiallist|String|<code>当待导入数据已经存在于客户包时，应该使用下列哪种方式将客户放入预拨号列表。
忽略重复(ignoreDuplicate)，如果发现客户数据已存在，此数据无需放入预拨号列表。
全部(all)，无视数据是否重复，无视客户处理状态，一律放入预拨号列表。
忽略成功提交(ignoreSuccess)，无视数据是否重复，只要客户处理状态不是成功提交，就放入预拨号列表。</code>|
|changepackage|String|<code>如果目标客户包使用的是总表客户，并且待导入数据已存在于数据表。
跳过(skip)，不处理此类数据。
仅改变主表客户(unassignToCurrent)，如果此客户未分配至其它客户包，那么将此客户分配至当前客户包。
转移到当前客户包(reassignToCurrent)，如果客户已分配至其它客户包，系统会将此用户转移至当前客户包。</code>|

<note important>注意：所有参数不得缺省，无数据时，请使用空参占位。
例如不设置phone_field，priority_field，dialtime_field三个字段时

EVENT=Import&orgidentity=orgidentity&usertype=usertype&user=user&pwdtype=pwdtype&password=password&modeltype=modeltype&
model_id=model_id&source=source&context=context&source_user=source_user&source_pwd=source_pwd&exetime=exetime&
delrow=delrow**&phone_field=&priority_field=&dialtime_field=**&emptyagent=emptyagent&resetstatus=resetstatus&
dupway=dupway&dupdiallist=dupdiallist&changepackage=changepackage
</note>

  * 返回结果：

<code>
|Retuen|code|Retuen|message
</code>

  * 返回值类型:String
  * 返回值：

^ 返回值      ^ 描述信息       ^
|<code>|Retuen|1|Retuen|message</code>|<code>|Retuen|成功|Retuen|采用文件导入数据时(即source=http或ftp)，返回导入任务id，否则直接返回成功提示语(即source=data)</code>|
|<code>|Retuen|2|Retuen|message</code> |<code>|Retuen|失败|Retuen|信息描述</code>|