如何通过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)

作用说明

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

参数说明

参数名称

类型

描述信息

  • orgidentity
  • usertype
  • user
  • pwdtype
  • password
  • modeltype
  • model_id
  • source
  • String
  • String
  • String
  • String
  • String
  • String
  • String
  • String
  • 团队唯一标识
  • agent(坐席)/account(帐号)
  • 坐席工号 / 用户名
  • 密码类型 明文(plaintext) / MD5加密(md5)
  • 密码
  • 外拨营销任务(Campaign)
  • 外拨营销任务ID
  • 待导入数据的来源:
  1. data,即时数据,每次限导入一条,组成格式:字段名称1=字段值1||字段名称2=字段值2||…..||字段名称N=字段值N,例如:姓名=客户A||phone1=138xxxx88x8。
  2. http,使用http方式获取导入文件,仅支持csv文件。
  3. ftp,使用ftp方式获取导入文件,仅支持csv文件。
  • context
  • String
  • 参照source参数。
  1. 当source=data时,填写待导入数据的内容,即:姓名=客户A||phone1=138xxxx88x8 ||为分隔符 姓名为系统中字段多语言后的显示名称,phone1(电话号码一)为表结构中的字段名称,两种形式均可当作字段名称使用。
  2. 当source=http时,填写文件的http获取地址,例如:http://192.168.1.88/xxx.csv
  3. 当source=ftp时,填写文件的ftp获取地址,例如:ftp://192.168.1.88/xxx.csv
  • source_user
  • source_pwd
  • exetime
  • delrow,
  • phone_field
  • priority_field
  • dialtime_field
  • emptyagent
  • resetstatus
  • dupway
  • dupdiallist
  • String
  • String
  • String
  • String
  • String
  • String
  • String
  • String
  • String
  • String
  • String
  • 当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)使用文件中的数据更新已存在的数据。
  • 当待导入数据已经存在于客户包时,应该使用下列哪种方式将客户放入预拨号列表。
  1. 忽略重复(ignoreDuplicate),如果发现客户数据已存在,此数据无需放入预拨号列表。
  2. 全部(all),无视数据是否重复,无视客户处理状态,一律放入预拨号列表。
  3. 忽略成功提交(ignoreSuccess),无视数据是否重复,只要客户处理状态不是成功提交,就放入预拨号列表。
  • changepackage
  • String
  • 如果目标客户包使用的是总表客户,并且待导入数据已存在于数据表。
  1. 跳过(skip),不处理此类数据。
  2. 仅改变主表客户(unassignToCurrent),如果此客户未分配至其它客户包,那么将此客户分配至当前客户包。
  3. 转移到当前客户包(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|2|Retuen|message
  • |Retuen|成功|Retuen|采用文件导入数据时(即source=http或ftp),返回导入任务id,否则直接返回成功提示语(即source=data)
  • |Retuen|失败|Retuen|信息描述
zh/二次开发者指南/如何通过api将数据导入到外呼营销任务及预拨号.txt · 最后更改: 2017/12/12 11:05 (外部编辑)
Recent changes RSS feed Debian Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki