KOK电子登录 Language
搜索
搜索
img
产品中心

使用集简云时飞书(自建应用)常见问题与解决方案

产品描述
时间:2022-08-15 08:19:13 作者:kok娱乐平台 来源:KOK电子登录
[产品参数]

  通过集简云无代码集成平台,无需开发就可以将飞书(自建应用)无缝集成到各种第三方应用系统,例如:OA办公系统,客户服务系统,MySQL数据库,企业微信,表单系统,CRM等数十款应用系统,以及企业内部系统进行数据同步与功能执行。

  如果遇到“通讯录动作”出现问题,请点击以下链接,参考【通讯录常见问题】相关文档

  通讯录模块目前包含成员、部门、用户组等几大模块,每个模块都会提供对应的api接口,便于开发者进行智能化的系统对接。开发者对于接口的使用权限主要分为三类:

  3)数据字段的权限。由于某些实体(如用户)不同字段的敏感度不同,如用户的手机号,相对比较敏感,要获取就需要额外的权限。

  基于上述三个权限的认知,开发者在进行开发时,可以自行检查,提高开发效率。自行检查确认点为:

  2)获取或操作某数据时,是否有该数据的通讯录权限,如果没有,会提示无权限;

  3)获取某实体的具体字段时是否有该字段的权限,如果没有,可能会获取不到。

  ·tenant_access_token基于应用的通讯录范围进行权限的过滤,如调用接口获取部门 A 时,会检查部门 A 是否在应用的通讯录权限范围内。其规则配置入口为:Admin管理后台/工作台管理/应用管理。

  ·user_accss_token基于用户的可见组织架构范围来做权限过滤,用户可见的组织架构范围为app端上“通讯录”“组织架构”部分可见的架构,其规则配置入口为:登陆Admin管理后台,进入“安全”“用户权限”--“组织架构可见范围”。

  飞书目前没有单独的接口可以获得全部员工信息,如果需要获取,可以按照以下的步骤操作确认:

  ·确认应用通讯录范围是否为全员,请保证开启为全员。如果不是全员,可能无法获取到全员信息。

  ·确认通讯录范围为全员后,通过获取部门信息列表接口,设置参数parent_department_id=0,fetch_child=true。获取企业下所有部门ID列表。

  ·在步骤2获取部门ID列表的基础上,通过获取用户列表等接口搭配使用,来获得全部员工的相关信息。

  首先请确保应用的通讯录权限范围设置为“全员”或包含根部门下的所有员工,然后通过获取用户列表接口,设置参数department_id=0,获得根部门下的员工通讯录信息。

  1)设定好了权限及权限使用的范围,但是仍然获取不到user_id、邮箱、手机号等信息

  这里因为user_id、邮箱、手机号等信息比较敏感,需要单独申请相应的权限,无法仅仅通过“获取用户信息权限”这一个权限来获得。详情请参考应用权限文档。

  不一样。open_id 是用户在应用内唯一标识,因此同一个用户在不同应用中的 open_id 不一致

  你可以在创建用户将该用户在企业内部系统已存在的唯一 ID 指定为user_id,若不指定将由系统自动为用户生成一个唯一的随机 ID 作为user_id,已创建用户的 user_id(部分场景也叫 employee_id)不支持更新,因为各应用方都可能用到并保存 user_id, 如果修改 user_id 可能造成应用感知不到,从而造成应用无法使用等问题。

  可以通过email或mobile换取,换取方式见接口使用手机号或邮箱获取用户 ID 或者 登录管理后台,点击用户详情,查看获取“用户 ID”。

  1)我一不小心误删了部门(或者人员),能不能按照原有的 ID 进行恢复?

  可以将该字段对应的数字转化为二进制,对应位数就是对应的值的状态。对照:bit0(最低位): 1冻结,0未冻结;bit1:1离职,0在职;bit2:1未激活,0已激活例:数字“2”转化为二进制就是“010”,意味着“已激活、离职、未冻结”;而数字“0”转化为二进制就是“000”,意味着“已激活、在职、未冻结”。

  3)我开发了多个应用,想知道其中某个应用的用户是否也在使用我开发的其他应用。可以通过什么字段来判断?

  目前可以使用字段 union_id,一个用户在同一个开发者所属的多个应用中,union_id 唯一

  确认你能在飞书客户端的搜索栏中搜到对应用户,且该用户不是外部用户或离职人员

  5)调用手机号或邮箱获取用户 ID/获取用户信息接口时,为什么只能获取自己的,不能获取其他人员的?

  请确认相关应用的通讯录权限范围包含包含要获取的用户,而不是只有你自己,如果通讯录范围不包含获取的用户,会返回邮箱或手机号不存在。

  7)系统默认生成的userid,业务方保存userid,删除A员工之后,这个userid会不会被后面新增的员工占用?

  系统默认生产成的 userid ,保证了企业内有效(无效表示已离职用户)用户唯一,开发者或管理员对用户进行删除,添加,可能会存在新添加的用户的 userid 和历史上已经删除的用户一样。所以建议增加用户的时候,用具有唯一性标示的id作为 userid ,避免造成困扰(注:部门的自定义ID同理)。

  1) 创建用户接口 或者 获取单个用户信息 接口请求或应答的结构体内的自定义字段应该如何理解?

  用户的 custom_attrs 属性是对用户属性的扩展,用于企业根据自身需求灵活扩展用户描述能力,根据取值语法的不同主要分为文本类型、网页类型、枚举类型、图片类型、用户类型。

  网页类型: 字段引用链接,可在成员名片页实现点击跳转效果。该类型字段需要有标题文字,值对应 text 字段,需要有跳转的 url ,值对应 url 。由于PC 端的跳转链接可能会和移动端不太一样,所以单独设置了 pc_url 作为跳转的url,如果该值不填,则 PC 端链接使用 url。

  枚举类型:实现字段取值在给定选项中选择,如员工类型,包含正式、外包、顾问。企业成员的员工类型,只能在这些选项中选择,该类型的值对应 option_id ,也就是管理员配置的某个选项 key 。

  图片类型与枚举类型相似,只是选项的数据类型只能是图片,用于在成员名片页展示其对应的图片,该类型的值对应 option_id,可从管理后台查询对应的图片id。

  用户类型该类型主要用于成员名片页展示对另一用户的引用,实现成员名片页之间的跳转,如将“张三”的 HRBP 字段显示“李四”并支持点击跳转至李四的名片页。对应generic_user 下 id 为需要引用的成员 user_id, generic_user 下的 type 目前固定为1,表示用户类型。

  特殊说明:请确保你的组织管理员已在 管理后台/组织架构/成员字段管理/自定义字段管理/全局设置 中开启了“允许开放平台 API 调用“,否则该字段不会生效/返回。如果创建或更新需要对用户新加自定义字段的值,请确保自定义字段的 key 已经被企业管理员创建且有效。

  创建用户接口中 enterprise_email 字段表示设置用户的企业邮箱,由于企业邮箱的域名需要企业在管理后台申请并开启。如果企业没有开启对应域名的企业邮箱,设置用户的企业邮箱会操作失败,请联系企业的管理员确认企业是否在后台启用了该域名的企业邮箱。

  该接口的设计含义是获取某个部门下的直属用户列表,由于数据的获取受到通讯录权限范围的检查,如果请求带上了部门ID(根部门的部门ID为0),首先会检查应用是有该部门ID的通讯录权限,如果有,就会返回该部门下的直属成员信息(如果带上了department_id=0 表示 check 有没有根部门的通讯录权限,有的话,返回根部门下直属成员信息);如果请求没有带上部门 ID,无法进行 ID 的通讯录权限校验,就会获取到权限范围内的独立成员(当权限范围包含了某成员,但不包含成员所在部门,则该成员视为权限范围内的独立成员)。所以开发者在使用该接口时,应该结合通讯录的权限以及要获取的数据,来决定如何使用,要不要带部门 ID。

  目前不能通过一个接口来获取父部门下所有员工的通讯录信息,需要通过获取部门信息列表接口获取父部门下所有部门的department_id,然后通过获取用户列表接口获取每个部门下员工的通讯录信息。

  2)为什么获取获取部门信息接口获取到 department_id 有时候返回的带 od-,有时候不带?

  答:接口语义是获取部门下的子部门信息,由于数据的获取受到通讯录权限范围的检查,如果请求带上了父部门 ID(根部门的部门 ID 为0),首先会检查应用是有该部门 ID 的通讯录权限(如果带上了0,会校验是否有全员权限),如果有,就会返回该部门下部门(根据 fetch_child 为 true 或 false 来决定是否递归)信息;如果请求没有带上父部门 ID,无法进行 ID 的通讯录权限校验,就会根据通讯录权限范围返回数据,如果通讯录范围是全员,就会返回单个根部门 ID 0(开发者可以通过根部门 id 继续请求),否则返回通讯录范围的部门信息。所以开发者在使用该接口时,应该结合通讯录的权限以及要获取的数据,来决定如何使用,要不要带父部门 ID。

  1)使用批量获取信息接口的时候,只返回了部分信息,没有返回全部批量信息。但为什么接口仍会提示任务执行成功, msg 也会返回“success”?

  批量接口的返回值是指当前批量任务的执行情况,意味是否执行,而非是否执行成功。只要能开始执行都会记为“执行”。详细的执行情况可以参考查询批量任务执行状态文档。

  参数错误,具体错误原因可参考 message 信息和表下面的补充,如有疑问,请联系管理员;

  手机号和邮箱冲突,检查对应的手机号和邮箱有没有分属于两个不同的飞书账号,如果存在就需要修改其中一个手机号/邮箱,或者注销掉其中一个账号;

  手机号和邮箱分别注册了两个不同的账号后,手机号和邮箱实际上是对应登录凭证不同的两个账号。在新增用户时同时设置了之前的手机号和邮箱,就会将手机号和邮箱同时作为登录凭证关联到一个账号,但是之前邮箱和手机号分别在飞书注册了是两个不同的凭证,就会报上面的错误。解决方案是新增的时候只设置手机号,再去更新邮箱,这样邮箱只是作为一个“属性”而不是登录凭证,或者引导用户注销掉其中一个账号。

  如果遇到“消息类动作”出现问题,请点击以下链接,参考【消息与群组 常见问题】相关文档

  企业自建应用是指在同一个租户内可以使用的应用,通常情况下,飞书开放平台推荐使用企业自建应用来满足所需功能。

  应用商店应用和ISV应用是指注册在应用商店中多个租户都可以使用的应用。创建应用商店应用需要单独进行申请,参见:申请成为飞书ISV

  飞书的OpenAPI开放能力基于Restful接口对外提供服务,为了方便开发者快速体验和测试各类接口,我们提供了Postman的接口模版,在 Postman模版使用说明中描述了如何利用Postman工具来调试飞书的OpenAPI接口。

  如果在使用postman进行接口调试后没有问题,就说明调用接口的参数是正确的。

  想要获取chat_id,可以通过一些OpenAPI的接口,我们有以下接口能够获取chat_id:

  打开飞书开放平台主页,点击 我的后台-开发者后台,选择自己的机器人应用,在左侧导航栏的应用功能-机器人标签页中,点击启用机器人能力

  注意:请确认你选择了正确的机器人应用,以及正确的环境(BOE/Online/海外)

  3)webhook自定义机器人是什么? 我应该怎么通过webhook机器人发消息?

  自定义机器人只能用于在群聊中自动发送通知,不能响应用户@机器人的消息,不能获得任何的用户、租户信息。

  我们还提供了一系列机器人相关使用场景的教程,参见消息与群组概述 中的开发教程

  请确认你的应用配置了订阅事件网址,并且订阅了“接收消息”事件,才会出现对线)怎么实现机器人@人(@所有人、@指定人)?

  在机器人发送的普通文本消息(text)、富文本消息(post)、消息卡片(interactive)中,可以使用at标签实现@人效果。

  对于自定义机器人,由于不具有通讯录信息的访问权限,只支持使用 open_id @指定人,或 @所有人,不支持使用 user_id、email @指定人。请注意自定义机器人本身不能调用接口获取用户的open_id,或直接通过用户的邮箱、手机号来@人(恶意开发者可能用这种方式扫出群成员的头像、姓名等隐私信息)。自建应用与商店应用则没有此限制。你可以参考此教程,以任意应用身份请求获取用户的open_id。

  请参考帮助文档如何在群聊中使用机器人的附录部分“旧版 webhook (自定义机器人) 使用说明”。

  7)配置使用 webhook 的自定义机器人时,参数text是否有长度要求?

  建议 JSON 的长度不超过 30k,序列化后的 pb 不超过 100k,图片最好小于 10MB。

  8)同一个 Custom Bot (自定义机器人)能在不同的群组使用吗?

  建议 JSON 的长度不超过 30k,序列化后的 pb 不超过 100k,图片最好小于 10MB。

  目前只有消息卡片类型的消息能进行更改,可以参考文档 交互模块 查看如何更改,其他的消息不支持更改。

  首先我们不建议进行敏感消息的绕过,请先检查你发送的消息中是否含有敏感词汇和敏感图片等。如果由于必须原因,可以申请敏感消息白名单,暂时绕过消息审计。 BOT敏感消息拦截反馈

  搜索对用户或机器人可见的群列表 接口可以搜到外部群,搜索用户所在的群列表(历史版本)不会返回外部群。

  1)我在调用某个接口的时候,收到了错误码,错误码对应的错误原因是什么呢?

  ISV应用的权限,除了需要发布应用外,还需要在租户管理后台进行授权,才可以生效。

  4)我在调用某个接口的时候触发了频率控制策略,具体的频控策略是怎样的呢?

  频控策略是指为了保护后台服务不崩溃,对接口增加一定的调用频率限制的策略。

  错误码频控策略建议230020发送消息(V1)接口触发群维度的发消息限流单群发消息的QPS不超过5QPS,参考 频控策略11232发消息接口(V4)触发IM系统维度限流等待后重试。11233发消息接口(V4)触发群维度的发消息限流单群发消息的QPS不超过5QPS,参考 频控策略11247批量发送消息触发每日额度限制单个应用每天通过该接口发送的总消息条数不超过50万,请合理分配批量发送的额度。99991400触发接口频控请求过于频繁,请降低请求频次,调用频率不高于频控策略

  6)在调用发送消息的API时,提示请求中的消息内容有问题,我应该如何排查解决问题?

  在文档发送消息content说明中介绍了富文本消息json转string的规则,这里明确总结如下:

关键词:
H型钢生产线
扫二维码用手机看
产品参数
有效切割长度

有任何问题 联系我们

搜索

点击这里,快速查找心仪的产品。

留言应用名称:
客户留言
描述:

咨询热线:

4000-888-086   /  15933391314 (同微信)

友情链接:

Copyright © kok电子游戏app下载       冀ICP备12000453号-1           冀公网安备 13050902000068号 XML地图