用途:在飞书日历中管理日程与参会人,覆盖创建会议、查询日程、修改时间、搜索日程、回复邀请、查询重复日程实例、查询忙闲、邀请或删除参会人等场景。
主要能力:feishu_calendar_event 支持 create、list、patch、search、reply、instances;feishu_calendar_freebusy 支持 list 查询忙闲;feishu_calendar_event_attendee 支持 create 与 batch_delete 管理参会人。
必要用法:时区固定 Asia/Shanghai(UTC+8),时间用 ISO 8601/RFC 3339 带时区格式,如 2026-02-25T14:00:00+08:00。create 最小必填 summary、start_time、end_time,强烈建议传 user_open_id(从 SenderId 获取,ou_xxx),否则发起人不会作为参会人。ID 约定:用户 ou_...,群 oc_...,会议室 omm_...,邮箱 email@...。参会人权限默认 attendee_ability 为 can_modify_event。
限制:instances 仅对含 recurrence 字段的重复日程有效;会议室预约为异步流程,需稍后用 attendee.list 查询 rsvp_status;忙闲查询 user_ids 支持 1-10 个用户,不支持会议室忙闲;每个日程最多 3000 名参会人,单次添加用户类参会人上限 1000、会议室 100;主日历不可删除。
适用场景:创建会议并邀请参会人、查询某时间段日程、查看多人忙闲、修改日程时间、按关键词搜索、回复邀请等。
其他细节:日历分 primary、shared、resource、google、exchange 等类型,仅 primary 与 shared 可修改,shared 可删除;rsvp_status 含 needs_action、accept、tentative、decline、removed。具体安装与调用方式资料未提供。