For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Login
HomeDocsAPI ReferenceMCP ServerChat SDKsRelease Notes
HomeDocsAPI ReferenceMCP ServerChat SDKsRelease Notes
  • Introduction
    • Overview
    • Getting started
    • Authentication
    • Data privacy
    • Built-in prompts
    • FAQ
    • Troubleshooting
  • Tools
    • Overview
    • get_ada_configuration
    • get_ada_metric
    • get_available_filters
    • get_conversations
    • get_conversation
    • search_knowledge
    • search_coaching
    • get_improvement_guide
    • list_entities
    • propose_change
    • get_test_cases
    • get_test_runs
    • get_test_run_quota
    • send_feedback
  • Prompt library
    • Overview
    • Improvement recommendations
    • Quick health checks
    • Create visualizations
    • Diagnose performance issues
    • Identify optimization opportunities
    • Review configuration
    • Search knowledge and coaching
    • Test agent responses
    • Deep-dive analysis
Login
LogoLogo
On this page
  • Example prompts
  • Parameters
  • Detail levels
Tools

get_conversations

Was this page helpful?
Previous

get_conversation

Next
Built with

Retrieves many conversations at a chosen detail level within a date range. Use this to build conversation lists for bulk analysis or to feed individual IDs into get_conversation for transcript review.

Example prompts

  • “Get IDs for all unresolved conversations from yesterday.”
  • “List conversations from last week where CSAT was 1 or 2.”
  • “Summarize the top themes across handoff conversations from the Voice channel in the last 7 days.”

Parameters

ParameterTypeRequiredDescription
detail_levelstringYesDetail level: IDS_ONLY or SUMMARY. See below.
start_datestringYesStart date in YYYY-MM-DD format.
end_datestringYesEnd date in YYYY-MM-DD format.
filtersarrayNoArray of filter objects. Use get_available_filters to construct valid filter expressions.
sizenumberNoMaximum conversations to return. Defaults and caps vary by detail level.
offsetnumberNoNumber of conversations to skip for pagination. Must be a multiple of size.

Detail levels

  • IDS_ONLY — Returns conversation ID, created date, and platform. Default 100, max 1,000. Use when you need a list of matching conversations to feed into other tools.
  • SUMMARY — Returns inquiry summaries, resolution status, resolution reason, CSAT survey data (score, comment, feedback tags) when available, and a dashboard link per conversation. Default 50, max 500. Use for pattern analysis across many conversations without pulling full transcripts.