> ## Documentation Index > Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Use Buzz export const InlineImage = ({src, alt = '', height = '1.6em'}) => { return {alt}; }; ### Intro **Important:** Buzz Desktop has been deprecated. It is no longer available for download. The desktop app still functions but is no longer supported. Buzz is the messaging feature within Domo. You can use Buzz to have a conversation about a card, dashboard, or project or message a person or group directly. You can attach files, reference data elements, and tag other users. You can also interact with others' messages by adding them to your favorites, reacting to them, quoting them in replies, and more. *** ### Start a Conversation You start a Buzz conversation using the **Add Conversation** option, which is available either by selecting **Create a new message** or **Start a conversation or find an existing one**. start new conversation.jpg Selecting either opens a **New Message** modal in which you select the people and/or groups you want to converse with. (You can also open existing conversations from this modal.) After you find the user or group you want to start a conversation with, you indicate whether you want to begin a new topic of conversation or join an existing one. If the topic is new, you are prompted to enter a title for the topic as well as set privacy options. Finally, you can compose your message. Follow these steps to start a Buzz conversation: 1. (Conditional) If Buzz is not open, open it by clicking in the toolbar in the top right corner of Domo. 2. Click , which appears in the black bar above Buzz in the top right corner. Alternatively, if you are in the navigation pane, you can click next to "Conversations." The **New Message** dialog opens. 3. In the **People, Groups, or Conversations** field, enter the name of a person or group you want to start a conversation with. This adds the name of the person or group to the field. 4. (Optional) Repeat step 3 to add more users and groups to this conversation, if desired. 5. Turn on the **New Topic** toggle. 6. Enter a name for the new topic in the **Conversation Topic** field. 7. (Optional) Specify whether this conversation is to be private or public. If it is private, only the users whose names you have added to the filter box will be able to see it. If it is public, anyone in your company will be able to see it. 8. Enter your initial message for the conversation in the **Write a message** field at the bottom of the dialog. For more information about writing messages, see [Posting to Buzz](#h_9e5e9ca1-34fa-4add-91dd-82b5c50c6af9 "Chatting in Buzz"). 9. Press **Enter** when done. The conversation appears in the **Conversations** tab in your Buzz inbox so you can access it easily. For more information, see [Posting to Buzz](#h_9e5e9ca1-34fa-4add-91dd-82b5c50c6af9 "Chatting in Buzz"). ### Start a Conversation from a User Profile You can also initiate a conversation with a specified user from their Profile page. Follow the steps below. 1. Select **Message** under the user's photo then click the **Message** **\[ *user name* ]** button under it. profile_message_location.png 2. Enter your message in the **Write a message** field at the bottom of the dialog. For more information about writing messages, see [Posting to Buzz](#h_9e5e9ca1-34fa-4add-91dd-82b5c50c6af9 "Chatting in Buzz"). 3. Press Enter when done. The conversation is added to Domo and appears in the **Conversations** tab in your Buzz inbox so you can access it easily. For more information, see [Posting to Buzz](#h_9e5e9ca1-34fa-4add-91dd-82b5c50c6af9 "Chatting in Buzz"). ### Open an Existing Conversation You can open an existing People conversation in one of several ways. The most straightforward way is to open it from the **Conversations** list in the Buzz navigation pane (or the **Favorites** list, if you have added it as a Favorite). If the conversation does not appear here, you can find it easily by searching in the **Search Buzz** dialog. You can also open it from the **Discover** pane, though it may be harder to find the specific conversation you want. On top of this, you can open a conversation from the **Add Conversation** dialog. # Open a Conversation from the Conversations or Favorites List You can open an existing conversation from the **Conversations** or **Favorites** list in the Buzz navigation menu by following these steps. 1. (Conditional) If Buzz is not open, open it by clicking in the toolbar in the top right corner of Domo. 2. Locate the desired conversation by doing any combination of the following: * Navigating through the list of recent conversations in the **Conversations** list. * Navigating through conversations you have favorited in the **Favorites** list. * Searching for the desired conversation by clicking in the **Search** field to open the **Search Buzz** pane then entering a keyword into the search box. This search returns results for titles, users, and message content. 3. Click the conversation to open it in the conversation pane. You can now read it, reply to it, etc. # Open a Conversation from the New Message Modal You can open a conversation from the **New Message** modal (the same modal you use when starting a conversation, as explained above). Follow the steps below. 1. (Conditional) If Buzz is not open, open it by clicking in the toolbar in the top right corner of Domo. 2. Click , which appears in the black bar above Buzz in the top right corner. Alternatively, if you are in the navigation pane, you can click next to "Conversations." The **New Message** dialog opens. 3. In the **People, Groups, or Conversations** field, enter the name of the user, group, Page, Card, or Project that your desired Buzz conversation is centered around. 4. (Conditional) If you want to open an existing one-on-one conversation, select the name of the user in the **People & Groups** list. Otherwise, select the conversation in the **Existing Conversations** list (which opens below **People & Groups**). The conversation opens in the pane on the right. 5. Enter your message in the **Write a message** field. For more information about writing messages, see [Posting to Buzz](#h_9e5e9ca1-34fa-4add-91dd-82b5c50c6af9 "Chatting in Buzz"). # Open a Conversation from the Discover Pane You can open conversations from the **Discover** pane; however, if you are searching for a specific conversation, it is recommended you use one of the previously discussed methods. Follow the steps below. 1. (Conditional) If Buzz is not open, open it by clicking in the toolbar in the top right corner of Domo. 2. Click **Discover**. 3. Scroll through the pane until you find the conversation you're looking for. 4. Click the conversation to open it in the conversation pane. You can now read it, reply to it, etc. #### Open a Conversation from the User Profile You can open an existing one-on-one conversation with a user from his/her Profile page. Follow these steps: 1. Click the icon found under the user's photo in the top left corner of their Profile, then click the **Message** **\[User Name]** button under it. You can now read the conversation, reply to it, etc. ### Post to Buzz After you've started or opened a conversation, you can post by entering your message in the **Write a message** field at the bottom of the conversation pane. You can do all of the following when posting to Buzz: * Enter carriage returns using **Shift** + **Enter**. * Copy and paste text from other sources, including web pages. * Reference users, groups, cards, dashboards, and projects by entering the **@** symbol followed by the item you want to reference. Or you can use **@all** to reference all users and groups with access to the conversation. In a conversation centered on a card, dashboard, or project, if you attempt to reference a user or group without access to that card, dashboard, or project, you are given a warning and the option to grant access, as shown here: buzz_grant_access_2018.png If you click **Grant Access**, the user or group members are given access to the Card, Page, or Project. For more information about access sharing, see [Sharing Access to Cards and Pages](/s/article/360042932994 "Sharing and Removing Access to Content").

