概述

企业微信会话存档功能面向第三方服务商，不提供“部门名”、“姓名”、“别名”、“群名”、“客户名”等以及消息的具体内容。代替以“部门ID”、“userID”、“群聊ID”、“消息ID”和“客户ID”。
服务商侧需要提供“会话内容导出”的功能给到用户时，其导出的文件中会含有“部门名”、“姓名”、“别名”、“群名”、“客户名”以及消息的具体内容，此时需要通过接口提交导出任务，在导出的文件中由企业微信进行转译，转译成正确的内容之后展示给用户。

会话内容导出流程

企业用户在会话展示组件中通过点击会话内容导出，发起导出操作，获取导出结果文件流程如图示。

会话内容导出模版语法

在文件中需要替换的位置构造转译模版，其中通讯录相关的ID转译参考通讯录ID转译概述，群聊名称和消息内容的转译模版如下：

$departmentName=DEPARTMENT_ID$
$userName=USERID$
$userAlias=USERID$
$userAliasOrName=USERID$
$chatName=CHATID$
$msgContent=MSGID/SECRET-KEY$
$externalUserName=EXTERNAL_USERID$

• 其中 DEPARTMENT_ID 是数字类型的部门id，USERID 是成员账号。
• 其中 CHATID是群聊ID，MSGID是消息ID。
• SECRET-KEY是获取会话记录接口返回的这条消息对应的 encrypted_secretkey 字段进行解密得到，参考 encrypt_secretkey 解密方式。
• EXTERNAL_USERID是客户的ID。若是企业客户填：externalUserId
  若是客户群的外部成员填：chatid/externalUserId，例如：wraaaabbbb/wmccccdddd

譬如，
将$departmentName=1$替换成部门id为1对应的部门名，如“企业微信部”；
将$userName=lisi007$替换成userid为lisi007对应的用户姓名，如“李四”；
将$userAlias=lisi007$替换成userid为lisi007对应的用户别名，如“lisi”；
将$userAliasOrName=lisi007$替换成userid为lisi007对应的用户别名或姓名，别名优先级高于姓名，如"lisi"；
将$chatName=xxxxx$替换成群聊ID为xxxxx对应的群聊名称；
将$msgContent=xxxxx/yyyyyy$替换成消息ID为xxxxx对应的消息内容，其中获取会话记录接口返回的这条消息对应的 encrypted_secretkey 字段进行解密得到的密钥为yyyyyy；
将$externalUserName=xxxxx$替换成客户ID为xxxxx对应的客户名称；

若输入的模板不符合语法、不在权限范围内、消息ID对应的密钥不正确或无效的群聊ID或者消息ID，则不替换该项内容，保留原样
转译userAlias时，如果用户没有别名，则不替换该项内容，保留原样
转译userAliasOrName时，如果用户有别名，则替换为别名；否则，将替换为姓名

支持的ID类型和转译结果

部门ID

支持企业部门id。

员工ID

支持企业员工id。

群聊ID

支持转译内部群和外部群的名称；
不包括单聊；
对于无名称的企业内部群聊，展示为未命名内部群；
对于无名称的企业客户群聊，展示为未命名客户群；
对于非企业客户群，展示为非企业客户群。

消息ID

其他特殊情况转译结果说明：
企微后台系统失败->消息获取失败
msgid不存在或者过期->消息已过期，消息内容无法展示
SECRET-KEY错误->消息密钥错误

客户ID

支持企业的客户；
支持客户群中非企业客户的外部联系人（chatid/externalUserId）；
不满足以上两个条件展示为非企业客户。

频率限制说明

每企业每天会话导出次数不可超过1千次

创建会话内容导出任务

可通过此接口，创建会话内容存档消息内容导出异步任务。

权限说明

使用会话展示组件传过来的code才可以调用，一个code只能创建一次任务
支持Word(doc/docx)、Excel(xls/xlsx)和Txt(txt)格式的文件
文件中需要被转译的消息ID不能超过10000条
转译后的文件大小不能超过64MB

请求方法
通过SDK调用，具体方式参考专区程序使用指引。

请求接口名：
create_chatdata_export_job

请求示例：

{
	"code":"xxxxx",
	"media_id":"xxxxx"
}

参数说明：

返回结果

{
    "errcode": 0,
    "errmsg": "ok",
    "jobid": "xxxxx"
}

返回字段说明：

获取会话内容导出任务结果

可通过此接口，获取消息内容导出任务的处理状态。

权限说明

使用创建会话内容导出任务接口获得的jobid调用

请求方法
通过SDK调用，具体方式参考专区程序使用指引。

请求接口名：
get_chatdata_export_job_status

请求示例：

{
	"jobid":"xxxxx"
}

参数说明：

返回结果

{
    "errcode": 0,
    "errmsg": "ok",
    "status": 3,
	"result_id": "xxxx",
	"result_errcode": 0,
	"result_errmsg": "ok"
}

返回字段说明：