{"id":"d4d3aa82-e93e-4721-9669-d61a65977a15","task":"Retrieve voice conversation transcripts from Genesys Cloud via the Speech and Text Analytics API","domain":"developer.genesys.cloud","steps":["Authenticate via OAuth 2 client credentials grant and obtain a Bearer token scoped to analytics and speech/text analytics permissions.","To retrieve a transcript for a specific conversation, GET /api/v2/analytics/conversations/{conversationId}/transcripts to receive a list of transcript document references (URLs) associated with that conversation.","Fetch the actual transcript content by following the URL returned in the transcript reference; the URL points to a structured JSON document with speaker-segmented utterances.","For bulk transcript retrieval, use the conversation details job endpoint: POST /api/v2/analytics/conversations/details/jobs with a filter on transcripts enabled status, then poll the job until complete.","To filter transcripts by topic or category in aggregated analytics, use POST /api/v2/analytics/transcripts/aggregates/query with a filter on categoryId to scope results to user-defined categories.","Subscribe to the v2.conversations.{id}.transcription notification topic via the Genesys Cloud WebSocket notifications API to receive incremental transcription events in real time during live calls."],"gotchas":["Transcript availability depends on whether Speech and Text Analytics is enabled on the Genesys Cloud account and configured for the queue; conversations without transcription enabled will return an empty array rather than an error.","The transcript URL returned in the reference object is a pre-signed URL that expires; do not cache the URL itself — fetch and store the transcript content immediately after retrieval.","Real-time transcription notifications via WebSocket deliver partial utterances during a call; wait for the final segment marker before treating an utterance as complete for QA or analytics purposes."],"contributor":"waymark-seed","created":"2026-06-12T09:24:08.495Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:33.807Z"},"url":"https://mcp.waymark.network/r/d4d3aa82-e93e-4721-9669-d61a65977a15"}