Workflows
Asynchronous ambient documentation
Ambient note generation from audio recording and conversational transcript
Introduction
The Asynchronous Ambient Documentation Workflow is the most common “AI scribe” workflow in use today. While the real-time ambient documentation workflow is designed for scenarios where immediate processing and feedback are essential during the patient visit, this workflow processes a complete audio file and within seconds returns a document generated based on the conversational transcript. In scenarios where real-time processing isn’t required or feasible, the asynchronous workflow provides flexibility and predictability.
Endpoints and capabilities
Endpoint | Capability | Use |
---|---|---|
Interactions | The foundational unit that ties together all related data and operations, enabling a cohesive workflow from the start of the interaction to the generation of final documentation. | Required |
Recordings | Upload audio files that can be used for transcript generation | Required |
Transcripts | Generate transcripts for audio files that are associated with the interaction | Required |
Documents | Ambient note generation based on template and language defined in the request | Required |
Templates | Get details for available templates that define the structure and language of generated documents | Optional |
Workflow
1
Create interaction
- The workflow begins with the client initiating an interaction by sending a
POST
request to the/interactions
endpoint. - The API responds with a unique
id
for the interaction and a WebSocket URL (wssUrl
). The identifier will be used to manage the subsequent steps of the workflow.
2
Upload audio recording
- Once the interaction is initialized, the client uploads an audio file associated with that interaction by sending a
POST
request to/interactions/:id/recording
. - The API responds with a
200
status and returns arecordingId
, confirming that the audio file has been successfully uploaded and linked to the interaction.
3
Create conversational transcript
- After the recording is uploaded, the client initiates the transcription process by sending a
POST
request to/interactions/:id/transcripts
. - The API processes the audio and returns a
200
status with the generated transcript. This transcript contains the text version of the recorded interaction, extracted and formatted for review.
4
Generate document(s)
- Finally, the client creates the necessary documentation by sending a
POST
request to/interactions/:id/documents
. This request includes the transcript generated in the previous step and atemplateKey
to specify the format of the output document. - The API processes the request and returns a
200
status along with the final document, which is ready for use or further editing. - Submit multiple
POST
requests to the/documents
endpoint with differenttemplateKey
to generate multiple notes for a given interaction.
See details on Templates and how to use them here
Was this page helpful?