> For the complete documentation index, see [llms.txt](https://docs.opendialog.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.opendialog.ai/~/changes/BlkAxgfqkBZsmUnZLd8K/opendialog-platform/conversation-designer/message-design/message-editor.md). # Message editor ## Finding the message editor There are two ways to access messages: **Option 1:** The Messages functionality is available as part of the Design functionality. Design includes both Conversation, where the conversation design occurs and Messages, where we access the message editor and work on everything to do with the content and assistant prompts. If Messages is not viewable in the sidebar, click the carrot (down arrow) to the right of Design to expand.

{% hint style="success" %} * Open your OpenDialog application * Select the Scenario you would like to edit * Go to the Design section in the right hand navigation panel * Click on the arrow to reveal the drop down * Select 'Messages' {% endhint %} **Option 2:** From within the Conversation designer, navigate to the Message editor by clicking on the message icon in a Scenario, Conversation, Scene, Turn or Intent. This will take you directly to the messages related to the conversational component you are on (scenario, conversation, scene, turn or intent)

{% hint style="success" %} * Open your OpenDialog application * Select the Scenario you would like to edit * Go to the Design section in the right hand navigation panel * Select 'Conversation' * When on the conversation page, navigate to the top right hand corner * Click on the message bubble, which is the middle option of three icons {% endhint %} ## Finding specific messages Which messages you see in the list of messages depends on the level at which you enter the Message Editor. For instance, if you entered the editor at the scene level, you would only see the messages for that scene. If you enter the editor at the highest level, you see all messages for the scenario. Messages are associated with intents. For instance, a welcome message can be associated with an intent called "Welcome". Several messages can be associated with a single intent. For example, for a Welcome intent, we can have a message specifically geared towards new users, and one geared towards existing users. Our search functionality allows you to edit a specific word, sentence, or message. You can use OpenDialog Search to find a message or group of messages that contain the exact phrases or words you're looking for. You can access the 'Search' functionality in the main scenario menu, which searches for content throughout Intents and Messages.

Search across Intents and Messaes using the search functionality in the main scenario menu

To search for a specific message, click on the 'Search' item in the main scenario menu, and the search modal will appear right in the middle of your workspace. Then, enter your query in the search bar, and the modal will display the results instantly.

Enter your search query in the search bar that appears when selecting Search in the main scenario menu

By clicking on the appropriate search result from the list, you'll be directed to the chosen component, giving you the opportunity to edit the selected message with ease.

{% hint style="success" %} * Open your OpenDialog application * Select the Scenario you would like to edit * Go to the 'Search' section in the right hand navigation panel * Click on the button to reveal the search pop up * Start typing in what you are looking for * Select the message you want from the results {% endhint %} {% hint style="info" %} Note that the displayed messages in the message catalog are the sample message you have defined upon intent creation. The sample message is there to help you with the conversation design, and recognizing intents throughout the OpenDialog platform. When editing a message, this will not edit the sample message. {% endhint %} ## Adding or editing a message In the intent list, click the Edit icon for an existing message or click "Add a new message". An existing message can also be copied or deleted:

Multiple messages associated with a single intent

The Edit Message screen allows us to change the Message Name and customise the layout using a number of different [message types](#message-types). These types are covered in the next pages of this section. The following options are available in the Edit Message screen: * **Message name:** the name is purely to help you identify specific messages. The message name will automatically be prepopulated with the name of the app intent it is related to. Make the message names something that is easy to recognize and place. For ease of use and recognition, define your naming convention upfront when you start creating your conversational application. We recommend using the intent name, optionally followed by the condition if you are using one. *For example: WelcomeIntent - userID not set* * [**Layout:**](/~/changes/BlkAxgfqkBZsmUnZLd8K/opendialog-platform/conversation-designer/message-design/constructing-messages.md) this is where you can build your message content, add conditions to your messages, and set behaviours such as disabling text input and hiding the app avatar. * **Preview:** shows a preview of your message. More complex messages don't have a full preview available and are labeled in the preview by their message type. * **Conversation Designer:** shows the current position in the Scenario where this message is located * [**Conditions**](/~/changes/BlkAxgfqkBZsmUnZLd8K/opendialog-platform/conversation-designer/message-design/message-conditions.md): in the conditions tab you will be able to define when your message gets selected by defining conditional rules. *For example: if userID is not set*

## Enriched user experience OpenDialog's modular approach to messages allows you to take advantage of rich UI components, surface specific messages on your terms and personalize them to make them relevant to specific users or use cases. Check out the following sections to take your conversational application from simple question answering to a truly personalised hybrid experience :


Tailor the user experience	Master the art of crafting powerful messages tailored to your specific needs, utilising OpenDialog's diverse range of message types to their fullest potential.	/pages/KTFVU96B0yjrrAdogJSX	/files/83FGMq9GZJOVQA82QXQu
Surface relevant messages	Take advantage of OpenDialog's unique approach, using conditions to surface relevant messages at the right moment in the conversation.	/pages/MAivAdkUZsfswKTCN7qg	/files/EsYajKLgtErluEq6nboS
Personalize the messages	OpenDialog's attribute system will allow you to taylor your messages using these variables to surface personalised information.	/pages/CcDiZqm2OvSIFVSkOniP	/files/NPxE7UHL01Ihw9ljh6mP

--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.opendialog.ai/~/changes/BlkAxgfqkBZsmUnZLd8K/opendialog-platform/conversation-designer/message-design/message-editor.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.