Medplum

Getting Started

In Medplum, under Project > Clients, create a new Client for Tellescope. We recommend making this client an Admin to avoid any issues in our integration, but you can experiment with different restrictions if needed.

Once you've created a Client for Tellescope, click into its ClientApplication page, and then go to the Details tab. You will need the ID and Secret.

In Tellescope, go to the Integrations page and find the card that says Medplum. Click it to add the necessary credentials. For environment, the default Medplum environment is https://api.medplum.com. If you have a self-hosted instance of Medplum, you should provide your base API URL. If the environment or credentials are invalid, you will see an error message and wont be able to complete the connection.

This connection step is required for Tellescope to properly handle some webhooks from Medplum (e.g. Appointment)

By default, Tellescope will not use these credentials to Write anything to Medplum.

 

Medplum —> Tellescope

You can create Subscriptions in Medplum to notify Tellescope when resources like Patients and Appointments are created or updated. Tellescope will create (if needed) or update a corresponding record in our backend, storing its Medplum ID to keep records in sync moving forward.

Medplum Subscription

Create a subscription which matches the following example

The Endpoint should be https://api.tellescope.com/v1/webhooks/medplum

The Header should look like this (without brackets)

• Authorization: API_KEY {YOUR_TELLESCOPE_API_KEY_HERE}

We use this Header to authenticate the connection and match the corresponding patient to your Tellescope account.

💡 Make sure to use the Secret Key of your API Key and not the ID

 

The following Criteria options are supported (with some important notes!):

• Patient
• Appointment
  • To match a Medplum Practitioner to a Tellescope User attendee on a CalendarEvent, the Medplum Practitioner ID must be saved as part of the User profile in Tellescope. This field can be edited in our User management UI after Medplum has been connected to your Tellescope organization.
  • If an unknown Patient is included as an attendee on an event from Medplum, we will automatically sync them to Tellescope before creating the CalendarEvent in our system