When you reference a Card, you can open a preview of the Card with different options. This is discussed later in this list. * Enter URLs. These appear as working hyperlinks when posted. You do *not* need to include " http\://"" in a URL for it to be converted into a hyperlink. * Attach files to your message by clicking the button, selecting **Upload** **a file**, and browsing to the desired file on your computer.

In the interest of preventing users from uploading malicious files into Domo accounts, Domo allows a specific set of file types to be uploaded. If you attempt to upload a file not within this list, an error message appears. For more information, see [Previewing a Document](/s/article/360043430213 "Permitted File Types for Attachments"). If you click an attached file with a file type that cannot be previewed, the standard "What would you like to do with this file?" dialog opens. * Reference cards in your message by clicking the button, selecting **Add a Card**, and searching for the card using the **Search** box. (You can also reference cards using @, as described previously.) You can only attach cards you have access to. As with attached files, referenced cards appear as thumbnails under the conversation pane and can be removed by clicking the red "x." If you attempt to reference a card in a discussion with a user without access, you are given the option to grant them access.

If you click a referenced card either before or after sending your message, a preview of the card opens. The preview provides options for jumping to the Details view, adding the card to [Favorites](/s/article/360043428373 "Understanding Pages"). * Add an emoji to your message by clicking and selecting the desired emoji. * Use special commands using "/." The following table lists some of these:

Command

Description

/invite \[ [someone@domain.com](mailto:someone@domain.com) ]

Can be used to invite anyone to a Buzz conversation, even if they do not have a Domo account. Domains in invited users' email addresses must be authorized in the Company Settings tab in Admin Settings for this to work. For more information, see Specifying Authorized Domains for Invited Users .

/giphy \[text]

Lets you insert an animated GIF in a message based on text inserted afterward. For example, if you said /giphy sasquatch, a GIF image of a sasquatch would appear in your Buzz . You can select from available GIFs after entering the giphy command, or you can insert a random GIF by pressing Enter after entering the command.

/roll

"Rolls" a random number between 0 and 100.

/support

Opens a window to the Help Center options. For specific information about creating a Support ticket, see Getting Help .

