Key Terms
Key Terms
Business = Business/Law Firm who invested in Hona
Hona (Business) Org = Hona Account owned by the Business
Business User = An individual account within a Hona Business Org
Just like there are many employees at 1 Business, there are many Users in 1 Hona Org. Which Hona features and settings are accessible to each User is determined by their User Role.
Client = Client of the Businessa
End-user of Hona Client and its features
Lead = potential Client of the Business
Hona Client = Hona Client Portal interface where Clients can interact with Hona features
Business Users build Hona Client features in their Hona Business Org
Important to know in general:
"Project" is used interchangeably with "case" and "matter"
CMS = Case Management Software (often used interchangeably with CRM)
Messages = 2-way messages sent through Hona's 2-Way Messaging feature (typically sent via text)
Notifications = messages sent to the Client to notify them of Hona features you have configured (Project Type case updates, Forms, E-Signature requests, Review requests, etc). These are sent based on the Client's Notification Preferences.
Before Getting Started
Before Getting Started
Your MyCase integration will need to be connected to your Hona Org to get access to your MyCase fields in your Data Mapper, and you will need to have at least one Project Type before you can map the values of those fields to them.
Regardless of what integration you have connected to your Hona Org, the 2 steps for Project Type Mapping remain the same: first, you will map CMS/CRM fields by configuring your Data Mapper, and then you will map the correlating values of those fields directly to each of your Project Types in Hona.
Goal
By the end of this article, you will understand how to configure your MyCase Data Mapper. Doing so allows you to map values to your Project Types to enable automatic Project and Contact creation, as well as map your Phases to enable Client Portal access, automated notifications, and other valuable Hona features.
Overview of Steps
1. Configure MyCase Data Mapper
a. Access Hona Org's Integrations
From the side-bar in your Hona Business Org, select Company Settings β Integrations
b. Open MyCase Data Mapper to Map Fields
Verify your MyCase integration is connected, and then select Map Fields.
This will open the MyCase Data Mapper. At first, you will only see two sections. These sections contain the Hona fields which must be mapped to MyCase fields to enable your Project Type and Phase mapping.
Required Mappings (for Project creation)
You must map fields here for Hona to automatically generate new Projects (and therefore, the Client contacts associated with them).
Custom Mappings (for Contact creation)
These are the fields which Hona pulls by default to create new Contacts. You will likely not need to edit them unless you enable Multiple Contacts on a Case or need to change where Hona references general contact information in MyCase (very unlikely).
c. Generate Access to MyCase Fields
To see the existing fields in your MyCase, run the Case ID of an existing case and the Data Mapper will display all of the fields attached to that case. The fields on all of your cases in MyCase are the same, so it isn't important which Case ID you choose. You can select Get Random ID for Hona to capture one for you, or you can copy a Case ID directly from MyCase, paste it into the bar which reads External ID and press Enter.
When mapping fields between softwares, the most important thing is that the wording matches exactly in both softwares. Without this, Hona will not be able to correlate the value you map to your Project Type with the correct field it should be referring to in MyCase. One missed or un-capitalized letter will make it so your fields/values do not match, and they will be out of sync.
To help make sure the fields you map in Hona match your fields from MyCase exactly, we have you configure your MyCase Data Mapper using data pulled from the fields which already exist in your MyCase. This will allow you to select from those existing fields/values instead of manually typing every field/value into your Mapper, which poses high risk for error.
d. Map Required Fields:
There are 3 Hona Fields that must be mapped to a MyCase field to be able to map your Project Types and Phases. Once your MyCase fields are identified and mapped here in the Data Mapper, you will be able to map your Project Types (and Phases) directly using the values from those fields.
Project Type
Project Type
The MyCase field mapped here will determine which Project Type your Client(s) are assigned when their Project is generated in Hona. Typically, most Businesses will map their Project Types to the following MyCase fields:
Practice Area (Recommended)
Custom Field
Phase Name
Phase Name
The MyCase field mapped here will determine what Phase your Client is assigned in their Project Type. Typically, Businesses will map their Phase Names to the following MyCase fields:
Case Stage (Recommended)
Custom Field
Task Name + Status (Not recommended but doable, see FAQ)
Hona Enabled
Hona Enabled
The MyCase field you map here is typically a custom field you create with an Onboarding Manager during Hona onboarding. If you decide to use a different field, keep in mind that you will need to take extra steps to make sure it is mapped correctly. The purpose of this field is to help you filter which cases get synced into Hona and notified, from the MyCase side of the integration. For more information on the functionality of this field and on how to configure it, please visit MyCase: Disabling Hona from a Single Case.
After running a Case ID through your MyCase Data Mapper, a new section will appear at the bottom called MyCase Fields. This is a bank of all of the case and contact fields being pulled from your MyCase. If you want to change any of the fields which are mapped in the Required or Custom Mappings, you can choose from this total list of available fields and select Map. The majority of fields which pull through into this section will not be used, but are available to you.
Need a little help? The Data Mapper can seem a little intimidating at first since a lot of data pulls through when you run a Case ID, and these integration terms may be a little new to you. To see an example of a fully-mapped MyCase Data Mapper, open the drop down below:
Show me a completed MyCase Data Mapper
Show me a completed MyCase Data Mapper
The MyCase field titled Practice Area is currently being mapped to the Hona field Project Type.
This will make it so you can map your individual Project Types with values from the Practice Area field. After that, Hona will automatically assign your Client's Project Type in Hona based on the value of their Practice Area field in MyCase.
The MyCase field titled Case Stage is currently being mapped to the Hona field Phase Name.
This will make it so you can map the Phases of your Project Types with values from the Case Stage field. After that, Hona will automatically assign your Client's Phase in Hona based on the value of their Case Stage field in MyCase, after assigning their Project Type.
**The values from both of these MyCase fields are displayed in the Data Mapper as well after you run the Case ID. Remember, these values are unique to the case whose ID which was run. The display of these values is just for verification that you chose the right field from MyCase, and it's not likely that you will use these values for any Project Type or Phase Name mapping in the Data Mapper. You will, however, be using these values later to directly map your Project Types (and Phases) in a different part of Hona. This is not the case for Hona Enabled, which you will map directly to a value in the Data Mapper (see visual again and read below).
The value for the MyCase custom field Hona Enabled is currently being mapped to the Hona field Hona Enabled.
A Client's Hona Enabled field in Hona will therefore be determined by the value of the Hona Enabled field on their case in MyCase (see FAQs below).
2. Map Project Types
a. Access Hona Org's Project Types
From the side-bar in your Hona Business Org, select Company Settings β Project Types
b. Add Mapped Values to Project Type
To map a Project Type, click the 3-grey dots in the top right-hand corner β Edit
In the Mapped Project Types section, add the values which the Project Type will be determined by. These values should come from the MyCase field which you mapped your Project Types to in the Data Mapper, and the values must be typed here exactly as they are spelled in MyCase.
Can my Clients see the values mapped to Project Type?
Can my Clients see the values mapped to Project Type?
No. Your Clients will not see the values you put here, and by default will not even see the Project Type Name configured at the top of these settings. They will only see the Project Type Name if you define that as Project Name in these same settings. By default, Project Name pulls from the Case name in MyCase, so this is what your Client's will see in their Client Portal unless you define otherwise.
Why can't I see a preview of available Project Type mapping options when I click here?
Why can't I see a preview of available Project Type mapping options when I click here?
If your Hona Project Type field in is mapped to the default Practice Area field in MyCase, you will see a drop-down of all available values from your MyCase Practice Area field. If you are using a different field for Project Type mapping (like a custom field), the values from that field are not likely to pull through for preview, so take extra caution to make sure they are typed the same as they are in MyCase.
After you press Save, Hona will begin automatically creating new Projects and Client contacts when syncing, either manually or during the automatic nightly sync. You do not need to map Phases for this to happen (see FAQ).
3. Map Phases
a. Add Mapped Values to Phase
To map a Phase, simply open the Phase and in the Triggers section, add the values which the Phase will be determined by. These values should come from the MyCase field which you mapped your Phase Name to in the Data Mapper, and the values must be typed here exactly as they are spelled in MyCase.
Can my Clients see the values mapped to Phases?
Can my Clients see the values mapped to Phases?
No. Your Clients will not see the values you put here. They will see the Customer Facing Name, which can be configured at the top of the Phase. This allows you to name the Phase whatever makes most sense for your Clients without changing the values of their correlating field in MyCase.
Why can't I see a preview of available Phase mapping options when I click here?
Why can't I see a preview of available Phase mapping options when I click here?
If your Hona Phase Name field in is mapped to the default Case Stage field in MyCase, you will see a drop-down of all available values from your MyCase Case Stage field. If you are using a different field for Phase mapping (like a custom field or tasks), the values from that field are not likely to pull through for preview, so take extra caution to make sure they are typed the same as they are in MyCase.
Your Phase Name Triggers save automatically after you add them. Once added, Hona will begin automatically assigning Projects to this Phase (either manually or during the automatic nightly sync), which will also trigger any notifications attached to the Phase's configured features.
FAQs
What if I only have one Project Type that I want all Clients to go into?
What if I only have one Project Type that I want all Clients to go into?
In that case, you will map all of the values from the field you are mapping to Project Types. This will make it so if you want to create additional Project Types down the line, your Hona Org is already configured for filtering.
The Project Type a Client is assigned in Hona will determine their entire experience since this is the backbone for firing all notifications such as case updates, Drip Notifications, Birthday Messages, and access to Form requests, NPS Surveys, and other Client Portal features.
Why don't you recommend using Tasks for Phase Name mapping/Phase progression?
Why don't you recommend using Tasks for Phase Name mapping/Phase progression?
1) MyCase does not send task information during a manual sync, only during a whole account nightly sync. This means you will not be able to test successful syncing of your Project Types using task-based Phase progression without making a plan with your Onboarding Manager to do so. This is not the case for information synced for phase-based Phase progression.
2) Task-based Phase progression also makes internal staff implementation and long-term management of Hona a heavier lift since there will be more technical logic that needs to be understood by everyone at your firm, not just the person in charge of setting up Hona. With that being said, we typically recommend creating Case Stages or a custom field which correlates with your task flow instead of mapping your actual task data to your Data Mapper or Phases, unless your internal staff has a strong, well-understood task flow that is not edited regularly. Case Stages are more of a 1:1 feature with Hona Phases than tasks, which makes understanding their progression (and overall function) much more attainable with your staff in the short- and long-term.
Why do you map a value for Hona Enabled, but map a field for Project Type and Phase Name? Is this not an extra step?
Why do you map a value for Hona Enabled, but map a field for Project Type and Phase Name? Is this not an extra step?
There are only 2 values (Yes or No) for the Hona Enabled field in Hona, both of which are hard-coded into Hona so you don't need to define them like you do Project Type and Phase values. The values for Project Type and Phases are completely Business-dependent because they are determined by the fields which you have configured in your MyCase. If you were to use a MyCase field for Hona Enabled that is not the one you created with an Onboarding Manager, you will be required to define the values from that field which mean Yes and No in Hona since they will not be hard-coded by default.
Why is only Project Type mapping required for Projects and Client contacts to be created in Hona, but not Phase mapping?
Why is only Project Type mapping required for Projects and Client contacts to be created in Hona, but not Phase mapping?
Simply put: Hona gets all the case information it needs to create a Project and its correlating Contact(s). However, it doesn't have enough case information to trigger any notifications which aren't Phase-dependent, and the vast majority of automations in Hona are dependent on your Phases/their mapping. Not mapping your Phases will not prevent Project or Contact creation; however, it will decrease the value of Hona by misunderstanding its core purpose.
The primary purpose of creating/mapping your Phases is to enable your Client Portal and all of the features which are configured for your Clients there to help your Business. Without Phases, Hona features will need to be triggered manually every time you want to use one, and the features available to your Clients without a Case Tracker (which does not exist without Phases) will be overall less satisfactory and valuable. Automations, which bring your Business and Client experience immense value, depend on timing, and Phases are how we "time" or "pace" the notifications your Clients receive automatically, and what features they receive access to through those notifications.
Conclusion
Making sure that you configure your MyCase Data Mapper correctly will ensure that what your Clients see and receive in Hona is accurate and timely. Properly mapping your fields and values allows Hona to automatically generate new Projects, assign Clients to the correct Project Type and Phase, and keep all synced data consistent. This setup not only prevents syncing errors but also simplifies how your team manages Clients and case updates across both platforms. For any questions or concerns, please chat with our support team or reach out to us directly at [email protected].










