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.
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