Genesys Cloud - Developer Community!

 View Only

Sign Up

Back to discussions
Expand all | Collapse all

How to track Agent Copilot Checklist completion per agent - no API found

  • 1.  How to track Agent Copilot Checklist completion per agent - no API found

    Posted 2 hours ago
    Edited by Val Lyle 2 hours ago

    I am looking for a REST endpoint or event that returns Agent Copilot Checklist tick state per conversation. Analytics APIs return lifecycle data but no checklist info.

    Goal

    Track per-agent, per-checklist, per-item completion rates for two checklists (7 items each, all automatedCheckEnabled: false, so every tick is an intentional agent action).

    Confirmed does NOT return tick state

    Endpoint Result
    GET /api/v2/analytics/conversations/{id}/details Lifecycle + agentAssistantId only
    POST /api/v2/analytics/conversations/details/query Same - no checklist data
    POST /api/v2/analytics/conversations/aggregates/query checklist_id not in ConversationAggregateGroupByDimension
    POST /api/v2/analytics/conversations/activity/query Real-time only, no custom dimensions
    GET /api/v2/assistants/agentchecklists/{id} Config only, no runtime state

    What I'm hoping exists

    1. A REST endpoint returning tick/untick state per conversation, or
    2. A Notifications API topic that fires on tick events, or
    3. An EventBridge Analytics Detail Event topic for checklist transitions, or
    4. A Copilot-stamped custom property/dimension I can query via Analytics.

    Environment

    • Region: mypurecloud.com (US East)
    • Genesys Cloud CX + Agent Copilot add-on
    • Permissions verified (Copilot Admin + agentchecklist perms) - checklists display correctly to agents
    • EventBridge integration already live for Copilot Summary events - preferred path if a tick topic exists

    Questions

    • Has anyone built per-item checklist completion metrics? What source?
    • Is tick state persisted server-side or UI-only in this release?
    • Public API for checklist telemetry on the roadmap?

    I would especially value input from @Gruru Prasadh Jeevan Rao given the Nov 2025 checklist feature announcement, or @Jason Kleitz for routing if there's a better team to point this at.

    Will share back whatever I find. Thanks!


    #PlatformAPI

    ------------------------------
    Val Lyle
    Software Engineer
    ------------------------------



Related Content