Reference

Documo

Documo extension for Awell

Documo extension for Awell

Category: Demo. Adds 2 actions and 3 webhooks to a care flow.

What to configure

Set these once, on the extension in Awell Studio. An action fails at run time if a required setting is missing.

SettingRequiredNotes
Api KeyNoAPI Key Stored as a secret.

Actions

Documo adds these 2 actions to a care flow. Add one to a step, then fill in its inputs.

Get Document Field Values

Retrieve field values for a specific document in a Documo workspace.

This action can be previewed in Studio before you publish.

InputTypeRequiredDescription
Workspace IDstringYesUnique identifier (UUID) of the workspace the document belongs to.
Document IDstringYesUnique identifier (UUID) of the document to retrieve field values for.

Returns:

Data pointType
fieldValuesjson

Get Document Info

Retrieve metadata about a specific document in a Documo workspace.

This action can be previewed in Studio before you publish.

InputTypeRequiredDescription
Workspace IDstringYesUnique identifier (UUID) of the workspace the document belongs to.
Document IDstringYesUnique identifier (UUID) of the document to retrieve.

Returns:

Data pointType
addedAtdate
createdAtdate
documentResponsejson
fromstring
idstring
isUploadingboolean
namestring
pagesCountnumber
sourceIdstring
sourceTypestring
statusNamestring
tostring
typeNamestring
workspaceIdstring
workspaceNamestring

Webhooks

Documo can send these 3 events into Awell, where each one can start a care flow or move a patient along. Point the webhook at the URL Studio shows you when you enable it.

documentFieldValueAssigned

Payload:

Data pointType
patientFirstNamestring
patientIdentifiersjson
patientLastNamestring
patientMobilePhonestring
patientZipCodestring
receivingProviderFullNamestring
webhookDatajson

documentTypeUpdated

Payload:

Data pointType
documentIdstring
typeIdstring
typeNamestring
userEmailstring
webhookDatajson
workspaceIdstring

ocrDocumentCompleted

Payload:

Data pointType
extractedInfojson
webhookDatajson

Setup and notes

Documo extension for Awell that integrates with Documo's intelligent document processing platform.

Webhooks

OCR Document Completed

Triggered when OCR processing completes on a document. Uses an LLM to extract patient information from the OCR text.

**Data Points:

  • webhookData - Full webhook payload (JSON)
  • extractedInfo - Extracted patient information (JSON)

Document Field Value Assigned

Triggered when a field value is assigned to a document. Extracts patient and provider information from the document field assignments.

Data Points:

Data PointTypeDescription
webhookDatajsonFull webhook payload
patientFirstNamestringPatient's first name
patientLastNamestringPatient's last name
patientZipCodestringPatient's zip code
patientIdentifiersjsonArray of patient identifiers (e.g., MRN, insurance ID)
patientMobilePhonestringPatient's phone number
receivingProviderFullNamestringName of the receiving provider

Field Mappings:

The webhook maps Documo field names to data points:

Documo Field NameData Point
Patient First NamepatientFirstName
Patient Last NamepatientLastName
Patient Zip CodepatientZipCode
Patient IdentifierspatientIdentifiers
Patient Phone NumberpatientMobilePhone
Receiving Provider Full NamereceivingProviderFullName

Document Type Updated

Triggered when a document type is updated in Documo.

Data Points:

Data PointTypeDescription
webhookDatajsonFull webhook payload
documentIdstringDocument ID
workspaceIdstringWorkspace ID
typeNamestringDocument type name (e.g., "Other")
typeIdstringDocument type ID
userEmailstringEmail of the user who updated the type

Settings

  • Api Key**: Documo API Key

Development

Running Tests

To run tests for a specific file:

yarn run test -- <file name>

Or run all Documo tests:

yarn run test -- --testPathPattern='extensions/documo' --runInBand

Changelog

[Unreleased]

  • Initial release

Where this page comes from

The settings, actions, inputs, outputs and webhooks above are generated from the extension's own code, at @awell-health/awell-extensions v2.1.159. They match what the platform actually does rather than a description of it.

Field-level detail also appears in Awell Studio when you configure the action. Something wrong or missing? Email support@awellhealth.com.

On this page