需通过钉钉开放平台完成应用配置与嵌入:一、创建自建应用获取appkey/appsecret;二、配置回调域名、jsapi权限及服务器ip白名单;三、设置微应用首页url并关联appkey;四、发布应用并添加至工作台;五、验证免登及组织架构同步。

如果您希望在钉钉工作台中直接使用神鲸办公,需通过钉钉开放平台完成应用配置与嵌入。以下是实现神鲸办公在钉钉工作台嵌入使用的具体操作步骤:
一、在钉钉开放平台创建自建应用
该步骤用于获取应用唯一标识及权限配置入口,是后续嵌入的前提条件。只有完成此配置,钉钉才能识别并加载神鲸办公服务。
1、使用企业管理员账号登录钉钉开放平台,进入「应用开发」→「企业内部应用」→「创建应用」。
2、填写应用名称为神鲸办公,选择应用可见范围为企业全部成员,并点击「创建」。
3、在应用详情页的「基本信息」中,记录下AppKey和AppSecret,后续对接身份验证时必需使用。
二、配置神鲸办公回调域名与JSAPI权限
该步骤确保神鲸办公前端页面可在钉钉内安全调用钉钉原生能力(如扫码、定位、通讯录等),同时满足钉钉对HTTPS域名的强制要求。
1、在钉钉开放平台应用详情页,进入「开发管理」→「应用开发信息」→「服务器出口IP」,将神鲸办公服务端部署所在服务器的公网IP添加至白名单。
2、在「功能管理」中开启JSAPI权限,勾选「dd.ready」「dd.runtime.permission.requestAuthCode」「dd.biz.contact.complexPicker」等常用接口。
3、在「开发信息」→「可信域名」处,填入神鲸办公Web端使用的HTTPS域名(例如:https://office.shenjing.com),每行一个,保存后需等待5分钟生效。
三、设置神鲸办公微应用首页地址
该步骤定义钉钉工作台点击神鲸办公图标后实际打开的页面URL,必须为符合钉钉微应用规范的H5地址,并携带有效鉴权参数。
1、登录神鲸办公管理后台,在「系统集成」→「钉钉对接」中启用钉钉集成模式。
2、将钉钉开放平台中生成的AppKey粘贴至神鲸办公对应字段,并保存配置。
3、复制神鲸办公提供的标准微应用入口URL(格式类似:https://office.shenjing.com/dingtalk/auth?appKey=xxx),粘贴至钉钉开放平台「开发管理」→「应用开发信息」→「微应用首页」栏位。
四、发布应用并添加至钉钉工作台
该步骤使神鲸办公图标正式出现在企业成员的钉钉工作台中,且仅对企业内部成员可见,无需上架钉钉应用市场。
1、在钉钉开放平台应用详情页,点击「上线应用」→「立即发布」,选择发布范围为当前企业,确认提交。
2、使用企业管理员账号打开钉钉PC端或手机端,进入「工作台」→右上角「编辑」→「添加应用」→搜索神鲸办公,点击「添加」。
3、在「应用排序」中将神鲸办公拖动至常用位置,保存后所有授权成员的工作台即可看到该图标。
五、验证用户免登与组织架构同步
该步骤确认钉钉用户点击图标后能否自动登录神鲸办公,且其部门、角色、手机号等信息是否与钉钉保持一致,避免重复维护账号体系。
1、使用任意企业成员账号在钉钉工作台点击神鲸办公图标,观察是否跳转至已登录状态的神鲸办公首页。
2、进入神鲸办公个人中心,核对显示的姓名、部门、手机号是否与钉钉个人资料完全一致。
3、在神鲸办公「组织管理」界面,检查是否存在钉钉中已激活的部门结构及成员列表,若缺失则需在神鲸后台触发「同步钉钉组织架构」手动拉取。