/todo \[text] Creates a personal task and adds it to your personal tasks list in Projects & Tasks. For more information, see Projects and Tasks .
If you have NLQ Bots enabled, you can also communicate with these Bots using natural language to retrieve information from connectors right in Buzz. For more information, see [Adding a Bot to Buzz](/s/article/360043430273 "Adding a Bot to Buzz"). ### Work with Messages When you mouse over any message in a conversation, a toolbar pops up with a number of options for that message: buzz_conversation_options_2018.png The three most commonly used options appear here; you can also click the ellipsis icon (...) to view several more. The following table describes the available options:

Option

Description

Like icon

Lets you "like" this message.

Reaction icon

Lets you include a reaction icon after this message and sets the value to 1.

Quote reply icon

Lets you reply to this message specifically. When you do this, the message is "quoted" in your reply so users understand the context.

Favorite icon

Adds this message to your Favorited Messages listing for in the details pane for this conversation.

Flag for follow-up Adds this message to your Flag for follow-up pane, allowing you to revisit it later.

Create thread icon

Lets you create a new thread using this message as a starting point.

Create task icon

Lets you create a task based on this message. For more information, see Creating and Assigning Project Tasks .

Edit icon Lets you edit a message you have already posted.

Delete icon

Lets you delete this message from Buzz. Only appears if you wrote the message or you have an "Admin" default security role or a custom role with "Edit Conversations and Messages" enabled. For more information about default security roles, see Managing Custom Roles .

