Patient Preferred Name
- 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
How is Preferred Name Set Up? How to use Preferred Name in Artera MessagingHow to Configure Artera to Support Patient Legal Name?Where will a Patient's Preferred Name Display in Artera?The Patient's PerspectiveTroubleshooting Preferred NameFAQsBuild trust with patients by communicating with them through using their Preferred Name. Communicating with patients by using their Preferred Name helps to support your organization in remaining sensitive to patient preferences while fostering a meaningful connection with patients.
How is Preferred Name set up?
Integration work is required to support Preferred Names. Artera will work with your organization’s appropriate stakeholders to schedule a technical scoping conversation and review integration requirements. To begin the integration process, please connect with your Customer Success Representative.
At a high-level, your organization and Artera will complete the integration work to allow your EMR to send Artera your Patient Preferred Names by following Artera’s HL7 ADT & SIU Specifications. Once the interface updates have been completed and verified by a member of the Artera team, it is recommended that a Patient Extract Load is performed to update all existing patients’ Preferred Names in Artera to match the data in your EMR.
If your organization elects not to perform a Patient Extract Load, then patients will only start to receive messages with their Preferred Name when new demographic (ADT) and/or appointment (SIU) messages are sent from your EMR to Artera for that patient.
Once the integration work is completed, there is no additional build work necessary to support Preferred Name in Artera. If a Practice needs to use a patient’s Legal Name in outbound communication, the Legal Name Smart Phrase(s) can be leveraged.
How to use Preferred Name in Artera Messaging
Once your organization and Artera have completed the integration work, you may begin to communicate with patients using their Preferred Name. The {clientFirstName} and {clientFirstNameProperCase} Smart Phrases will automatically use the patient’s Preferred First Name, if available. If the patient does not have a Preferred First Name, these Smart Phrases will fallback to using the patient's Legal First Name from your EMR. The {clientLastName} and {clientLastNameProperCase} Smart Phrases will automatically use the patient’s Preferred Last Name, if available. If the patient does not have a Preferred Last Name, these Smart Phrases will fallback to using the patient's Legal Last Name from your EMR.
If you have completed the integration work to support Preferred Names but are not interested in using a patient’s Preferred Name in messaging for a specific patient or Practice, be sure to use the Legal Name Smart Phrases instead. These Smart Phrases will always use the patient’s legal name, regardless of if a Preferred Name is available. Click here to learn more about these Smart Phrases:
{clientLegalFirstName}
{clientLegalLastName}
{clientLegalFirstNameProperCase}
{clientLegalLastNameProperCase}
How to Configure Artera to Support Patient Legal Name
Quick Response
If you would like for a patient’s Legal Name to be used when sending a Quick Response, create or edit an existing Quick Response and include the appropriate Legal Name Smart Phrase, such as {clientLegalFirstNameProperCase} Smart Phrase within the message.
Note: It is recommended that you update the Quick Response’s Display Name to indicate to Users that it uses the patient’s Legal Name instead of their Preferred Name and prevent Users from inadvertently using the wrong Smart Phrase. For example: No Show - Patient Legal Name. Click here to learn more about how to create Quick Responses.
Manual Message
If a User needs to refer to a patient by their Legal Name when sending a Manual Message, the User should insert the {clientLegalFirstNameProperCase} Smart Phrase into the message. Click here to learn about sending Manual Messages.
Automations
There may be instances where an entire Practice needs to support sending Automations using the patient’s Legal Name instead of Preferred Name. If a Practice needs to refer to patients by their Legal First Name, you may update your Practice-level Automations to include {clientLegalFirstNameProperCase}. The following table is an example of how customers may update their Appointment Automations to support using the Legal First Name Smart Phrase:
Note: Updating Practice-level Automations with the Legal Name Smart Phrase will impact all patients within that Practice. It is not recommended to make changes to Automations in a Practice where there are some patients who need to be referred by their Preferred Name and others by their Legal Name.
Campaigns
Based on intended recipients of your Campaign, you may choose to send a Campaign message that refers to patients by their Legal Name instead of their Preferred Name. If this is the case, be sure to include the {clientLegalNameFirstNameProperCase} Smart Phrase within the Campaign message. Click here to learn how to create Campaigns.
Practice Settings
Only modify these Practice Settings to include {clientLegalFirstNameProperCase} if all patients within the Practice need to be referred to by their Legal Name instead of their Preferred Name.
Note: Changes to these Practice Settings will impact all patients in that Practice if you have a Practice.
Practice Holiday Hours
Line Hours
After Hours Response
Where will a Patient’s Preferred Name be displayed in Artera?
If you have completed the integration work to support Preferred Names, a patient’s Preferred Name will display in the following areas within quotation marks:
Across the Patient Channel
Above each Inbound Message from a patient, displayed within their Patient Channel
Patient Facesheet
Recent Messages View
Hovering over a patient's Preferred Name in this view will display their full nameScheduled View
Hovering over a patient's Preferred Name in this view will display their full nameEvent Messages that include a patient's name
The name that displays while a patient is typing in the Secure Messaging Portal
Patient Channel |
Inbound Messages |
Patient Facesheet |
Recent Messages View |
Scheduled View |
Event Messages |
The Patient’s Perspective
Patients who receive messages containing their Preferred Name will have their Preferred Name display as normal, without quotation marks:
Outbound Messages Delivered to Patients |
MPSP Patient Prompt |
Secure Messaging Portal Login and Messages |
Troubleshooting Preferred Name
There could be a variety of reasons as to why you may not see a patient’s Preferred Name in Artera. Use the diagram below to help troubleshoot and connect with your Customer Success Representative for further guidance:
FAQs
Can we search for patients using their Preferred Name?
Yes, patients can be searched by their Preferred Name within the Recent Messages and Scheduled Views. If the search is successful, the Patient Channel will display with the following format: Last Name, "Preferred Name"
Our organization completed the integration for Patient Preferred Name, but patient names are still displaying their Legal Name. How do we fix this?
Review the troubleshooting diagram above. If your organization did not perform a Patient Extract Load when implementing Preferred Name in Artera, then your team must wait for patient updates to come in as new ADT/SIU messages are received through our integration. Therefore, you may see some patient’s Preferred Names come over sooner than others.
Our organization wants to use Patient Preferred Names, how do we set this up?
At a high-level, your organization and Artera will complete the integration work to allow your EMR to send Artera Patient Preferred Names by following Artera’s HL7 ADT & SIU Specifications. Once the interface updates have been set up and verified by a member of the Artera team, it is recommended that a Patient Extract Load is performed to update all existing patients’ Preferred Names in Artera to match the data in your EMR.
If interested in using Preferred Name, please connect with your Customer Success Representative to initiate the next steps.
Our organization wants to use Patient Legal Names, how do we set this up?
If your organization has implemented Preferred Names, you will need to use the appropriate Legal Name Smart Phrase(s) in your messages. Click here to learn more.
If your organization has not implemented Preferred Names, then no additional work is required and you may continue using the {clientFirstName} and {clientFirstNameProperCase} Smart Phrases, where necessary.