飞书

公司用飞书的话,可以把飞书接成登录方式:同事用飞书账号登录,一次接入,组织里所有应用都跟着走——包括接入之前就已经发布的那些。

接入

需要贵司飞书管理员在飞书开放平台建一个企业自建应用,再把凭证填到控制台。整个过程十分钟左右,只做一次。控制台里是三步:左边组织设置 → 企业账号与通知卡片 → 接入飞书,第一步就是下面这份清单(回调地址就印在清单里),第二步粘贴凭证,第三步你自己先登录一次。

飞书那边(open.feishu.cn/app):

  1. 创建企业自建应用。名字随意,比如「观思动登录」。
  2. 应用功能 → 打开「网页」。
  3. 权限管理 → 开通这四项:获取用户基本信息、获取用户 user ID、获取用户邮箱信息、获取用户手机号。前两项必须开;后两项强烈建议开——有了邮箱和手机号,已经在组织里的同事会自动对上原来的账号,应用里选人也能按真名搜。
  4. 开发配置 → 安全设置 → 重定向 URL:填接入向导第一步里显示的回调地址,逐字一致。
  5. 应用发布 → 版本管理与发布:创建版本、发布,并把可用范围设成全员或相应部门。没发布,或者可用范围没包含某位同事,那位同事登录时会看到「你还没有这个应用的使用权限」——去可用范围里加上就好。
  6. 凭证与基础信息:复制 App ID 和 App Secret。

控制台这边:向导第二步粘贴 App ID 和 App Secret,保存。第三步点「我先登录一次」——用你自己的飞书账号走一遍登录:能进来,就说明飞书那边的重定向 URL、可用范围和版本都对了;配错了你会当场看到原因,不用等同事来报。这一步会把你的飞书账号绑到你现在的控制台账号上,回来仍在组织设置这一页。

接好之后卡片是一张就绪清单:凭证、首次登录、消息推送、按钮回调、新同事,每行一个状态,差哪一步写在那一行上。

卡片上有两个开关,默认都开着。首次登录自动加入组织——没在组织里的同事第一次用飞书登录就自动成为成员;关掉的话,只有管理员先邀请过(填了对方的飞书邮箱或手机号)的人才进得来。每次登录时更新姓名——用飞书里的姓名,同事在飞书改了名,控制台跟着变。新同事默认是开发者档——能登录用应用,也能自己建应用;只想让他们用、不建的话,在卡片上改成使用成员。档位以后照旧在控制台权限页调,见成员、角色与负责人。

消息推送

接了飞书之后,应用还能给同事推通知——一张飞书卡片,带深链、可以带按钮,同事在飞书里直接点「通过」「退回」,结果回到应用里。这个不需要在控制台配置,在对话里直接提需求就行,详见通知与定时任务。飞书那边要多做两步:

  1. 应用能力 → 添加应用能力 → 机器人:开启。权限管理再开通「以应用的身份发消息」(im:message:send_as_bot);建议同时开通「通过手机号或邮箱获取用户 ID」(contact:user.id:readonly),这样还没用飞书登录过的同事也能收到第一条通知。改完要发布新版本才生效。
  2. 要用按钮的话,卡片上「按钮回调」一行点「填写 Verification Token」,照上面的顺序做——顺序重要:先到飞书应用的开发配置 → 事件与回调 → 加密策略复制 Verification Token,粘贴到控制台并保存(Encrypt Key 留空);再到回调配置把「请求地址」设为那一行显示的回调请求地址,订阅「卡片回传交互」。飞书在你保存请求地址的那一刻就会来验证,控制台得先认得这个 Token 才答得上——反过来做,飞书那边会报验证失败。验证通过后,那一行会显示验证时间。

卡片上的消息推送一行会写明当前通不通;「给我发一条测试消息」发给你自己,立刻能看到效果。

同事的入口

接好之后,同事打开任何一个应用都会直接跳到飞书登录,登完就进应用——已经登录着飞书的浏览器里几乎无感。也可以把卡片上的登录地址放进飞书工作台,同事从工作台点进控制台。

已经用手机验证码或邮箱登录过的同事不用重新加:飞书里的邮箱或手机号能对上,就还是原来那个账号,档位和权限都不变。

不要删掉重建那个自建应用

飞书给每个应用发的成员身份是按应用算的。把应用删了重建,所有同事在飞书里的身份都会换——能靠飞书里的 user ID 自动对回来,但没必要冒这个险。改名、改权限、换 Secret 都不需要重建。

不在飞书里的人

外包、顾问这类不在贵司飞书里的人,仍然可以用手机验证码登录控制台,登录之后再打开应用即可。

公司用的是钉钉的话,看钉钉;用企业微信的话,看企业微信。