钉钉应用
一、功能介绍
推送领星ERP消息至钉钉，在钉钉接收消息并可完成单据审批。
二、操作流程
1.第一步：创建钉钉内部应用
步骤1：点击“创建应用”
进入钉钉开放台（https://open-dev.dingtalk.com/），选择“企业内部应用-钉钉应用”，点击创建应用
应用名称：领星ERP
应用描述：跨境电商ERP管理系统，为跨境卖家提供数字化解决方案，助力实现精细管理和业务增长。
应用图标：上传下图领星ERP的图标
步骤2：添加网页应用能力，维护网页应用信息
点击添加网页应用，配置后维护好以下信息：
应用首页地址：https://erp.lingxing.com/dingTips?corpid=$CORPID$
PC端首页地址：https://erp.lingxing.com/dingTips?corpid=$CORPID$
（若为独立部署环境，请将链接中的“erp”更改为自己的领星域名）
步骤3：填写安全设置
服务器出口IP：出口IP内容请联系您的专属顾问获取
重定向URL：https://audit.lingxing.com,https://audit.lingxing.com/approvalDetail
端内免登地址：https://audit.lingxing.com,https://audit.lingxing.com/approvalDetail
填写完成后点击“保存”。
步骤4：申请权限
在“权限管理”页面，点击“申请权限”申请以下权限：通讯录部门信息读权限、通讯录部门成员读权限、成员信息读权限、企业已安装的应用列表查询权限、微应用后台免登访问权限。
权限范围：全部员工
步骤5：创建并发布版本
至少发布一个版本，使应用状态转为【已上线】后，企业中其他成员方可使用应用。
版本发布成功后，应用为【已上线】状态。
2.第二步：企业授权、用户匹配
领星授权钉钉的企业信息及应用信息获取页面：钉钉内部应用-领星ERP
（1）企业授权：将领星和钉钉的企业关联起来
打开领星ERP，进入“设置-业务配置-全局-钉钉授权”页面，填写钉钉的企业及应用信息，该信息在以下页面获取：钉钉开放平台（https://open-dev.dingtalk.com/）的“应用信息”页面。
填写后点击保存。
领星ERP填写页面：
钉钉的企业及应用信息获取页面：
企业信息：点击右上角的头像，鼠标悬浮在“CorpId”上，可复制“CorpId”
应用信息：在"凭证与基础信息"页面和“网页应用”页面，可复制“AgentId”、“Client ID(AppKey)”、“ClientSecret(AppSecret)”。
（2）用户匹配：将企业下领星的用户和钉钉的用户关联起来
在领星ERP“用户管理-授权钉钉”进行用户匹配。选择钉钉用户进行匹配。
3.第三步：消息设置开启“钉钉”消息通知类型
需在钉钉接收消息的用户，都要自行在消息中心-消息设置中打开消息推送，消息中心设置仅对该用户账号生效。
在领星ERP的“消息中心-消息设置”页面开启需要在钉钉接收的消息类型
至此，钉钉授权完成，可以在钉钉上接收领星ERP的消息。
4.在钉钉接收领星消息
（1）接收消息
企业授权、用户匹配、消息设置完成后，后续领星的新消息就会同步到钉钉
（2）审批单据
如果单据需要审批，会在消息下方有“查看详情”按钮，点击“查看详情”，可查看完整的单据信息并进行审批操作
5.日常：修改用户的钉钉账号
在领星ERP-用户管理页面，点击“编辑“用户信息，然后修改该用户的“授权钉钉”信息
三、常见问题
Q1:获取钉钉企业agentId列表失败?
A1:需排查以下情况：
检查是否有对应接口的调用权限。
解决办法：核对接口权限数据，申请开通截图中红色标记的所有接口权限。参考上文的【第一步：创建钉钉内部应用 - 步骤4】
检查访问ip是否在白名单之中。
解决办法：您可以联系对接的实施顾问获取出口IP，填写至钉钉自建应用中。参考上文的【第一步：创建钉钉内部应用 - 步骤3】
Q2:获取钉钉企业accessToken失败？
A2:报错原因：无效的clientId和clientSecret
解决办法：核对钉钉应用的clientId和clientSecret，更新ERP【业务配置】页面的钉钉配置信息。参考上文的【第二步：企业授权】
Q3:获取钉钉企业所有部门信息失败/用户管理页面无法加载钉钉用户？
A3:报错原因：请求的部门id不在授权范围内。
解决办法：钉钉应用的权限管理设置为【全部员工】，参考上文的【第一步：创建钉钉内部应用 - 步骤4】
未能解决你的问题？请联系在线客服