====== 如何通过API将数据导入到外呼营销任务及预拨号 ======

===== 接口原型 =====

importWS(orgidentity,usertype,user,pwdtype,password,modeltype,model_id,source,context,source_user,source_pwd,exetime,delrow,phone_field,priority_field,dialtime_field,emptyagent, resetstatus,dupway,dupdiallist,changepackage)


===== 作用说明 =====

向某个外呼营销任务的客户包导入客户数据，进行预拨号。


===== 参数说明 =====

<WRAP column 9%>
**参数名称**
</WRAP>
<WRAP column 7%>
**类型**
</WRAP>
<WRAP column 79%>
**描述信息**
</WRAP>

<WRAP column 9%>
  * orgidentity
  * usertype
  * user
  * pwdtype
  * password
  * modeltype
  * model_id
  * source
</WRAP>
<WRAP column 7%>
  * String
  * String
  * String
  * String
  * String
  * String
  * String
  * String
</WRAP>
<WRAP column 79%>
  * 团队唯一标识
  * agent(坐席)/account(帐号)
  * 坐席工号 / 用户名
  * 密码类型  明文(plaintext) / MD5加密(md5) 
  * 密码
  * 外拨营销任务(Campaign)
  * 外拨营销任务ID
  * 待导入数据的来源：
  - **data**,即时数据，每次限导入一条，组成格式:字段名称1=字段值1||字段名称2=字段值2||…..||字段名称N=字段值N，例如：姓名=客户A||phone1=138xxxx88x8。
  - **http**,使用http方式获取导入文件,仅支持csv文件。
  - **ftp**,使用ftp方式获取导入文件,仅支持csv文件。
</WRAP>

<WRAP column 9%>
  * context
</WRAP>
<WRAP column 7%>
  * String
</WRAP>
<WRAP column 79%>
  * 参照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 。
</WRAP>

<WRAP column 9%>
  * source_user
  * source_pwd
  * exetime
  * delrow,
  * phone_field
  * priority_field
  * dialtime_field
  * emptyagent
  * resetstatus
  * dupway
  * dupdiallist
</WRAP>
<WRAP column 7%>
  * String
  * String
  * String
  * String
  * String
  * String
  * String
  * String
  * String
  * String
  * String
</WRAP>
<WRAP column 79%>
  * 当source=http或ftp时，如果文件服务器设置了用户名，请填写用户名，否则请传递空参数，即source_user=‘’.
  * 当source=http或ftp时，如果文件服务器设置了密码，请填写密码，否则请传递空参数，即source_pwd=‘’.
  * 当source=http或ftp时，设置导入任务的执行时间。参数为空或0000-00-00 00:00:00时，代表立即执行导入任务。
  * 填写数字，代表文件中前N行数据不导入进系统。一般去除第1行，文件首行为标题行，不是数据。当source=http或ftp时，此参数有效。
  * 如需将数据同时导入预拨号列表，请指定号码列的字段名称。例如 phone1 或 电话号码一
  * 预拨号优先级所对应的字段名称。
  * 预拨号时间所对应的字段名称。
  * 当待导入数据已经存在于客户包时，是（yes）否(no)清空归属坐席,向预拨号导入数据时，参考此参数进行数据归属重置。
  * 当待导入数据已经存在于客户包时，是（yes）否(no)重置客户处理状态。
  * 当待导入数据已经存在于客户包时，是(update)否（skip）使用文件中的数据更新已存在的数据。
  * 当待导入数据已经存在于客户包时，应该使用下列哪种方式将客户放入预拨号列表。
  - **忽略重复**(ignoreDuplicate)，如果发现客户数据已存在，此数据无需放入预拨号列表。
  - **全部**(all)，无视数据是否重复，无视客户处理状态，一律放入预拨号列表。
  - **忽略成功提交**(ignoreSuccess)，无视数据是否重复，只要客户处理状态不是成功提交，就放入预拨号列表。
</WRAP>

<WRAP column 9%>
  * changepackage
</WRAP>
<WRAP column 7%>
  * String
</WRAP>
<WRAP column 79%>
  * 如果目标客户包使用的是总表客户，并且待导入数据已存在于数据表。
  - **跳过**(skip)，不处理此类数据。
  - **仅改变主表客户**(unassignToCurrent)，如果此客户未分配至其它客户包，那么将此客户分配至当前客户包。
  - **转移到当前客户包**(reassignToCurrent)，如果客户已分配至其它客户包，系统会将此用户转移至当前客户包。
</WRAP>


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

则：importWS(orgidentity,usertype,user,pwdtype,password,modeltype,model_id,source,context,source_user,source_pwd,exetime,delrow,‘ ’,‘ ’,‘ ’,emptyagent,resetstatus,dupway,dupdiallist,changepackage)

</note>


===== 返回结果 =====

返回值格式：|Retuen|code|Retuen|message

返回值类型：String

<WRAP column 20%>
**返回值**
</WRAP>
<WRAP column 60%>
**描述信息**
</WRAP>


<WRAP column 20%>
  * |Retuen|1|Retuen|message

  * |Retuen|2|Retuen|message
</WRAP>
<WRAP column 60%>
  * |Retuen|成功|Retuen|采用文件导入数据时(即source=http或ftp)，返回导入任务id，否则直接返回成功提示语(即source=data)

  * |Retuen|失败|Retuen|信息描述
</WRAP>