Grain

用作触发器

查看 Grain 的触发事件、设置和事件负载。

配置

列出录制

操作

列出录制

API 密钥*

••••••••

分页游标

下一页的游标（可选）

日期之前

ISO8601 时间戳（例如 2024-01-01T00:00:00Z）

日期之后

ISO8601 时间戳（例如 2024-01-01T00:00:00Z）

参与者范围

全部

标题搜索

按录制标题搜索

团队 ID

按团队 UUID 过滤（可选）

会议类型 ID

按会议类型 UUID 过滤（可选）

包含亮点

Disabled

包含参与者

Disabled

包含 AI 摘要

Disabled

列出录制 (grain_list_recordings)

从 Grain 列出录制，支持可选过滤和分页

输入

参数	类型	必填	描述
`apiKey`	string	是	Grain API 密钥 (个人访问令牌)
`cursor`	string	否	下一页的分页游标
`beforeDatetime`	string	否	仅此 ISO8601 时间戳之前的录制
`afterDatetime`	string	否	仅此 ISO8601 时间戳之后的录制
`participantScope`	string	否	过滤："internal" 或 "external"
`titleSearch`	string	否	按录制标题过滤的搜索词
`teamId`	string	否	按团队 UUID 过滤
`meetingTypeId`	string	否	按会议类型 UUID 过滤
`includeHighlights`	boolean	否	在响应中包含亮点/片段
`includeParticipants`	boolean	否	在响应中包含参与者列表
`includeAiSummary`	boolean	否	包含 AI 生成的摘要

输出

参数	类型	描述
`recordings`	array	录制对象数组
`cursor`	string	下一页的游标 (如果没有更多则为 null)

获取录制

操作

获取录制

API 密钥*

••••••••

录制 ID*

输入录制 UUID

包含亮点

Disabled

包含参与者

Disabled

包含 AI 摘要

Disabled

包含日历事件

Disabled

包含 HubSpot 数据

Disabled

获取录制 (grain_get_recording)

通过 ID 获取单个录制的详细信息

输入

参数	类型	必填	描述
`apiKey`	string	是	Grain API 密钥 (个人访问令牌)
`recordingId`	string	是	录制的 UUID
`includeHighlights`	boolean	否	包含亮点/片段
`includeParticipants`	boolean	否	包含参与者列表
`includeAiSummary`	boolean	否	包含 AI 摘要
`includeCalendarEvent`	boolean	否	包含日历事件数据
`includeHubspot`	boolean	否	包含 HubSpot 关联

输出

参数	类型	描述
`id`	string	录制 UUID
`title`	string	录制标题
`start_datetime`	string	ISO8601 开始时间戳
`end_datetime`	string	ISO8601 结束时间戳
`duration_ms`	number	持续时间（毫秒）
`media_type`	string	音频、转录或视频
`source`	string	录制来源 (zoom、meet、teams 等)
`url`	string	在 Grain 中查看的 URL
`thumbnail_url`	string	缩略图 URL
`tags`	array	标签字符串数组
`teams`	array	录制所属的团队
`meeting_type`	object	会议类型信息 (id、name、scope)
`highlights`	array	亮点 (如果包含)
`participants`	array	参与者 (如果包含)
`ai_summary`	object	AI 摘要文本 (如果包含)
`calendar_event`	object	日历事件数据 (如果包含)
`hubspot`	object	HubSpot 关联 (如果包含)

获取转录文本

操作

获取转录文本

API 密钥*

••••••••

录音 ID*

输入录音 UUID

获取转录文本（grain_get_transcript）

获取录音的完整转录文本

输入

参数	类型	必填	描述
`apiKey`	string	是	Grain API 密钥 (个人访问令牌)
`recordingId`	string	是	录音 UUID

输出

参数	类型	描述
`transcript`	array	转录片段数组

列出团队

操作

列出团队

API 密钥*

••••••••

列出团队 (grain_list_teams)

列出工作区中的所有团队

输入

参数	类型	必填	描述
`apiKey`	string	是	Grain API 密钥 (个人访问令牌)

输出

参数	类型	描述
`teams`	array	团队对象数组

列出会议类型

操作

列出会议类型

API 密钥*

••••••••

列出会议类型 (grain_list_meeting_types)

列出工作区中的所有会议类型

输入

参数	类型	必填	描述
`apiKey`	string	是	Grain API 密钥 (个人访问令牌)

输出

参数	类型	描述
`meeting_types`	array	会议类型对象数组

创建 Webhook

操作

创建 Webhook

API 密钥*

••••••••

早于日期

ISO8601 时间戳（例如：2024-01-01T00:00:00Z）

晚于日期

ISO8601 时间戳（例如：2024-01-01T00:00:00Z）

参与者范围

全部

团队 ID

按团队 UUID 筛选（可选）

会议类型 ID

按会议类型 UUID 筛选（可选）

包含亮点

Disabled

包含参与者

Disabled

包含 AI 摘要

Disabled

Webhook URL*

输入 Webhook 端点 URL

创建 Webhook（grain_create_hook）

创建 Webhook 以接收录制事件

输入

参数	类型	必填	描述
`apiKey`	字符串	是	Grain API 密钥 (个人访问令牌)
`hookUrl`	字符串	是	Webhook 端点 URL (必须返回 2xx)
`filterBeforeDatetime`	字符串	否	筛选：此日期之前的录制
`filterAfterDatetime`	字符串	否	筛选：此日期之后的录制
`filterParticipantScope`	字符串	否	筛选：“内部”或“外部”
`filterTeamId`	字符串	否	筛选：特定团队 UUID
`filterMeetingTypeId`	字符串	否	筛选：特定会议类型
`includeHighlights`	布尔值	否	在 Webhook 负载中包含亮点
`includeParticipants`	布尔值	否	在 Webhook 负载中包含参与者
`includeAiSummary`	布尔值	否	在 Webhook 负载中包含 AI 摘要

输出

参数	类型	描述
`id`	字符串	Hook UUID
`enabled`	布尔值	Hook 是否处于活动状态
`hook_url`	字符串	Webhook URL
`filter`	对象	已应用的筛选条件
`include`	对象	包含的字段
`inserted_at`	字符串	ISO8601 创建时间戳

列出 Webhook

操作

列出 Webhook

API 密钥*

••••••••

列出 Webhook（grain_list_hooks）

列出账户的所有 Webhook

输入

参数	类型	必填	描述
`apiKey`	string	是	Grain API 密钥 (个人访问令牌)

输出

参数	类型	描述
`hooks`	array	Webhook 对象数组

删除 Webhook

操作

删除 Webhook

API 密钥*

••••••••

Webhook ID*

输入要删除的 Webhook UUID

删除 Webhook（grain_delete_hook）

按 ID 删除 Webhook

输入

参数	类型	必填	描述
`apiKey`	string	是	Grain API 密钥 (个人访问令牌)
`hookId`	string	是	要删除的 Webhook UUID

输出

参数	类型	描述
`success`	boolean	当 webhook 成功删除时为 true

使用说明

将 Grain 集成到你的工作流中。访问会议录音、转录文本、精彩片段和 AI 生成的摘要。还可以根据 Grain webhook 事件触发工作流。

注意事项

类别：tools
类型：grain

Grain

用作触发器

On this page