目录

如何通过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|信息描述