VoiceThere
Sign up

Conversation history

When enabled, VoiceThere stores final user speech (STT) and agent TTS text for each voice session. You review transcripts in the dashboard Conversation tab on the session detail page. This is for voice turn text only — DataChannel chat messages are not recorded in conversation history.

Where to configure

  • Dashboard: Project overview → Session settings → Conversation history toggle (conversation_history_enabled).
  • CLI: voicethere projects session-settings list / voicethere projects session-settings set conversation_history_enabled <true|false>
  • API: PATCH /projects/:projectId/session-settings — see Control plane API.

Default is true. Settings apply on the next Deploy to cloud. Turning history off stops recording new transcripts; existing rows remain until retention policies remove them.

What is stored

  • User turns — final STT text after the speech pipeline commits an utterance.
  • Agent turns — text sent to TTS for spoken replies.

Partial STT, barge-in events, and data-channel payloads are not listed in the Conversation tab. For runtime errors and agent logs, use Agent logs & session errors.

Dashboard: Conversation tab

Open a session from Project → Sessions → session detail. The Conversation tab shows a chronological transcript when history was enabled for that project at session time. Search and export behavior follows dashboard retention on your plan.

Storage caps & overage billing

Each plan includes a maximum number of stored conversations per project. When you exceed the effective cap, the oldest conversations roll off (FIFO). On the project billing settings panel you can toggle conversation overage billing:

  • Overage on — storage can grow past the plan cap; overage credits apply for new conversations past your monthly included count. Only retention-day pruning runs (no FIFO cap while overage is on).
  • Overage off — FIFO roll-off at your plan cap with no overage credits. If you had overage on, grew above the plan limit, then turn overage off, your current session count is frozen as an elevated rollover ceiling until you delete data or re-enable overage.

See also Billing & usage credits.

CLI examples

# Check whether conversation history is enabled
voicethere projects session-settings list

# Opt out of new transcripts (existing history kept)
voicethere projects session-settings set conversation_history_enabled false
voicethere deploy --wait

# Re-enable recording
voicethere projects session-settings set conversation_history_enabled true
voicethere deploy --wait

Related

← All documentation