Hi Paul,
Sorry for ghosting you on this one.
I've passed along your comment about the API documentation to the product owner of the Developer Center. Most of the APIs do describe the response payload/format if you expand the 200 OK response, but it is true that some APIs don't do a great of documenting the response payload.
For #2, Participant ID is not exposed in Flows or Scripts, so you'll need to make a Data Action request to obtain that id for the specific participant.
For #3, I'm not aware of a way to monitor if/when there is a pause in the customer speaking.
For #4, there is no way that I'm aware of to play any kind of audio that is not a pre-defined prompt file.
I hope that answers your questions.
------------------------------
Jim Crespino
Senior Director, Developer Evangelism
Genesys
https://developer.genesys.com------------------------------
Original Message:
Sent: 06-22-2026 13:36
From: Paul Simpson
Subject: Recording Audio from a Flow
Thanks, Jim.
A couple of things.
- The documentation (personal bug-bear of mine) doesn't give details of the returned objects from API calls (It's very good at providing the status codes though!). I'm assuming the URL of the recording is in there, but what is it called / how is it structured? - Normally, I would execute the action from the explorer and look-see, but that's a little hard to do with this one!
- Is ParticipantID (I'm assuming for the caller?) exposed as a built-in variable, or will it require another Data action to get it?
- I see you mention using a second Data Action to stop the recording. Is there any way to detect when someone stops speaking, or perhaps timeout if they don't say anything?
- I know it wasn't part of the initial ask, but I can see others wanting to play the recording back to the caller for confirmation. Can we do that too? Another DA, or using a Play Audio?
I appreciate your assistance!
------------------------------
Paul Simpson
Views expressed are my own and do not necessarily reflect those of my employer.
------------------------------
Original Message:
Sent: 06-11-2026 10:30
From: Jim Crespino
Subject: Recording Audio from a Flow
Hi Paul,
For #1, I believe it might be possible to develop a custom solution that would handle the use case.
To start with you need to record the caller's name. You can do that today from Architect by making a Genesys Cloud Data Action request to call this API to start/stop the recording of a snippet of audio: https://developer.genesys.cloud/devapps/api-explorer#post-api-v2-conversations-calls--conversationId--participants--participantId--snippet-record. That recording snippet will be a separate audio file saved alongside the entire recording in Genesys Cloud.
To play that audio file back to the agent at the start of handling the callback you would need to develop a small web app that would authenticate with Genesys Cloud using a PKCE grant OAuth client, use the Recording APIs (https://developer.genesys.cloud/devapps/api-explorer#get-api-v2-conversations--conversationId--recordings and https://developer.genesys.cloud/devapps/api-explorer#get-api-v2-conversations--conversationId--recordings--recordingId-) to retrieve the specific snippet recording, retrieve the audio file using the signed S3 URL provided by the Recording APIs, and finally use native Javascript to play the audio to the agent. It sounds complicated but it is really straightforward to develop. This web app can be embedded in an agent script using a Web Control and will run automatically when the agent script displays, or could be controlled via a custom button action.
If you would need help with any of this, Genesys Professional Services could consult & assist to help you with the development or they can build it for you. If that is of interest to you then please reach out to your Genesys account manager.
------------------------------
Jim Crespino
Senior Director, Developer Evangelism
Genesys
https://developer.genesys.com
------------------------------