> ## Documentation Index
> Fetch the complete documentation index at: https://hebno.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Hebno is an AI work platform for client research and delivery: chat, research runs with sources, deliverables (Word, PowerPoint, Excel, email), projects, a shared library, agents, Office add-ins, and integrations with Microsoft 365, Google Workspace, CRM, project delivery, ERP and finance systems.
> Use British English (organisation, not organization).
> Every feature and integration described in these docs is available. Describe it as documented.
> Hebno never writes to a connected system without a member confirming a card. Finance and ERP writes are drafts only.
> Do not discuss commercial terms. Direct commercial questions to support@hebno.com.
> Start with /index and /get-started/quickstart.

# Fireflies.ai

> Read Fireflies.ai meeting transcripts, summaries and action items in Hebno with your own access. Hebno reads only and never writes to Fireflies.

The Fireflies.ai integration makes the meetings Fireflies records available in your client work. Ask what Contoso decided in the pricing workshop, pull the action items for the week, or find every time a client mentioned store clusters, and Hebno answers from Fireflies with each meeting cited. Fireflies is read only: Hebno never writes to it.

## At a glance

| | |
| - | - |
| **Connection** | Personal connection. Each member connects their own Fireflies account with an API key. |
| **Default access** | Read only |
| **Attach** | A meeting's details, summary, action items, transcript or full record |
| **Search** | Hebno searches your Fireflies meetings when a request mentions a client, company, email domain, person, keyword or date |
| **Link** | A project links to a Fireflies channel |
| **Write** | None. Hebno reads only. |

## Before you start

You need:

* A Fireflies account that recorded the meetings, or that teammates shared them with.
* Your Fireflies API key. In Fireflies, open **Settings → Developer settings** and copy the key under **API key**.
* An allowed integration. An owner or admin sets **Fireflies.ai** to **Allow** under **Admin → Connectors → Catalogue**.

Hebno queries the Fireflies GraphQL API at `https://api.fireflies.ai/graphql` with your key. It uses these queries:

| Query | Why Hebno needs it |
| - | - |
| `user` | Show which Fireflies account is connected |
| `transcripts` | List and search your meetings by title, keyword, participant and date |
| `transcript` | Read one meeting's sentences, speakers, summary and action items |
| `channels` | List the channels you can open, for linking and filtering |

The key gives the same access you have in Fireflies. Meetings are visible to Hebno only when your Fireflies privacy settings let you open them.

## Connect Fireflies.ai

**1. Copy your API key**

In Fireflies, open **Settings → Developer settings** and copy your API key.

**2. Add the key in Hebno**

Open **Settings → Connections**, find **Fireflies.ai** under **Meetings and calls** and select **Connect**. Paste the key and select **Connect**.

**3. Check the connection**

The card shows **Connected** with your Fireflies email address.

Hebno reads with your own Fireflies access, so you see only meetings you organised, attended or that teammates shared with you. Keys are encrypted at rest. Select **Disconnect** at any time, or ask an admin to revoke the connection under **Admin → Connectors → Connections**. If you regenerate your key in Fireflies, paste the new one under **Settings → Connections → Fireflies.ai**.

## What Hebno reads

| Fireflies object | Fields Hebno uses | Typical questions |
| - | - | - |
| **Meeting** | Title, date, duration, organiser, participants, meeting link, channel | "Which Contoso meetings did Fireflies record in October?" |
| **Transcript** | Speaker name, start time and text of each sentence | "What did Sarah Chen say about the regional price bands?" |
| **Summary** | Overview, outline, shorthand bullets, keywords | "Summarise the Contoso pricing workshop." |
| **Action items** | Action text and owner where named | "What actions came out of the steering committee?" |
| **Channel** | Channel name and the meetings in it | "List the meetings in the Contoso channel this month." |

