钉钉集成

如果你的团队正在使用钉钉，在钉钉工作台安装维格表，无需切换浏览器，在钉钉里登录维格表，并完成业务流转，这将大大提升团队协作的效率。以下是通过钉钉自建应用并委托维格云服务商开发的模式，钉钉的集成操作步骤教程，请仔细阅读：

钉钉自建应用

1. 去钉钉管理后台创建自建应用

• 电脑打开钉钉，左下角进入管理后台

• 工作台创建自建应用

  
  

  
  
  

  
  

• 配置自建应用：应用开发>企业内部开发>创建应用

选择创建 H5 微应用，名称跟描述可以乱输，开发方式选择「委托服务商开发」，确定创建

输入服务商CorpId：dingc7ad99cf1e0ad49a35c2f4657eb6378f

查找服务商并点击授权

• 维格侧到钉钉开发后台-定制服务商配置

  
  
  

地址格式: https://域名/user/dingtalk/login?corpId={corpId}&agentId={AgentId}

这里corpId 是企业应用的ID

配置变量

创建应用后,在维格侧到钉钉开发后台-定制服务商配置

#backend-server 环境变量, 值在维格定制应用里
DINGTALK_ENABLED=true
DINGTALK_AGENT_ID=3xxxxxx                         # 应用凭证与基础信息 AgentId
DINGTALK_AGENT_CUSTOM_KEY=suitexxxxxxx.           # 应用凭证与基础信息 CustomKey
DINGTALK_AGENT_CUSTOM_SECRET=56D2O-Jxxxxxxxxx     # 应用凭证与基础信息  CustomSecret
DINGTALK_AGENT_CORP_ID=ding4xxxxxxxxxx            # 应用corpId
SKIP_USAGE_VERIFICATION=false                     # 空间站订阅设置不跳过

管理员绑定空间站

• 返回钉钉客户端，切换组织，搜索刚创建的应用

  
  

  
  
  

  
  

• 绑定空间站，就创建成功啦

  
  

  
  
  

  
  

同步通讯录

• 进入钉钉后台，点击工作台

  
  

  
  
  

  
  

• 找到需要同步通讯录的自建应用，点击设置

  
  

  
  
  

  
  

• 版本管理与发布，可选择可见范围

• 设置之后保存，返回空间站驾驶舱>成员与小组，同步通讯录

  
  

  
  
  

  
  

FAQ

Q: 钉钉管理员第一次登录时,卡在提示绑定空间. 但用户没有空间站,要怎么操作.

• 维格侧到钉钉开发后台-定制服务商配置将地址改为: https://域名/workbench

  
  

  
  
  

  
  

• 钉钉管理员重新进入应用, 创建空间站

  
  

  
  
  

  
  

• 维格侧到钉钉开发后台-定制服务商配置将地址改为: https://域名/user/dingtalk/login?corpId={corpId}&agentId={AgentId}

• 钉钉管理员重新进入应用,绑定空间站

  
  

  
  
  

  
  

• 需要客户提供服务器出口ip

  
  
  

  
  

• 数据迁移：Saas环境数据迁移至客户环境用。由于集成后的钉钉账号没有token，需要用下面的方式

  1. 使用test账号迁移模板到客户环境

     https://vikadata.feishu.cn/docs/doccnnU5dCZNwED8qsGTox47TVe

  
  

  2. 分享模板-可另存的方式

  
  

  3. 将分享链接通过下面的方式转化，让客户在钉钉内打开此链接，保存至集成绑定的空间站即可。

  格式：dingtalk://dingtalkclient/page/link?url=xxxxx&pc_slide=true

  其中xxxxx要换成url转码，可以通过https://tools.fun/url.html这个地址进行转码

  例如：dingtalk://dingtalkclient/page/link?url=http%3A%2F%2F192.168.11.59%2Fshare%2FshrmegrVlcg8KZ7cPj5hz&pc_slide=true

4. 绑定空间站页面地址

https://域名/user/dingtalk/social_bind_space