概述

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

会话内容导出流程

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

会话内容导出模版语法

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

$chatName=CHATID$
$msgContent=MSGID/SECRET-KEY$

其中 CHATID是群聊ID，MSGID是消息ID，SECRET-KEY是获取会话记录接口返回的这条消息对应的 encrypted_secretkey 字段进行解密得到，参考 encrypt_secretkey 解密方式。

譬如，
将$chatName=xxxxx$替换成群聊ID为xxxxx对应的群聊名称；
将$msgContent=xxxxx/yyyyyy$替换成消息ID为xxxxx对应的消息内容，其中获取会话记录接口返回的这条消息对应的 encrypted_secretkey 字段进行解密得到的密钥为yyyyyy；

若输入的模板不符合语法、不在权限范围内、消息ID对应的密钥不正确或无效的群聊ID或者消息ID，则不替换该项内容，保留原样

支持的ID类型和转译结果

群聊ID

仅支持转译内部群的名称；
不包括单聊；
对于无名称的群聊，展示为未命名群聊。

消息ID

频率限制说明

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

创建会话内容导出任务

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

权限说明

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

请求方式：POST（HTTPS）
请求地址：https://qyapi.weixin.qq.com/cgi-bin/chatdata/export/create_job?access_token=ACCESS_TOKEN

请求示例：

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

参数说明：

返回结果

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

返回字段说明：

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

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

权限说明

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

请求方式：POST（HTTPS）
请求地址：https://qyapi.weixin.qq.com/cgi-bin/chatdata/export/get_job_status?access_token=ACCESS_TOKEN

请求示例：

{
	"jobid":"xxxxx"
}

参数说明：

返回结果

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

返回字段说明：

会话内容导出任务完成回调

当会话内容导出任务完成时，企业微信服务器会向「会话存档接口授权」配置的“指令回调URL”推送相应的事件消息。消息接收方式参见回调接口。

事件示例：

<xml>
<SuiteId><![CDATA[xxxx]]></SuiteId>
<AuthCorpId><![CDATA[yyyy]]></AuthCorpId>
<InfoType><![CDATA[chat_archive_export_finished]]></InfoType>
<JobId><![CDATA[zzzzzzz]]></JobId>
<TimeStamp>1403610513</TimeStamp>
</xml>

参数说明：