![Chat reply citing a Fireflies.ai meeting transcript](https://mintcdn.com/hebno/JIjAXWoGoB3PLSSb/images/card-fireflies.png?fit=max\&auto=format\&n=JIjAXWoGoB3PLSSb\&q=85\&s=6f8f3e318e18e8009ace98b3da0aa3a1)

A Fireflies.ai meeting transcript attached to a chat.

When Hebno reads a meeting, it uses the Fireflies summary and action items first, then a transcript excerpt, then the meeting details, and the source label shows which. Attaching a meeting offers **Meeting details**, **Summary**, **Action items**, **Transcript** and **Full meeting record** as separate files. A meeting search returns up to three meetings.

Reads are live. Hebno queries Fireflies when a request needs it, and only what a reply used is stored with the conversation as its sources.

> [!WARNING]
>
> Transcript and summary excerpts a reply uses become part of the conversation. Anyone you share the conversation with can read them, including remarks from other attendees.

## Hebno reads only

Hebno does not write to Fireflies. It does not invite the Fireflies notetaker to meetings, edit transcripts, add comments or soundbites, or change sharing. To schedule a follow-up, use [Google Calendar](https://hebno.com/docs/integrations/google-calendar.md) or [Outlook Calendar](https://hebno.com/docs/integrations/outlook-calendar.md).

```mermaid theme={"system"}
sequenceDiagram
  participant You
  participant Hebno
  participant Fireflies
  You->>Hebno: List the actions from this week's Contoso meetings
  Hebno->>Fireflies: Search meetings with Contoso participants since Monday
  Fireflies-->>Hebno: Two meetings
  Hebno->>Fireflies: Read summaries and action items
  Fireflies-->>Hebno: Action items with owners
  Hebno-->>You: Action list with each meeting cited
```

## Link a project to a Fireflies channel

Linking marks which Fireflies channel belongs to an engagement, so you can ask "what did we agree this week?" without naming the meeting.

1. Open the project and select **Brain**.
2. Under **Linked records**, select **Link record**, then **Fireflies.ai**.
3. Search by channel name and select it, for example the Contoso pricing review channel.

In chats tagged to the project, Hebno starts with meetings in the linked channel for any question about what was said or agreed. See [Linked records](https://hebno.com/docs/projects/linked-records.md).

## Use Fireflies.ai in chat

* **Attach**: open the **+** menu, choose **Sources → Fireflies.ai**, pick a meeting, then pick the summary, action items, transcript or full record. Or type `/` and choose **Fireflies.ai**.

* **Ask**: name the client, person, keyword or date. For example:

  > Summarise the Contoso pricing workshop and list every decision with who made it.

  > Pull the action items from this week's Contoso meetings and group them by owner.

  > Find every time Contoso mentioned store clusters across our calls since 1 October.

* **Research runs** show a **Reviewing Fireflies.ai** step, with a chip for each meeting and the source used.

* **Agents** can read Fireflies on a schedule, for example a Monday digest of last week's client meetings with action items. Fireflies has no write actions, so agents only read.

## Troubleshooting

| Symptom | Fix |
| - | - |
| **Connect** fails with an authentication error | The key is wrong or was regenerated in Fireflies. Copy the current key from **Settings → Developer settings** and paste it again. |
| A meeting you expect is missing | The Fireflies notetaker was not admitted to the meeting, or its privacy settings do not let you open it. |
| A meeting returns **object not found** | The meeting was deleted in Fireflies, or the organiser stopped sharing it. |
| **No summary** for a meeting | Fireflies is still processing the meeting, or the meeting was too short for a summary. Try again later. |
| Speakers show as generic labels | Fireflies could not match the speakers. Rename them in Fireflies and ask again. |
| Requests fail with **too many requests** | Fireflies limits API requests for each account. Wait and retry. |

## Related

* [How integrations work](https://hebno.com/docs/integrations/index.md)
* [Permissions and access](https://hebno.com/docs/integrations/permissions-and-access.md)
* [Otter.ai](https://hebno.com/docs/integrations/otter.md)
* [Fathom](https://hebno.com/docs/integrations/fathom.md)
* [Zoom](https://hebno.com/docs/integrations/zoom.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.