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

# Fireflies

> Connect Fireflies to capture meeting transcripts for Duckie

Connect Fireflies to sync meeting transcripts and recordings as knowledge for your agents.

## Capabilities

| Capability             | Supported                  |
| ---------------------- | -------------------------- |
| **Knowledge Source**   | ✓ Sync meeting transcripts |
| **Deployment Trigger** | ✗                          |
| **Tool Actions**       | ✗                          |

## Setup

Fireflies uses an API key + webhook setup.

### Step 1: Get API Credentials

1. Go to Fireflies settings
2. Navigate to **Developer Settings** or **API**
3. Generate or copy your API key

### Step 2: Connect in Duckie

1. Go to **Settings → Connections** in Duckie
2. Find **Fireflies** and click **Connect**
3. You'll receive a webhook URL
4. Enter your:
   * **API Key**: From Fireflies
   * **Webhook Secret**: Generated when you set up the webhook

### Step 3: Configure Webhook

1. Copy the webhook URL from Duckie
2. Go to Fireflies developer settings
3. Add the webhook URL
4. Copy the generated webhook secret back to Duckie
5. Click **Connect**

## Using as Knowledge Source

Once connected, meeting transcripts sync automatically:

1. Go to **Train → Knowledge**
2. Click **Add Source**
3. Select **Fireflies**
4. Configure which meetings to sync:
   * All meetings
   * Specific participants
   * By date range
5. Click **Start Sync**

### What Gets Synced

* Full meeting transcripts
* Speaker identification
* Meeting summaries
* Action items (if generated)
* Meeting metadata (date, participants)

## How Agents Use Meeting Data

Agents can reference meeting transcripts to:

* **Answer "what was discussed"** — Find specific topics from calls
* **Recall decisions** — Surface decisions made in meetings
* **Follow up on action items** — Reference committed actions
* **Provide context** — Understand customer conversations

### Example Use Cases

**Customer Success:**

> "What did we discuss in the last call with Acme Corp?"

Agent searches Fireflies → Finds transcript → Summarizes key points

**Sales Support:**

> "What features did the prospect ask about?"

Agent finds sales call → Lists discussed features and concerns

## Best Practices

### Organize by Customer

Tag meetings with customer names for easy retrieval:

* Agents can find all calls with a specific customer
* Better context for support conversations

### Regular Sync

Ensure transcripts sync promptly:

* New calls available to agents quickly
* Set up webhook for real-time updates

### Privacy Considerations

Meeting transcripts may contain sensitive info:

* Consider which meetings to sync
* Use knowledge tags to control agent access

## Troubleshooting

### "Transcripts not syncing"

* Verify the webhook is configured correctly
* Check that Fireflies is processing your meetings
* Confirm API key is valid

### "Webhook not receiving events"

* Verify the webhook URL in Fireflies
* Check the webhook secret matches
* Test the webhook from Fireflies settings

### "Missing meetings"

* Check date range filters
* Verify the meeting was processed by Fireflies
* Force a manual sync