源雀SCRM【开源免费版】工具技术手册

如有包括但不限于以下需求，可随时通过源雀官方企微联系我们：

1. 获取源雀SCRM完整体验系统
2. 源雀SCRM商务合作
3. 源雀SCRM产品交流
4. 更多咨询或服务...

注:开源版为简单的企微营销小工具，商业版是一套完整的企微SCRM私域营销系统

开源版下载地址:

1. gitee: https://gitee.com/iyque/iYqueCode
2. gitcode: https://gitcode.com/iyque/iYque

1. 注意事项

• 为了保证用户体验以及避免滥用，企业仅可在收到相关事件后20秒内调用，且只可调用一次。
• 应用所使用的域名备案主体需要与企微的认证主体一致。
• 如果企业已经在管理端为相关成员配置了可用的欢迎语，则推送添加外部联系人事件时不会返回welcome_code。
• 如果欢迎语已成功下发给客户，应用再调用该接口时，将返回41051（externaluser has started chatting）。长期未登录企业微信的成员无法发送欢迎语。
• 每次添加新客户时可能有多个企业自建应用/第三方应用收到带有welcome_code的回调事件，当多个应用同时调用发送欢迎语接口时，仅最先调用接口的应用可以成功，其他应用返回41096(welcome msg is being distributed)错误。请注意，返回41096错误码表示当前已有其他应用正在发送欢迎语，不代表欢迎语已经下发成功，存在下发失败的可能性，故调用方可以重试；如果返回了41051，则代表欢迎语已成功下发，无需重试。为了保证用户体验，请根据实际业务需求，合理配置应用可见范围。
• 如果添加完客户，需要双向删除，才可重新出发欢迎语。

2. 应用配置

2.1 企微后台自建应用构建

注:可见范围需要选择到部门级，如果选择只是员工，则无法拉取数据。

2.2 自建应用绑定客户

2.3 参数获取

2.3.1 企业id

2.3.2 应用Id与应用Secert:

2.3.3 ip白名单:

注:可信域名与ip配置(注:域名备案主体需要与企业微信认证主体一致)

2.3.4 回调配置:

3.AI会话存档

• 事件事件服务器:直接跟自建应用的回调地址配置一样即可。当前功能的作用主要是有客户消息发送过来后接受企业微信通知及时更新。
• 可信ip配置应用服务器的ip即可。

3.1 消息公私钥

(在线生成地址:http://web.chacuo.net/netrsakeypair/)

会话存档sdk下载地址:https://developer.work.weixin.qq.com/document/path/91774

文件下载后放服务器上，然后指定文件的绝对路径即可。

4.企微客服接入deepseek

• deepseek相关配置见,后端部署[3.deepseek配置]
• 回调需要配置同,见当前文档[2.3.4 回调配置]

4.1 企微客服设置

• 自建应用与客服绑定
• 创建客服账号
• 绑定客服账号与应用

5.投诉管理

• 按照前端部署文档需部署mobile

iyque:
  complaintUrl: http://iyque.cn/openmobile/customerComplaint #投诉反馈移动端访问页面

complaintUrl中 http://iyque.cn 替换为您的前端访问路径

• 企微后台添加员工对外专属信息入口(如:反馈)
• 企业微信app端 注:点击跳转地址配置成:[https://iyque.cn/openmobile/customerComplaintForm], 其中[https://iyque.cn]替换成您的访问前缀