Referral Conversation Flows
- Get Started
- Release Notes
- Automations
- Patient Channel
- Troubleshooting and FAQ
- Patient Facesheet
- Technical Specifications
- Insights & Analytics
- Collaborative Inbox
- Conversation Flows
- Campaigns
- Lines & Resources Requests
- Lines, Events, Resources
- SMS Basics
- Triggers
- Referrals
- Add-Ons
- Users and Groups
- Platform Settings and Configuration
- Self-Rescheduling
- Recalls
- Marketplace
- Pulse Outreach
Table of Contents
Create Conversation FlowAdd Root Messages and Patient ResponsesSpanish TranslationsAdding Phone Conversation FlowCall ForwardingEnable Conversation FlowAdding Conversation Flows Smart Phrases in TriggersDeliver Referral Triggers using Conversation Flows, allowing you to automatically deliver a multi-step scheduling workflow to patients minimizing staff intervention. Additionally, Conversation Flows can automatically write back the patient’s response to your system of record (EMR).
When using Conversation Flows, it is important to note that English and Spanish are the only supported languages. If you need to support additional languages, consider using Artera's standard Referral Triggers.
Scenario
We have found that it is helpful to map out the desired Conversation Flow before building it. This article will focus on building the following Conversation Flow and the related Referral Trigger.
The goal of the Conversation Flow is to have the patient call to schedule their Referral. If the patient does not want to schedule, the organization would like to understand why and capture that data.
Create Conversation Flow
This section focuses on one specific Referral Conversation Flow and does not provide a complete view of all Conversation Flows features. For thorough documentation on Conversation Flows, including Conversation Flow nuances and Action details, click here.
- From the Navigation Bar, select Automations > Conversation Flows.
- Click Create New in the upper-right corner of the page.
-
Fill in the Setup menu:
- Conversation Flow Name: Enter the display name for the Conversation Flow as it will appear on the Conversation Flows List page.
- Description: Include a description of the intended use case and any relevant details you want to appear on the Conversation Flows List page.
-
Smart Phrase: Create a custom Smart Phrase (without spaces) that will be used to trigger the Conversation Flow. The same Smart Phrase can be used for SMS and Voice versions of the Conversation Flow.
- For Referral-specific Triggers, include 'Referral' at the beginning of the Smart Phrase (e.g. referralScheduleReq).
- Communication Methods: Determine whether you would like to create an SMS/Text or Phone Conversation Flow.
- SMS Timeout: Specify the time period that you would like the Conversation Flow to be open to responses before the session is terminated. This value applies individually to each message sent.
- Select Start once all Setup items are entered.
Add Root Message and Patient Responses
Once you have completed the Conversation Flow's configuration, you will be routed to the Builder view to begin building your messages. Note: You can update the Conversation Flow's settings at any time by navigating back to the Settings tab.
Process Steps
-
Indicate the languages you would like to support in the Conversation Flow. English and Spanish are currently supported.
-
Create your first message by selecting the + within the gray Add Message box:
NOTE: In order to provide Referral writeback statuses to your EMR, a Referral Conversation Flow must contain at least two messages.
-
Once on the Create Message window, you will be presented with the following fields to complete. Once completed, select Update to create the outgoing message to the patient:
- Internal Title: An internal-facing label associated with the Conversation Flow to provide easier search and identification of Conversation Flows.
- Message Content: This is the first message the patient will receive (known as the Root Message). Be sure to include the ask of the patient and expected responses. If you are including a Spanish translation, be sure to insert the Spanish message within the Spanish field.
-
Next, you will populate the Patient Responses based on the message. You will need to define one or more Patient Responses within your outbound message. These create the parameters for the patient's reply and allow you to define the proper branch of the Conversation Flow the patient should receive next. Click Add Response.
-
Patient Input - Use the drop-down menu to select the response value. The following response options are available for selection:
- 0-10: In situations where the patient has more than two options, we recommend using numbers for the Patient Response options
- True, False
- Yes, No: In situations where the patient only has two response options, we often recommend choosing the Yes and No response options.
- Low, Medium, High
- Small, Large
- Unrecognized Response: Use Unrecognized Response to automatically respond to a patient who messages in something other than the defined variable ('No' in this example)
- Internal Description - Enter the associated message you want to appear in the Patient Channel for your staff to review. These messages will help give context to staff when they are reviewing the Conversation Flow's history.
-
Patient Input - Use the drop-down menu to select the response value. The following response options are available for selection:
- Once updated, the Conversation Flow will reflect your initial outgoing message and possible branches based on a patient's response:
- Next, let's add an Action for the 'No' Patient Response. To do this, hover over the Patient Response you wish to add an Action for and click the '+ Action' button that will appear
- Select Add Action to choose the appropriate Action from the drop-down menu, Here, we can use the Action Types to control how Artera responds to this response from the patient. For this scenario, we are going to indicate that the patient declined the Referral Request and then we will close the Patient's Channel.
- Next, we will add the next message in the Conversation Flow by navigating to the gray Add Message box within the 'No' Patient Response branch and select the '+' to add the next message.
- Similar to the Root Message configuration, add your Outgoing Message and identify the expected Patient Responses. Be sure to associate the Patient Responses and click Update. Including an Unrecognized Response option allows you to automatically take action on any messages that fall outside of the defined Patient Responses.
-
Now, let’s add the next message associated with the '1' Patient Response.
- Enter the desired Outgoing Message and click update. Repeat for the other three Patient Response options.
- Next, let's define the 'Yes' Response option we established from the Root Message. We will add the next message by navigating to the gray Add Message box within the 'Yes' Patient Response branch and select the '+'.
- Add the message and click Update.
- Add an Action for the 'Yes' Patient Response to tag a team member in the Patient's Channel. Add the Action by hovering over the Patient Response and select '+ Action.'
- Once all information has been entered and validated, select Create in the upper right corner to create the Conversation Flow.
Spanish Translations
If you elected to include a Spanish translation, you can view those translations by toggling the language buttons:
Edit Text
To update the translated text, click on the appropriate Message box and edit the Spanish translation. It is highly recommended to verify your translations with a proficient speaker. Select Update once done.
Adding Phone Conversation Flow
If you would like to run the same Conversation Flow but using Voice instead of SMS, create a new Conversation Flow matching the previous SMS Conversation Flow. Use the same Smart Phrase and for Communication Methods, choose Phone.
Verbiage Differences
When building Call Conversation Flows, it can be helpful to update the Patient Responses to numbers, e.g. instead of responding “No” to decline, use press “5” to decline. This makes it easier for patients to choose the correct response option.
Call Forwarding
Depending on your workflow, you may find it helpful to use the Action Type of Accept Referral Request. Choosing Accept Referral Request will write back the patient's acceptance of the Referral to your EMR. You will also be asked to choose whether you would like to “Transfer to Referral Phone Line":
Toggle this field on (purple) to transfer the phone call to the Line that sent the Trigger.
Leave this field off (default) to keep the phone call on the current Line.
Enable Conversation Flow
When you have completed your Conversation Flow build, select the Conversation Flow's (...) Actions menu and choose Turn On.
Adding Conversation Flows Smart Phrases in Triggers
Once you have created and enabled your Conversation Flow, the next step is to add it to your Referral Triggers.
- Configure your Trigger, as desired.
- When you reach the “What should this Trigger say? section, add the Conversation Flow's Smart Phrase within two curly brackets {}.
- If you have included English and Spanish Translations, ensure that you add the Smart Phrase into the Spanish Translation box as shown. If you do not add the Translation, the initial Conversation Flow message (Root Message) will be delivered in English to the patient with any subsequent messages in the Conversation Flow delivered in Spanish. Make sure your translation is following the same security setting as the English version (Secure or Unsecure).
- Next, if you have created a Phone version of the Conversation Flow, include the Smart Phrase in the Call section of the Trigger as shown, also respecting Translations, if included.