连接飞书或 Lark
用飞书妙记的转写稿，让人群以真实的客户通话为依据。由你们的管理员在自己的飞书组织里创建一个免费应用，几分钟就能完成，访问权限完全掌握在你们自己手里。
团队录过的每一场会议，转写稿都存在飞书妙记里。连上妙记，人群回答问题时就能用上客户真正说过的话。
这一页同样适用于 Lark。Lark 和飞书是同一款产品，只是跑在各自独立的服务器上，在一边注册的应用读不到另一边的数据。所以 iMario 会根据你贴的链接判断你用的是哪一个，你不用另外选：feishu.cn 链接走飞书，larksuite.com 链接走 Lark。平时用哪个后台，就在哪个后台里创建应用（open.feishu.cn/app 或 open.larksuite.com/app）。
飞书的应用只能在一个组织内使用，所以没有现成的 iMario 公共应用可以直接授权。需要你们自己的管理员在飞书里建一个应用，iMario 用它读取数据，而且只读你指定的内容。建应用不花钱，几分钟就能完成，访问权限也始终由你们自己掌控。
管理员一次性配置
-
打开 Open Platform console（开发者后台，飞书是 open.feishu.cn/app，Lark 是 open.larksuite.com/app），创建一个 custom app（企业自建应用）。名字起一个同事一看就认得出的，比如“iMario”。
-
在凭证与基础信息（Credentials & Basic Info）里，复制 App ID 和 App Secret。iMario 要你填的就是这两个值。
-
在安全设置（Security Settings）里添加下面这个回调地址，一个字符都不能差：
https://api.imario.ai/api/connections/callback -
在 Permissions & Scopes（权限管理）里，按下面的权限代码逐个搜索并添加。不管后台界面是什么语言，权限代码都一样：
权限代码 英文名称 minutes:minutes.basic:readObtain basic information of Minutes minutes:minutes.transcript:exportExport minutes transcript text content 这两项要加在 user identity（用户身份权限）下，不要加在应用身份下。也别用
minutes:minute:download，这是旧版权限，飞书已经不再对新应用开放。 -
在 Version Management & Release（版本管理与发布）里创建一个版本并提交。企业管理员审核通过后，应用就在你们组织内上线了。
这个应用只有你们组织内部能用。飞书里凡是下一步没有指定的内容，iMario 一概看不到。
在 iMario 里连接
- 在 Create audience 里点击 Connect a data system，选择 Feishu。
- 粘贴第 2 步复制的 App ID 和 App Secret。
- 粘贴要用的每条妙记的链接，一行一条。在飞书里打开那条妙记，复制地址栏里的网址就行，格式类似
https://acme.feishu.cn/minutes/obcn…。 - 点击 Connect to Feishu，在飞书自己的页面上确认授权。
- iMario 会逐条读取这些链接，列出每条妙记的真实标题和时长，方便你确认有没有贴错。勾选要用的妙记，再点击 Import。之后新录的会议，要重新连接一次，把它们的链接贴进来。
为什么要贴链接，而不是从列表里选
飞书的 API 能查询你指定的某一条妙记，但没有能列出某个人全部妙记的接口。与其去猜，iMario 干脆请你直接提供链接。以后想加更多，重新连接一次，贴上新链接就行。
iMario 读取的内容
只读你贴进来的那些妙记，每条只读标题、时长和转写文字。你的其他妙记、文档、聊天记录和日历，一概不读。iMario 也不会往飞书里写入任何内容。
飞书的转写稿会标出说话人的名字，但不提供他们的邮箱地址。所以飞书录制影响的是整个人群的说话方式，不会归到某一个人名下。想把某段话对应到具体某位客户，就要用带邮箱地址的数据来源，比如问卷导出文件，或者带参会人信息的 Zoom 录制。
问题排查
链接旁边显示“Could not be read”（无法读取），或者同步后提示“you do not have permission”。令牌里没有妙记相关的权限。可能是没加权限（第 4 步），可能是版本没发布（第 5 步），也可能是你连接之后才加的权限。如果是最后这种情况，在 iMario 里移除这个飞书来源，再重新连接。
授权页提示应用不可用。版本还没审核通过，需要企业管理员在飞书或 Lark 的管理后台里审批，而不是在开发者后台里。
提示“App not found”，或者授权页的域名不对。应用建在了一个后台里，链接却指向另一个。在飞书上注册的应用不能给 Lark 租户授权，反过来也一样。妙记链接是哪一边的，就在哪一边的后台里创建应用。
文件里没有转写稿。这条录制在飞书里本身就没有转写稿。只有录制时开启了转写的会议，妙记才会生成转写稿。