数据导入接口

  • 接口原型:

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)

  • 作用说明:

向某个外呼营销任务的客户包导入客户数据

  • 参数说明:
参数名称 类型 描述信息
orgidentityString团队唯一标识
usertypeStringagent(坐席) / account(帐号)
userString坐席工号 / 用户名
pwdtypeString密码类型 明文(plaintext) / MD5加密(md5)
passwordString密码
modeltypeString外拨营销任务(Campaign)
model_idString外拨营销任务ID
sourceString
待导入数据的来源
data,即时数据,每次限导入一条,组成格式如下:
字段名称1=字段值1||字段名称2=字段值2||…..||字段名称N=字段值N
举例
姓名=客户A||phone1=138xxxx88x8
http,使用http方式获取导入文件,仅支持csv文件。
ftp,使用ftp方式获取导入文件,仅支持csv文件。
contextString
参照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
source_user String 当source=http或ftp时,如果文件服务器设置了用户名,请填写用户名,否则请传递空参数,即source_user=““。
source_pwd String 当source = http或ftp时,如果文件服务器设置了密码,请填写密码,否则请传递空参数,即source_pwd=”“。
exetimeString当source=http或ftp时,设置导入任务的执行时间。参数为空或0000-00-00 00:00:00时,代表立即执行导入任务。
delrowString填写数字,代表文件中前N行数据不导入进系统。一般去除第1行,文件首行为标题行,不是数据。当source=http或ftp时,此参数有效。
phone_fieldString如需将数据同时导入预拨号列表,请指定号码列的字段名称。例如phone1或电话号码一
priority_fieldString预拨号优先级所对应的字段名称。
dialtime_fieldString预拨号时间所对应的字段名称。
emptyagentString当待导入数据已经存在于客户包时,是(yes)否(no)清空归属坐席,向预拨号导入数据时,参考此参数进行数据归属重置。
resetstatusString当待导入数据已经存在于客户包时,是(yes)否(no)重置客户处理状态。
dupwayString当待导入数据已经存在于客户包时,是(update)否(skip)使用文件中的数据更新已存在的数据。
dupdiallistString
当待导入数据已经存在于客户包时,应该使用下列哪种方式将客户放入预拨号列表。
忽略重复(ignoreDuplicate),如果发现客户数据已存在,此数据无需放入预拨号列表。
全部(all),无视数据是否重复,无视客户处理状态,一律放入预拨号列表。
忽略成功提交(ignoreSuccess),无视数据是否重复,只要客户处理状态不是成功提交,就放入预拨号列表。
changepackageString
如果目标客户包使用的是总表客户,并且待导入数据已存在于数据表。
跳过(skip),不处理此类数据。
仅改变主表客户(unassignToCurrent),如果此客户未分配至其它客户包,那么将此客户分配至当前客户包。
转移到当前客户包(reassignToCurrent),如果客户已分配至其它客户包,系统会将此用户转移至当前客户包。

注意:所有参数不得缺省,无数据时,请使用空参占位。 例如不设置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)

  • 返回结果:

|Retuen|code|Retuen|message

  • 返回值类型:String
  • 返回值:
返回值 描述信息
|Retuen|1|Retuen|message
|Retuen|成功|Retuen|采用文件导入数据时(即source=http或ftp),返回导入任务id,否则直接返回成功提示语(即source=data)
|Retuen|2|Retuen|message
|Retuen|失败|Retuen|信息描述
zh/二次开发者指南/接口开发手册_v2.0/webservice接口/数据导入接口.txt · 最后更改: 2017/12/12 03:05 (外部编辑)
Recent changes RSS feed Debian Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki