Fetching transcripts

With the voiceflow-cli you can fetch the transcripts of your project. This is useful when you want to analyze the conversation flow of your agent. The voiceflow-cli has 2 commands that allow you to fetch the transcripts from your terminal:

Fetching all transcripts

To fetch all transcripts, you need to know the agent-id of the agent you want to fetch the transcripts from. You can find that information in the Voiceflow Agent section under your Agent Settings on voiceflow.com.

voiceflow transcript fetch-all --agent-id <your-agent-id>

Time Range Filters

• Start Time

  • Flag: --start-time, -s
  • Format: ISO-8601
  • Default: Current date minus one month
  • Example: --start-time 2024-01-01T00:00:00Z

• End Time

  • Flag: --end-time, -e
  • Format: ISO-8601
  • Default: Current date
  • Example: --end-time 2024-02-01T00:00:00Z

Content Filters

• Tag Filter

  • Flag: --tag, -g
  • Description: Filter transcripts by specific tag
  • Default: Empty (no filter)
  • Example: --tag production

• Range Filter

  • Flag: --range, -r
  • Description: Filter transcripts by date range
  • Default: Empty (no filter)
  • Example: --range Yesterday

Example Usage

voiceflow transcript fetch-all \
  --agent-id abc123 \
  --start-time 2024-01-01T00:00:00Z \
  --end-time 2024-02-01T00:00:00Z \
  --tag production \
  --range Yesterday \
  --output-directory ./my-transcripts

Fetching a specific transcript

To fetch a specific transcript, you need to know the transcript-id of the transcript you want to fetch. You can find the transcript-id in the Voiceflow Transcript section.

voiceflow transcript fetch --agent-id <your-agent-id> --transcript-id <your-transcript-id>