{
  "fromDate": "2024-01-01T00:00:00.000Z",
  "toDate": "2024-01-31T23:59:59.999Z",
  "participants": ["sales@example.com"],
  "keyword": "pricing",
  "scope": "ALL",
  "limit": 50
}

<iframe 
  src="https://share.fireflies.ai/embed/meetings/{id}" 
  width="640" 
  height="360" 
  frameborder="0" 
  allow="autoplay; fullscreen; picture-in-picture" 
  allowfullscreen>
</iframe>

Fireflies.ai 技能

查询 Fireflies.ai 中的会议记录、摘要、行动项和分析数据。

设置

设置你的 Fireflies API 密钥：
bash
FIREFLIESAPIKEY=你的API密钥

从以下地址获取 API 密钥：https://app.fireflies.ai/integrations（滚动到 Fireflies API 部分）

API 基础

GraphQL 端点：https://api.fireflies.ai/graphql

授权头：Bearer $FIREFLIESAPIKEY

---

核心查询

获取当前用户

bash
curl -s -X POST https://api.fireflies.ai/graphql \
-H Content-Type: application/json \
-H Authorization: Bearer $FIREFLIESAPIKEY \
-d {query:{ user { userid name email isadmin minutesconsumed numtranscripts recent_meeting } }} | jq

获取单条会议记录

bash
curl -s -X POST https://api.fireflies.ai/graphql \
-H Content-Type: application/json \
-H Authorization: Bearer $FIREFLIESAPIKEY \
-d {query:query($id:String!){transcript(id:$id){id title date duration participants firefliesusers summary{keywords actionitems overview topicsdiscussed} speakers{name duration} sentences{speakername text start_time}}},variables:{id:会议记录ID}} | jq

按日期范围搜索会议记录

bash

ISO 8601 格式：YYYY-MM-DDTHH:mm:ss.sssZ

curl -s -X POST https://api.fireflies.ai/graphql \
-H Content-Type: application/json \
-H Authorization: Bearer $FIREFLIESAPIKEY \
-d {query:query($from:DateTime,$to:DateTime,$limit:Int){transcripts(fromDate:$from,toDate:$to,limit:$limit){id title date duration organizeremail participants summary{keywords actionitems overview}}},variables:{from:2024-01-01T00:00:00.000Z,to:2024-01-31T23:59:59.999Z,limit:50}} | jq

按参与者搜索会议记录

bash

搜索特定人员参与的会议

curl -s -X POST https://api.fireflies.ai/graphql \
-H Content-Type: application/json \
-H Authorization: Bearer $FIREFLIESAPIKEY \
-d {query:query($participants:[String],$limit:Int){transcripts(participants:$participants,limit:$limit){id title date participants organizeremail summary{actionitems}}},variables:{participants:[john@example.com,jane@example.com],limit:20}} | jq

按组织者搜索会议记录

bash
curl -s -X POST https://api.fireflies.ai/graphql \
-H Content-Type: application/json \
-H Authorization: Bearer $FIREFLIESAPIKEY \
-d {query:query($organizers:[String],$limit:Int){transcripts(organizers:$organizers,limit:$limit){id title date organizer_email participants}},variables:{organizers:[sales@example.com],limit:25}} | jq

按关键词搜索（标题和/或会议记录）

bash

范围：TITLE、SENTENCES 或 ALL

curl -s -X POST https://api.fireflies.ai/graphql \
-H Content-Type: application/json \
-H Authorization: Bearer $FIREFLIESAPIKEY \
-d {query:query($keyword:String,$scope:String){transcripts(keyword:$keyword,scope:$scope,limit:10){id title date summary{overview}}},variables:{keyword:定价,scope:ALL}} | jq

获取我的近期会议记录

bash
curl -s -X POST https://api.fireflies.ai/graphql \
-H Content-Type: application/json \
-H Authorization: Bearer $FIREFLIESAPIKEY \
-d {query:{ transcripts(mine:true,limit:10) { id title date duration summary { action_items keywords } } }} | jq

---

高级查询

获取完整会议记录及摘要和行动项

bash
curl -s -X POST https://api.fireflies.ai/graphql \
-H Content-Type: application/json \
-H Authorization: Bearer $FIREFLIESAPIKEY \
-d {query:query($id:String!){transcript(id:$id){id title date duration organizeremail participants firefliesusers workspaceusers meetingattendees{displayName email} summary{keywords actionitems outline overview bulletgist topicsdiscussed meetingtype} speakers{name duration wordcount} sentences{speakername text starttime endtime}}},variables:{id:会议记录ID}} | jq

获取带分析的会议记录

bash

需要 Pro 计划或更高版本

curl -s -X POST https://api.fireflies.ai/graphql \
-H Content-Type: application/json \
-H Authorization: Bearer $FIREFLIESAPIKEY \
-d {query:query($id:String!){transcript(id:$id){id title analytics{sentiments{positivepct neutralpct negativepct} speakers{name duration wordcount fillerwords questions longestmonologue wordsperminute}}}},variables:{id:会议记录ID}} | jq

获取联系人

bash
curl -s -X POST https://api.fireflies.ai/graphql \
-H Content-Type: application/json \
-H Authorization: Bearer $FIREFLIESAPIKEY \
-d {query:{ contacts { email name picture lastmeetingdate } }} | jq

获取活跃会议

bash
curl -s -X POST https://api.fireflies.ai/graphql \
-H Content-Type: application/json \
-H Authorization: Bearer $FIREFLIESAPIKEY \
-d {query:{ activemeetings { id title organizeremail meetinglink starttime state } }} | jq

---

管道审查示例

获取过去7天内包含特定参与者的所有会议：

bash

日期命令（根据操作系统选择）：

macOS：

FROM_DATE=$(date -u -v-7d +%Y-%m-%dT00:00:00.000Z)

Linux：

FROM_DATE=$(date -u -d 7 days ago +%Y-%m-%dT00:00:00.000Z)

TO_DATE=$(date -u +%Y-%m-%dT23:59:59.999Z)

curl -s -X POST https://api.fireflies.ai/graphql \
-H Content-Type: application/json \
-H Authorization: Bearer $FIREFLIESAPIKEY \
-d {\query\:\query(\$from:DateTime,\$to:DateTime,\$participants:[String]){transcripts(fromDate:\\\\$FROMDATE\\\,toDate:\\\\$TODATE\\\,participants:\$participants,limit:50){id title date duration organizeremail participants summary{keywords actionitems topicsdiscussed meetingtype}}}\,\variables\:{\from\:\$FROMDATE\,\to\:\$TODATE\,\participants\:[\prospect@company.com\]}} | jq

---

关键模式字段

会议记录字段

• - id - 唯一标识符
• title - 会议标题
• date - Unix 时间戳（毫秒）
• dateString - ISO 8601 日期时间
• duration - 持续时间（分钟）
• organizeremail - 会议组织者
• participants - 所有参与者邮箱
• firefliesusers - 参与的 Fireflies 用户
• workspaceusers - 参与的团队成员
• meetingattendees - 详细参会者信息（displayName, email）
• transcripturl - 在仪表板中查看
• audiourl - 下载音频（Pro+，24小时过期）
• video_url - 下载视频（Business+，24小时过期）

摘要字段

• - keywords - 关键主题
• actionitems - 提取的行动项
• overview - 会议概述
• topicsdiscussed - 讨论的主要主题
• meetingtype - 会议类别
• outline - 结构化大纲
• bulletgist - 要点摘要

句子字段

• - text - 句子文本
• spe