Skip to main content

​
Prerequisites

Before you begin, make sure you have:
  1. API Key: Obtain your API key from app.fireflies.ai/integrations
  2. Transcript ID (optional): The ID of a meeting transcript you want to query
If you don’t have a transcript ID, you can query across all your meetings using filters. See Step 3 below.

​
Step 1: Create Your First Thread

Start by asking a question about a specific meeting: 
mutation CreateThread {
  createAskFredThread(input: {
    query: "What were the main discussion points?",
    transcript_id: "your_transcript_id",
    response_language: "en",
    format_mode: "markdown"
  }) {
    message {
      id
      thread_id
      answer
      suggested_queries
    }
  }
}

​
Response

{
  "data": {
    "createAskFredThread": {
      "message": {
        "id": "msg_abc123",
        "thread_id": "thread_xyz789",
        "answer": "The main discussion points were:\n\n1. **Q4 Product Roadmap**: The team reviewed upcoming features...\n2. **Budget Allocation**: Discussion on resource allocation...\n3. **Timeline Concerns**: Several concerns about launch dates...",
        "suggested_queries": [
          "Can you elaborate on the timeline concerns?",
          "What features are prioritized for Q4?",
          "Who raised concerns about the budget?"
        ]
      }
    }
  }
}

​
Step 2: Ask Follow-up Questions

Continue the conversation with context-aware follow-ups using the thread_id from the previous response: 
mutation ContinueThread {
  continueAskFredThread(input: {
    thread_id: "thread_xyz789",
    query: "Can you elaborate on the timeline concerns?"
  }) {
    message {
      answer
      suggested_queries
    }
  }
}

​
Step 3: Query Across Meetings

Analyze patterns across multiple meetings using filters: 
mutation CrossMeetingAnalysis {
  createAskFredThread(input: {
    query: "What customer concerns were raised this month?",
    filters: {
      start_time: "2024-03-01T00:00:00Z",
      end_time: "2024-03-31T23:59:59Z",
      participants: ["customer@example.com"]
    }
  }) {
    message {
      answer
      suggested_queries
    }
  }
}
For more details on available filters and parameters, see the createAskFredThread documentation.

​
Step 4: List Your Threads

Retrieve all your conversation threads: 
query GetThreads {
  askfred_threads {
    id
    title
    transcript_id
    created_at
  }
}

​
Additional Resources

Explore Use Cases

Discover common scenarios and example questions

Best Practices

Learn tips for asking effective questions