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