# Favorite a Message When you "favorite" a message, the message appears with an orange star to indicate the "favorite" status, and it appears in your **Favorited Messages** in the Details pane for this conversation. You can access **Favorited Messages** by opening the Details pane for the conversation and expanding the **Favorited Messages** tab. **Favorited Messages** are specific to users in a conversation; if two users in the same conversation add different messages as favorites, each will see only the specific messages he favorited, *not* those of his coworker. Follow these steps: 1. Mouse over the message you want to favorite. 2. Click the ellipsis icon (...). 3. Select **Favorite**. The message is added to your **Favorited Messages**. You can see it anytime by opening the Details pane for this message and expanding the **Favorited Messages** tab. Follow these steps to "unfavorite" a message you've added as a Favorite: 1. Do one of the following: * Click the orange star before the time stamp in the conversation thread. * Open the **Favorited Messages** tab in the Details pane for the conversation and click the orange star. # Like a Message You can like a message in a conversation by mousing over the message and clicking the icon. If the message has not yet been liked, a icon appears after the message and the value is set to 1. If another user then clicks the toolbar icon or the thumbs up icon, the value is raised by 1. If a user clicks the toolbar icon or thumbs up icon a second time, his/her "like" is removed and the value decreases by 1. You can see all of your liked items in Domo in your Profile page. Follow these steps to like a message in Buzz: 1. Mouse over the message you want to like. 2. Click the like icon . (If the message has already been liked by another user, you can also click the icon.) If this is the first time the message has been liked, a icon appears and the value is set to 1. Otherwise the value of is raised by 1. Follow these steps to "unlike" a message you have already liked: 1. Click the icon. (You can also mouse over the message and click the icon in the toolbar.) The value of decreases by 1. If the value was already set to 1, the icon disappears. # React to a Message You can select a "reaction icon" to appear after a message. When you do so, the value of the icon is set to 1. If another user then clicks the reaction icon, the value is raised by 1. If a user clicks the reaction icon a second time, his/her reaction is removed and the value decreases by 1. If the icon is clicked a second time when the value is already set to 1, it disappears. Follow these steps to react to a message: 1. Mouse over the message you want to add a reaction to. 2. Click . 3. Select the desired reaction emoji from the library. The icon you selected is added after the message and the value is set to 1. If you react to a message with the same reaction as someone else, the value of the icon is raised by 1. Follow these steps to retract your reaction to a message: 1. Click the reaction icon you have already clicked. The value of the icon decreases by 1. If the value was already set to 1, the icon disappears. # Create a New Thread Based on a Message You can create a new thread based on an existing message by mousing over the message, clicking the ellipsis icon, and selecting . This icon appears only for top-level conversations; you *cannot* create threads of threads (subthreads). When you add a thread for a private conversation, you can choose whether to make the thread available to all members of the conversation or those you specifically add to the thread. You do this by toggling the **Private** switch. You can also add new members to the thread, in which case a message appears stating that access will be granted to new individuals and/or groups. For example, in the following screenshot, access is granted to the original members of the conversation, along with the "Development.UI" group and user "Ben Green," both of which are not part of the original group with access. However, now that they have been added, they are considered members of the thread and will continue to receive notifications. buzz_new_channel_topic_2018.png For information about finding a thread in the Buzz menu, see [Buzz Layout](/s/article/360043429973 "Buzz Layout"). # Change the Privacy Status of a Thread You can switch private threads to public so that everyone included in the conversation has access. You *cannot* switch public threads back to private. Follow the steps below. 1. Select the thread title to open the thread in its own view in the conversation pane. 2. Select the ellipsis (...) to open the details view. 3. Select **Make Public**. # Delete a Thread You can delete a thread if you have an "Admin" security profile or a custom role with "Edit Conversations and Messages" enabled or you started the thread. Follow the steps below. 1. Select the thread title to open the thread in its own view in the conversation pane. 2. Select the ellipsis (...) to open the details view. 3. Select **Delete**. 4. Select **Delete** to confirm. # Quote a Message in a Reply When replying to a conversation, you can quote a message from earlier in the conversation. When you do this, the message is "quoted" in your reply so users understand the context. Follow the steps below. 1. Mouse over the message you want to quote. 2. Select **Reply**. Your cursor appears in the **New Message** field and the quoted message appears under the field to indicate that you are referencing it. # Create a Task Based on a Message You can create a task based on a message, specify it as a personal task or part of a Project, assign it to someone, and/or specify a due date and tags. For more information, see [Creating and Assigning Project Tasks](/s/article/360042925874 "Creating and Assigning Project Tasks"). ### Delete a Message When you delete a message from Buzz, it is replaced with the text: **This message has been deleted** so that viewers know a piece of the conversation is missing. You can delete a message only if you wrote it or you have an "Admin" default security profile or a custom role with "Edit Conversations and Messages" enabled. For more information about default security roles, see [Default Security Role Reference](/s/article/360043438953 "Default Security Role Reference"). For more information about custom roles, see Managing Roles. Follow these steps to delete a message from Buzz: 1. Hover over the message you want to delete. 2. Select **Delete**. ### Unfollow a Buzz Conversation **Note:** You cannot delete a Buzz conversation, but you can unfollow it. When you are part of a Domo conversation or are manually added as a recipient of such a conversation, you receive notifications for all future posts in the conversation by default. You can unfollow a Buzz conversation to stop receiving notifications. Follow these steps to unfollow a conversation: 1. In the Buzz panel, hover over the conversation you want to unfollow until the **Unfollow** option displays. unfollow.jpg 2. Select **Unfollow**. ### Add a Bot to a Conversation NLQ Bots are third-party connector integrations with Buzz. You can add NLQ Bots to any conversation in Buzz. You can then ask these Bots a question in Buzz using natural language and get an immediate response based on your DataSet data. Many NLQ Bots in Domo use webhooks, meaning you set up an integration with a third-party system. That system then pushes notifications to the Domo conversation where the Bot has been set up. Because all Bots are set up differently depending on the third-party connector, the instructions provided in this topic are general for all Bots. More specific instructions for each Bot are available when you add a Bot in Domo. # Add an NLQ Bot Follow these instructions to add a Bot to a Buzz conversation. **To add a Bot to Buzz,** 1. Open Buzz and find the conversation where you want the Bot to post. For more information about locating and opening conversations, see [Chatting in Buzz](https://domo-support.domo.com/s/article/360042925574 "Chatting in Buzz"). 2. Click the details icon ( ) next to the conversation name to open the Details pane. 3. Click **Bots** to expand the **Bots** section of the pane. 4. Click the "+" button. The **Add a Bot** dialog opens. 5. Locate the desired Bot in the dialog either by scrolling to it or entering the name in the search box. 6. Click the Bot. A dialog with options for configuring this Bot appears. 7. Follow the provided instructions for configuring the Bot. For more information about configuring NLQ for the Bot, see Understand NLQ. 8. Enter a name for the Bot. This is the name that is shown for the Bot in the conversation. 9. Click **Save**. The Bot is now set up, and you will receive Buzz notifications in this conversation depending on the third-party system and the triggers you have defined. # Delete a Bot You can remove a Bot from a Buzz conversation quickly and easily. **To remove a Bot from a Buzz conversation**, 1. Open Buzz and find the conversation where the Bot has been added. For more information about locating and opening conversations, see [Chatting in Buzz](https://domo-support.domo.com/s/article/360042925574 "Chatting in Buzz"). 2. Click the details icon ( ) next to the conversation name. The Details pane opens for the conversation. 3. Click **Bots** to expand the **Bots** section of the pane. 4. Mouse over the Bot you want to delete. 5. Select the trash can icon . 6. Select **Delete** to confirm. The Bot is now removed, and you will no longer receive notifications for this third-party system in this conversation. ### Understand NLQ For all Bots, you configure NLQ (Natural Language Query) by entering a command name in the **Command Name** field. For many Bots, this field does not appear until you configure the webhook for the Bot. You can enter any name in this field that you want, though it is recommended you choose something related to this connector that is short and easy to remember. Once you have configured the Bot and added a command name, you can invoke the Bot in Buzz by entering /\[commandname] then asking your question. For example, let's say you have Shopify data in Domo and you want to find out how many refunds you gave during the month of March. You would first configure the Bot as explained above, being sure to enter a command in the **Command Name** field. In this example, we'll just use the name "shopify." After successfully connecting to your Shopify store and adding the Bot, you would then write a Buzz message as follows: `/shopify how many refunds for March` Buzz would immediately respond with the answer to your question. Because NLQ Bots understand natural language, there is no required syntax for your questions. You could rephrase the above query using any of the following structures, and because the keywords ("refunds" and "march") are always present, the reply would be the same: `/shopify how many refunds did I give in March` `/shopify refunds for March` `/shopify March refunds` ### Configure Notifications You can configure notifications for a Buzz conversation in the Details pane for that conversation. You can configure notification settings for email, Domo Mobile, SMS, and/or pop-up notifications on your computer. For each of these you indicate whether notifications are sent when you are @ mentioned in the conversation, when any activity occurs in the conversation, or not at all. In the following example, the user has set computer pop-up notifications to **All activity** (meaning they receive pop-up notifications when ANY activity occurs in the conversation); Domo Mobile app and email to **Mentions** (meaning they receive notifications via Domo Mobile and email when they are @ mentioned in the conversation); and SMS to **None** (meaning they won't receive ANY notifications for this conversation via SMS). Screenshot 2024-04-16 at 5.38.41 PM.png Conversation notification settings are inherited from your global notification settings you set in the [Configuring Notifications for a Buzz Conversation](https://domo-support.domo.com/s/article/360042925734) screen. So, for example, if you indicated in that screen you did not want to receive any notifications via SMS, by default that setting would persist for this and all other Buzz conversations. But you could make an exception for a given conversation by changing the SMS setting just for that conversation. Follow these steps to configure notifications for a Buzz conversation: 1. Locate and open the Buzz conversation you want to configure notifications for. 2. Select the ellipsis icon (...) in the conversation pane to open the Details pane. 3. Select **Notifications** to expand that tab. 4. Select the radio buttons for the desired notification settings. ### Download Files When you open a file thumbnail in a Buzz conversation, the document preview mode opens. This preview mode provides an option **Download**. For more information about the document preview mode, see [Previewing a Document](https://domo-support.domo.com/s/article/360043430213 "Previewing a Document"). preview.png Follow these steps to preview and download a file in Buzz: 1. Select the link for the file in the conversation. The document preview mode opens. 2. In the preview, select **Download**. The file is downloaded to your computer. 3. To close the preview, select **X Close** in the top right corner. **Note:** To prevent users from uploading malicious files into Domo accounts, only a specific set of file types can be uploaded. If you attempt to upload a file not within this list, you receive an error message. For more information, see [Permitted File Types for Attachments](/s/article/360042925634). ### Import an Email Thread to Buzz You can import an existing email thread into a Buzz conversation, together with all collaborators and attachments for that thread. By transferring long, slow-moving email threads to Buzz, you can take advantage of the clear context visibility and speed to collaborate that Buzz provides. You import an email thread into Buzz by following these basic steps: 1. Generate a unique email address within Buzz just by clicking a button. 2. Copy the email address into your email conversation as a recipient. 3. Send the email. This pulls the conversation into Buzz as a new conversation, along with its context, collaborators, and attachments. All collaborators are notified by email that the conversation has been imported into Buzz; the email also provides a link allowing them to jump directly into the new conversation. Collaborators may also continue to participate in the conversation via email, and their messages will still appear in Buzz. ### FAQ There isn't a direct functionality in Buzz to set retention periods and auto-purge messages and threads over a specified amount of time. However, you can manage the conversations by making them disappear from your view. To adjust the settings, select your profile picture and select **Settings.** select settings.jpg In the **General** tab under **Buzz**, select the option for the duration after which conversations should be automatically removed from your Buzz menu. buzz in settings.jpg Yes, you can disable Buzz auto-opening when first logging into Domo. Contact your Domo account team or Domo Support to request that Buzz defaults to be closed. Yes, you can disable Buzz for your Domo instance. Contact your Domo account team or Domo Support to request that Buzz be disabled. ### Buzz Overview (video)