差别
这里会显示出您选择的修订版和当前版本之间的差别。
两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 后一修订版 两侧同时换到之后的修订记录 | ||
cs:300visitoraccess:enterprisewechat [2020/04/14 14:24] candywang [开发者模式接入] |
cs:300visitoraccess:enterprisewechat [2022/03/22 03:33] xiaowei [开发者模式接入] |
||
---|---|---|---|
行 3: | 行 3: | ||
===== 概述 ===== | ===== 概述 ===== | ||
- | 环信客服云支持企业微信接入,绑定后您可以使用环信客服云统一接收与回复通过企业微信咨询的消息。企业微信属于微信渠道,企业微信用户产生的会话消息将以微信渠道的形式在客服工作台进行展示和统计。 | + | 环信客服云支持企业微信接入,绑定后您可以使用环信客服云统一接收与回复企业微信员工的消息。企业微信属于微信渠道,企业微信用户产生的会话消息将以微信渠道的形式在客服工作台进行展示和统计。 |
+ | |||
+ | |||
+ | ===== 授权模式接入 ===== | ||
+ | |||
+ | |||
+ | **创建关联,管理员操作流程如下:** | ||
+ | |||
+ | **1. 填写企业ID、自建应用名称** | ||
+ | |||
+ | {{:cs:300visitoraccess:添加企业微信.jpg?nolink&600|}} | ||
+ | |||
+ | 获取企业ID:进入企业微信后台管理页面; 进入“我的企业 > 企业信息”页面,获取“企业ID”。 | ||
+ | |||
+ | {{:cs:300visitoraccess:企信id.png?nolink&600|}} | ||
+ | |||
+ | **2. 使用管理员账号进行扫码授权** | ||
+ | |||
+ | {{:cs:300visitoraccess:扫码授权.jpg?nolink&600|}} | ||
+ | |||
+ | a.企信管理员使用企业微信进行扫码授权 | ||
+ | |||
+ | {{:cs:300visitoraccess:授权.jpg?nolink&600|}} | ||
+ | |||
+ | b.扫码授权成功,请添加相关技术人员进行相关的应用配置 | ||
+ | |||
+ | {{:cs:300visitoraccess:联系相关技术人员.jpg?nolink&600|}} | ||
+ | |||
+ | **3. 添加相关技术人员进行相关的应用配置** | ||
+ | |||
+ | {{:cs:300visitoraccess:应用配置.jpg?nolink&600|}} | ||
行 10: | 行 40: | ||
集成步骤如下: | 集成步骤如下: | ||
- | **第1步:获取企业微信的基本信息。** | ||
- | 进入企业微信后台管理页面获取“企业微信名称”、“企业微信ID”、“应用ID”和“应用密钥”。 | + | **【服务商】相关技术人员待开发应用操作流程如下:** |
+ | |||
+ | **1. 登陆企业微信后台 ** | ||
+ | |||
+ | 登录服务商(环信)企业微信后台,企业微信管理后台 > 应用管理 > 应用代开发 > 选择对应的代开发模板 | ||
+ | |||
+ | a.登陆服务商后台 | ||
+ | |||
+ | {{:cs:300visitoraccess:1登陆服务商后台.jpg?nolink&800|}} | ||
+ | |||
+ | b.点击"应用管理 > 应用代开发 > 选择对应的代发模版" | ||
+ | |||
+ | {{:cs:300visitoraccess:2点击-环信智能客服云授权模版.jpg?nolink&800|}} | ||
+ | |||
+ | c. 点击"开始代应用开发" | ||
+ | |||
+ | {{:cs:300visitoraccess:3点击开始待开发应用.jpg?nolink&800|}} | ||
+ | |||
+ | **2. 开始待应用开发** | ||
+ | |||
+ | a. 应用名称编辑,通过数据库查询用户的“应用名称”进行修改 | ||
+ | |||
+ | {{:cs:300visitoraccess:5开始待开发应用.jpg?nolink&800|}} | ||
+ | |||
+ | |||
+ | 查询方法:Weichat库 | ||
+ | |||
+ | <code html> | ||
+ | 查询指定应用 | ||
+ | |||
+ | SELECT * from weibotechchannel where channelType='qywx' and appName='dk6d65977460643ea2' and serviceWeiboNumber='企业ID'; | ||
+ | |||
+ | 查询该租户下的全部应用 | ||
+ | |||
+ | select * from weibotechchannel where tenantId=租户id and channelType='qywx' and appName is not null; | ||
+ | |||
+ | serviceWeiboNumber【客户企业微信**企业id**】 | ||
+ | appName【代开发应用**模板id**,创建好模板后固定】 | ||
+ | </code> | ||
+ | |||
+ | SQL查询结果 | ||
+ | |||
+ | {{:cs:300visitoraccess:sql查询结果.jpg?nolink&800|}} | ||
+ | |||
+ | b. 配置开发信息 | ||
- | 1. 进入“我的企业 > 企业信息”页面,获取“企业微信名称”“企业微信ID”。 | + | {{:cs:300visitoraccess:5配置开发应用.jpg?nolink&800|}} |
- | {{:cs:300visitoraccess:enterprisewechat-企业微信id.png?nolink|企业微信基本设置页面}} | + | 1)可信域名:kefu.easemob.com |
- | 2. 进入“企业微信平台 > 应用管理 > 应用”页面,选择要接入的应用,点击进入应用详情,获取应用ID和应用密钥。 | + | 线上ip白名单 |
- | {{:cs:300visitoraccess:enterprisewechat-应用列表.png?nolink|企业微信应用列表}} | + | 116.62.109.245;114.55.145.109;116.62.48.62;118.178.84.230;101.37.32.74;101.37.31.147;120.27.138.73;118.178.59.127 |
- | {{:cs:300visitoraccess:enterprisewechat-应用id.png?nolink|企业微信应用ID信息}} | + | |
- | **第2步:在环信客服云添加企业微信。** | + | 2)代开发应用回调url: |
- | 在环信客服云添加企业微信,填写企业微信的基本信息,生成服务器URL。 | + | http://kefu.easemob.com/v1/weixin/qyapi/企业ID/应用ID/callback |
- | 1. 进入“管理员模式 > 渠道管理 > 企业微信”页面,点击“添加企业微信”。 | + | 例如:http://kefu.easemob.com/v1/weixin/qyapi/ww260548d3ed1daa2f/1000006/callback |
- | {{:cs:300visitoraccess:enterprisewechat-addchannel_1.png?nolink|添加企业微信}} | + | 修改对应的corpId和agentId |
+ | corpId【客户企业微信的**企业id** 】 | ||
+ | agentId【客户应用id】 | ||
+ | <code html> | ||
+ | 查询方法 | ||
+ | SELECT * from weibotechchannel where channelType='qywx' and appName='dk6d65977460643ea2' and serviceWeiboNumber='ww1b3c5b1d59bdc231'; | ||
+ | 表中clientId字段即为客户应用id | ||
+ | </code> | ||
- | 2. 在“添加企业微信”页面,填写第一步中获取到的“企业微信名称”、“企业微信ID”、“应用ID”和“应用密钥”,并点击下一步。 | + | 红框部分:千万不要改动!千万不要改动!千万不要改动!【都用的同一套token值】修改之后,需要去数据库修改 |
- | {{:cs:300visitoraccess:enterprisewechat-basicinfo.png?nolink&600|填写企业微信的基本信息}} | + | c. 点击完成之后,需授权成员敏感信息,修改后需要客户再次在企业微信同意【需通知客户进行授权】 |
- | 3. 获取环信生成的服务器URL。 | + | {{:cs:300visitoraccess:点击授权敏感信息.jpg?nolink&800|}} |
- | {{:cs:300visitoraccess:enterprisewechat-binding.png?nolink&600|生成服务器URL}} | + | **3. 提交上线** |
- | **第3步:配置企业微信的消息推送。** | + | {{:cs:300visitoraccess:6待开发应用上线.jpg?nolink&800|}} |
- | 进入企业微信管理后台,配置企业微信应用的消息推送。然后,将企业微信应用的Token(令牌)和EncodingAESkey填入环信客服云,完成企业微信的配置。 | + | 选择上线授权模版 > 选择应用上线 |
- | 1. 进入企业微信管理的“企业微信平台 > 应用管理 > 应用 > 设置API接收”页面,在“接收消息”区域,点击“设置API接收”,填入上一步生成的服务器URL,设置Token(令牌),并生成EncodingAESkey,点击"保存"。 | + | {{:cs:300visitoraccess:7提交上线.jpg?nolink&800|}} |
- | {{:cs:300visitoraccess:enterprisewechat-setapi.png?nolink&400|配置企业微信应用的消息推送}} | + | **4. 等待审核结果及上线** |
- | {{:cs:300visitoraccess:enterprisewechat-apireceive.png?nolink|配置企业微信应用的API接收地址}} | + | |
+ | 企业微信审核通过之后,需要点击提交上线 | ||
- | 2. 进入环信客服云,填写企业微信应用的Token(令牌)和EncodingAESkey,并点击下一步,完成绑定企业微信。 | + | {{:cs:300visitoraccess:审核完成_提交上线.jpg?nolink&800|}} |
- | {{:cs:300visitoraccess:enterprisewechat-bindingsuccess.png?nolink&600|绑定企业微信}} | + | 上线成功后,通知客户修改应用权限,客户登录客户的企业微信后台 > 应用管理,可以看到应用 > 修改应用可见范围 |
- | {{:cs:300visitoraccess:enterprisewechat-bindingsuccesspage.png?nolink&600|绑定企业微信成功}} | + | {{:cs:300visitoraccess:编辑应用可见范围.jpg?nolink&800|}} |