Fireflies.ai Core Workflow B -- Search, AskFred & Analytics

Overview

Secondary workflow: search across transcripts with keyword and date filters, use AskFred AI for natural language Q&A over meetings, and aggregate meeting analytics for reporting.

Examples

Search a synthetic meeting set using a narrow date range and a fictional keyword, then return only aggregate counts and approved action-item categories. Confirm that the destination never receives raw transcript passages or participant identities unless the documented access policy permits them.

Prerequisites

• Completed fireflies-install-auth setup
• Familiarity with fireflies-core-workflow-a
• AI credits for AskFred queries (check Fireflies dashboard)

Instructions

Step 1: Search Transcripts by Keyword

const SEARCH_TRANSCRIPTS = `
  query SearchMeetings(
    $keyword: String,
    $fromDate: DateTime,
    $toDate: DateTime,
    $participants: [String],
    $limit: Int
  ) {
    transcripts(
      keyword: $keyword
      fromDate: $fromDate
      toDate: $toDate
      participants: $participants
      limit: $limit
    ) {
      id title date duration
      organizer_email
      participants
      summary { overview action_items keywords }
    }
  }
`;

// Search for "quarterly review" in the last 30 days
const results = await firefliesQuery(SEARCH_TRANSCRIPTS, {
  keyword: "quarterly review",
  fromDate: new Date(Date.now() - 30 * 86400000).toISOString(),
  limit: 20,
});

console.log(`Found ${results.transcripts.length} matching meetings`);
for (const t of results.transcripts) {
  console.log(`  ${t.title} (${t.date}) - ${t.duration}min`);
}

Step 2: AskFred -- AI Q&A Over a Single Meeting

// Create a new AskFred thread tied to a transcript
const CREATE_THREAD = `
  mutation CreateThread($input: CreateAskFredThreadInput!) {
    createAskFredThread(input: $input) {
      id
      title
      messages {
        id
        answer
        suggested_queries
      }
    }
  }
`;

const thread = await firefliesQuery(CREATE_THREAD, {
  input: {
    query: "What were the key decisions made in this meeting?",
    transcript_id: "your-transcript-id",
  },
});

console.log("Fred says:", thread.createAskFredThread.messages[0].answer);
console.log("Suggested follow-ups:", thread.createAskFredThread.messages[0].suggested_queries);

Step 3: AskFred -- Continue a Conversation

const CONTINUE_THREAD = `
  mutation ContinueThread($thread_id: String!, $query: String!) {
    continueAskFredThread(thread_id: $thread_id, query: $query) {
      id
      answer
      suggested_queries
    }
  }
`;

const followUp = await firefliesQuery(CONTINUE_THREAD, {
  thread_id: thread.createAskFredThread.id,
  query: "Who is responsible for the action items?",
});

console.log("Follow-up:", followUp.continueAskFredThread.answer);

Step 4: AskFred -- Cross-Meeting Analysis

// Query across multiple meetings (no transcript_id = searches all)
const crossMeeting = await firefliesQuery(CREATE_THREAD, {
  input: {
    query: "What topics came up repeatedly across our sprint planning meetings?",
    // filters can narrow scope without tying to a single transcript
  },
});

Step 5: Meeting Analytics Aggregation

async function meetingAnalytics(days: number = 30) {
  const since = new Date(Date.now() - days * 86400000).toISOString();

  const data = await firefliesQuery(`
    query Analytics($fromDate: DateTime) {
      transcripts(fromDate: $fromDate, limit: 100) {
        id title date duration
        organizer_email participants
        summary { action_items keywords }
        analytics {
          speakers { name duration word_count questions }
          sentiments { positive_pct negative_pct }
        }
      }
    }
  `, { fromDate: since });

  const meetings = data.transcripts;
  const totalMinutes = meetings.reduce((s: number, m: any) => s + (m.duration || 0), 0);
  const totalActions = meetings.reduce(
    (s: number, m: any) => s + (m.summary?.action_items?.length || 0), 0
  );

  // Top keywords across all meetings
  const keywordCounts: Record<string, number> = {};
  for (const m of meetings) {
    for (const kw of m.summary?.keywords || []) {
      keywordCounts[kw] = (keywordCounts[kw] || 0) + 1;
    }
  }
  const topKeywords = Object.entries(keywordCounts)
    .sort((a, b) => b[1] - a[1])
    .slice(0, 10);

  return {
    period: `${days} days`,
    totalMeetings: meetings.length,
    totalHours: (totalMinutes / 60).toFixed(1),
    totalActionItems: totalActions,
    avgDuration: Math.round(totalMinutes / meetings.length),
    topKeywords,
  };
}

Step 6: List and Manage AskFred Threads

// List all threads
const threads = await firefliesQuery(`{
  askfred_threads {
    id title transcript_id created_at
  }
}`);

// Delete a thread (cleanup)
await firefliesQuery(`
  mutation DeleteThread($id: String!) {
    deleteAskFredThread(thread_id: $id)
  }
`, { id: "thread-id-to-delete" });

AskFred Credits

AskFred API calls consume AI credits. If you receive requireaicredits, visit the Upgrade section in your Fireflies dashboard to add credits. Budget accordingly for production use.

Error Handling

Output

• Keyword search results across transcript history
• AskFred AI-powered Q&A threads with suggested follow-ups
• Cross-meeting analytics report with keyword trends

Resources

• AskFred API Overview
• Transcripts Query

Next Steps

For common errors, see fireflies-common-errors.