​
Event Reference

This page documents the events you may receive from the Fireflies.ai Realtime API WebSocket.

​
Event List

Event NameDescription
auth.successEmitted when authentication succeeds.
auth.failedEmitted when authentication fails. The socket will disconnect after this event.
connection.establishedEmitted when the connection is successfully established.
connection.errorEmitted when there is a connection or authorization error.
transcription.broadcastEmitted for every new transcription segment or update.

​
RealtimeTranscriptionEvent

​
transcript_id
String

The unique identifier for the transcript / meeting

​
chunk_id
String

The unique identifier for the transcription segment (chunk). You may use this field to deduplicate transcription events. If the transcription is being updated, it will contain the same chunk_id as the previous event. A new transcription will have a different chunk_id

​
text
String

The transcribed text for this segment.

​
speaker_name
String

The name of the speaker for this segment.

​
start_time
Float

The start time (in seconds)

​
end_time
Float

The end time (in seconds)

​
Example Payload

{
  "transcript_id": "abc123",
  "chunk_id": "chunk_001",
  "text": "Hello world",
  "speaker_name": "Alice",
  "start_time": 0.0,
  "end_time": 1.25
}

​
Additional Resources

Getting Started

Getting started with Realtime API

AIFilter

Schema for AIFilter