Source: https://vaultcrmhelp.veeva.com/doc/Content/CRM_topics/Call_Reporting_2/Executing/Activities/KeyMessages.htm ## Using Key Messages on the Call Report Key Messages enable users to quickly capture detailed information about their call activities via predefined picklist options. Key Messages are delivered for each product or detail topic selected in the detailing section. **Who can use this feature?** * End Users — Browser, iPad, iPhone, Windows * [Using Key Messages](#Using) * Users do not require an additional license ### Configuring Key Messages for [![Closed](../../../../../Skins/Default/Stylesheets/Images/transparent.gif)End Users](#) To configure this feature, ensure [Configuring Call Reporting](../../ConfiguringCR.htm) is complete. ### Using Key Messages as [![Closed](../../../../../Skins/Default/Stylesheets/Images/transparent.gif)End Users](#) Selecting a detail topic or detail product in the Detailing Priority section automatically creates a corresponding subsection under Key Messages, if any Key Messages are available for the detail topic or product. Key Messages which are not associated with a product are available under the General Comment subsection. The General Comment subsection displays first, followed by the subsections for detail topics, detail topics with groups, detail products, and detail products with groups, depending on the detail topics or products selected. When product groups are enabled, the product group displays after the detail topic or detail product name, separated by a pipe character. For example, Product A | Bovine. Key Message subsections are sorted by detail display order based on the display\_order\_\_v field on the product\_\_v record. If display order is not available, the subsections are sorted alphabetically in ascending order based on the name\_\_v field on the product\_\_v record. Key Message names may be up to 128 characters in length. To remove a Key Message from the call report, select the Delete icon. When the call report is saved or submitted, the corresponding call2\_key\_message\_\_v record is deleted. Browser iPad, Windows iPhone To add a Key Message on the Browser platform, select the Add Key Message action. The Add Key Message modal displays active Key Messages corresponding to the subsection. Search for and select the appropriate key messages. The search is executed on the Message and Description columns of the Add Key Message modal. ![](../../../../Resources/Images/Activities/CallReporting/KM Screenshots/BrowserKM2.png) Key Messages which are already added to the call report display in gray. ![](../../../../Resources/Images/Activities/CallReporting/KM Screenshots/Copy of KMBrowser2.png) Select Add to add the selected Key Messages to the call report. ![](../../../../Resources/Images/Activities/CallReporting/KM Screenshots/Copy of KMBrowser3.png) To add a Key Message on the iPad or Windows platform, select the Add Key Message action. Active Key Messages corresponding to the subsection display in a picklist. ![](../../../../Resources/Images/Activities/CallReporting/Default/iPadKM1.PNG) Select the appropriate Key Messages, then select Done to add them to the call report. ![](../../../../Resources/Images/Activities/CallReporting/Default/iPadKM2.PNG) To add a Key Message on the iPhone platform, select the Add Key Message action. Active Key Messages corresponding to the subsection display in a picklist. ![](../../../../Resources/Images/Activities/CallReporting/KM Screenshots/AddKM2iPhone.PNG) Select the appropriate Key Messages, then select Done to add them to the call report. ![](../../../../Resources/Images/Activities/CallReporting/KM Screenshots/AddKM3-iPhone.PNG) #### Translating Key Messages Key Messages can be translated to support multilingual implementations. The language\_\_v field in the key\_message\_\_v object stores the language for which the message should be available. Available Key Messages are those where the language\_\_v field matches the user’s language as defined in the language\_\_sys field on the user\_\_sys object, or where language\_\_v is blank on the Key Message. The following Vault standard user languages do not have a matching value in the standard Key Message language picklist. Admins must create corresponding custom picklist values for the language\_\_v field on the key\_message\_\_v object: | Vault User Language | Custom Value for Key Message Language Picklist | | --- | --- | | Dutch (nl) | nl\_nl\_\_c | | English (en) | en\_us\_\_c | | Korean (kr) | ko\_\_c | | Simplified Chinese (zh) | zh\_cn\_\_c | For Japanese language users, Key Messages are sorted in the following order: * Hiragana * Katakana * Half-width Katakana #### Displaying Key Messages by Detail Group For users who detail products that have different indications or are prescribed for different species, featuring the detail group helps distinguish between Key Messages for each application of the product. When detail groups are associated with Key Messages, the Key Messages are grouped according to detail group. For example, a product is indicated for both poultry and equine use. Each of these different applications has a different detail group defined, and different Key Messages associated with it. On the call report, Key Messages for the equine detail group display separately from Key Messages for the poultry detail group. #### Requiring Key Messages The require\_key\_message\_\_v field on the Product Catalog object enables organizations to determine if a Key Message is required when a product is detailed. If the **require\_key\_message\_\_v** checkbox is selected for a product, then Vault CRM requires that a Key Message is selected and Key Message reaction\_\_v and vehicle\_\_v fields are populated, if configured. #### CLM Key Messages When users deliver Key Messages using CLM content, ensure they have at least Read field permission for the following fields on the key\_message\_\_v object: * clm\_id\_\_v * media\_file\_name\_\_v Granting at least read field permission ensures Key Message details display in their appropriate sections on the call report (either Key Messages or CLM Details). CLM Key Messages do not display in the Key Messages section when users create or edit a call report. If the media\_file\_name\_\_v field is populated on a key\_message\_\_v record, the Key Message is considered a CLM Key Message and it is displayed in the CLM Details section of the call report. For more information on CLM Key Messages, see [Tracking CLM Key Messages](../../../Multichannel/CLM/TrackingCLM/TrackKeyMsg.htm). ### Related Topics [Customizing Key Messages](CustomizeKeyMessages.htm) [Tracking CLM Key Messages](../../../Multichannel/CLM/TrackingCLM/TrackKeyMsg.htm)