admin-share-bots.md

title	description	keywords	ms.date	ms.topic	author	ms.author	manager	ms.reviewer	ms.custom	ms.service	ms.collection
Share and collaborate on chatbots with other users (contains video)	Share Power Virtual Agents chatbots with other users, assign security roles, and work together.	Administration, share, multi-author, PVA	01/25/2022	article	iaanw	iawilt	shellyha	micchow	multi-author, admin, ceX	power-virtual-agents	virtual-agent

Share your bot with other users

Select the version of Power Virtual Agents you're using here:

[!div class="op_single_selector"]

• Power Virtual Agents web app
• Power Virtual Agents app in Microsoft Teams

You can share your bots with others to grant them special permissions. There are two different sharing methods:

1. Grant security groups, or your whole organization, permission to chat with the bot.
2. Invite users to collaborate on your bot project. Collaborators always have permission to chat with the bot.

Prerequisites

• Learn more about what you can do with Power Virtual Agents.
• The bot's end user authentication setting must be configured to Only for Teams or Manual, with Azure Active Directory or Azure Active Directory V2 as the provider. Required user sign-in must be enabled to manage who can chat with the bot in your organization.

Share a bot for chat

Bot makers that you've shared your bot with for collaborative authoring will always have permission to chat with the bot. However, you can also grant users permission to chat with the bot without granting them authoring permissions.

To grant users permission to only chat with the bot, you can either:

• Share your bot with a security group.
• Share your bot with everyone in your organization.

Share bot with security groups

You can share your bot with security groups so their members can chat with the bot.

1. Select Share at the top of the bot's overview page.

   :::image type="content" source="media/admin-share-bots/sharing-home.png" alt-text="Sharing UI entry point in bot homepage." border="false":::

2. Specify the security group name that you would like to share the bot with.

   [!NOTE] When sharing a bot for chat, you can only share a bot with security groups. You can't share it with:

   • Microsoft 365 groups.
   • Individual users directly. To manage individual user access, add or remove users from the security group.

   :::image type="content" source="media/admin-share-bots/sharing-bot-specify-security-group.PNG" alt-text="Specify security group in Sharing UI":::

3. Review the security group's permission

   :::image type="content" source="media/admin-share-bots/sharing-review-sg-permission.PNG" alt-text="Review security group permission in Sharing UI.":::

4. If you want to let users know you've shared the bot with them, select the Send an email invitation to new users check box.

   [!NOTE] Only security groups with email enabled will receive an email invitation. You can copy the link for the Demo website and share it with users directly so they can chat with the bot.

5. Select Share to share the bot with the new security groups.

Share bot with everyone in the organization

You can share your bot to allow everyone in the same organization the bot to chat with it.

1. Select Share at the top of the bot's overview page.

2. Select Everyone in your organization's name.

3. Select User - can use the bot option.

   :::image type="content" source="media/admin-share-bots/sharing-share-everyone-in-org.PNG" alt-text="Set user permission for everyone in the organization in Sharing UI.":::

   [!NOTE] Power Virtual Agents will not send email invitations to everyone in the organization. You can copy the link for the Demo website and share it with users directly so they can chat with the bot.

4. Select Share to share the bot with everyone in the organization.

Stop sharing bot

You can stop sharing the bot with a security group or everyone in your organization.

Stop sharing with a security group

1. Select Share at the top of the bot's overview page.

2. Select X next to the security groups that you want to stop sharing the bot with.

   :::image type="content" source="media/admin-share-bots/sharing-unshare-sg.PNG" alt-text="Unshare security group in Sharing UI":::

3. Select Share to stop sharing the bot with the security groups.

Stop sharing with everyone in the organization

1. Select Share on the bot's overview page.

2. Select Everyone in your organization's name.

3. Select None option.

   :::image type="content" source="media/admin-share-bots/sharing-unshare-everyone-in-org.PNG" alt-text="Unshare everyone in the organization in Sharing UI":::

4. Select Share to stop sharing the bot with everyone in the organization.

5. Select Share to stop sharing the bot with everyone in the organization.

Share a bot for collaborative authoring

Individual users that you share a bot with can view, edit, configure, share, and publish the bot. They can't delete the bot.

[!VIDEO https://www.microsoft.com/videoplayer/embed/RE4DdcM]

[!NOTE] You can only share a bot with users who have a Power Virtual Agents per user license. Users who don't have a license can sign up for a free trial.

1. To share a bot, sign in to Power Virtual Agents and select Share at the top of the bot's overview page.

   :::image type="content" source="media/admin-share-bots/sharing-home.png" alt-text="Power Virtual Agents bot overview page with the Share button highlighted." border="false":::

2. Specify the name or email address of each user that you would like to share the bot with.

   [!NOTE] When sharing a bot for collaborative authoring, you can only share it with individual users. You can't share it with:

   • A security group in your organization.
   • Distribution group in your organization.
   • Users or groups outside of your organization.

   :::image type="content" source="media/admin-share-bots/sharing-input-invitee.png" alt-text="Screenshot showing name input in the share window." border="false":::

3. Review the user's permissions.

   :::image type="content" source="media/admin-share-bots/sharing-view-permission.png" alt-text="Screenshot showing share window with user permissions." border="false":::

4. If you want to let users know you've shared the bot with them, select the Send an email invitation to new users check box.

5. Select Share to share the bot with the new users.

[!IMPORTANT] It can take up to 10 minutes for the bot to show up in the shared user's bot list if the user was not previously part of the environment of the shared bot.

Insufficient environment permissions

Users in the environment must have the Environment maker security role before a bot can be shared with them.

:::image type="content" source="media/admin-share-bots/sharing-insufficient-permission.png" alt-text="User does not have sufficient permissions." border="false":::

System administrators of the environment need to assign the Environment maker security role to the user before you share the bot. If you're a System administrator, you can assign the Environment maker role when you share the bot.

Learn more about security roles and predefined security roles.

Share Power Automate flows used in a bot

You can add actions to a bot using flows in Power Automate; however flows in a bot aren't automatically shared with other users when sharing a bot.

Users who don't have access to the shared flow can still run it by using the test bot canvas.

To let other users edit or add flows you'll need to share them in Power Automate. You can open flows directly from the topic where the flow is used.

1. Select View flow details to go to the flow's details page in Power Automate.

   :::image type="content" source="media/admin-share-bots/sharing-view-flow-details.png" alt-text="Highlight of the view flow details on a flow in a topic." border="false":::

2. Select Edit in the Owners section.

   :::image type="content" source="media/admin-share-bots/sharing-flow-owners.png" alt-text="Select the Edit link." border="false":::

3. Enter the name or email address of the user you want to give editing permissions to.

Stop sharing a bot

You can stop sharing a bot with a user, and any shared user can stop the bot from being shared with other users, except for the owner. The owner will always have access to the bot.

1. Sign in to Power Virtual Agents and select Share at the top of the bot's overview page.

2. Select X next to the users that you want to stop sharing the bot with.

   :::image type="content" source="media/admin-share-bots/sharing-remove-user.png" alt-text="Remove bot access 'X'." border="false":::

3. Select Share to stop sharing the bot with the user.

Assign environment security roles

If you're a System administrator, you can assign and manage environment security roles when sharing a bot.

The Environment security roles section shows when you share a bot and only if you're a System administrator. It lets you share bots with users who don't have sufficient environment permissions to use Power Virtual Agents.

You must be a System administrator of the environment where the bot is located to view and add security roles.

[!NOTE] You can only assign security roles when sharing a bot. You can't remove security roles when sharing. For full security role management, use the Power Platform admin center.

Learn more about security roles and predefined security roles.

Assign the Environment maker security role during bot sharing

You can assign the Environment maker security role when sharing a bot with a user who does not have sufficient environment permissions to run Power Virtual Agents.

When sharing the bot for chat, if the specified user does not have sufficient permissions to use Power Virtual Agents in the environment, you'll be notified that the Environment maker security role will be assigned to the user so they can use the bot.

:::image type="content" source="media/admin-share-bots/sharing-input-invitee-no-permission.png" alt-text="Share panel with permission notice bubble." border="false":::

Assign the Bot transcript viewer security role during bot sharing

You can assign the Bot transcript viewer security role to users who don't have conversation transcript access when sharing a bot.

Based on the content and target audience of the bot, you may want to give transcript access only to users who have appropriate privacy training.

[!IMPORTANT] Conversation transcript access is managed by environment security roles. After assigning the Bot transcript viewer security role to a user, that user can access conversation transcripts for all bots that they create or are shared with in the environment.

In the default environment, every user has the Bot transcript viewer role assigned by default. We recommend you create an environment for bots that controls which user can view conversation transcripts. Learn more about how to Create a new environment for your bots

When sharing the bot for chat, you can assign the Bot transcript viewer role by selecting the check box.

:::image type="content" source="media/admin-share-bots/sharing-assign-transcript-viewer.png" alt-text="Share panel with Bot transcript viewer role selected." border="false":::

Manage security roles

You can manage environment security roles at the Power Platform admin center.

Data permissions

To make sure users who chat with your bot can run Power Automate flows correctly, you should test your bot to make sure their permissions with the integrated systems are configured correctly.

Collaborate on bots

After you've shared a bot, everyone can edit the bot's topics.

In the Topics list, you can see who's working on a topic under the Editing column. You can select the person's icon to quickly chat with them in Teams or send them an email.

This can help prevent conflicts if multiple people are working on the same topic.

:::image type="content" source="media/admin-share-bots/sharing-multi-authors.png" alt-text="Screenshot showing the Power Virtual Agents list of topics with the Currently editing column highlighted.":::

[!NOTE] The list of authors in the Currently editing column is only refreshed when the page is loaded.

A list of who's editing the page also appears as user icons on the top of the authoring canvas when you've opened a topic for editing.

:::image type="content" source="media/admin-share-bots/sharing-multi-editing.png" alt-text="Screenshot of a topic being edited with user profile pictures appearing on the top menu bar.":::

If an author does not make any changes to the topic, or disconnects their computer or closes the browser window, they are considered to have abandoned the topic. After 30 minutes of inactivity the user will not be identified as editing the topic.

Occasionally, multiple people might make changes to a topic and attempt to save their changes concurrently. For example, you might open and start editing a topic. Your coworker opens the same topic, makes a small change, and saves it. Then, when you've finished editing the topic, you go to save it, only to find yourself in a conflict state.

Power Virtual Agents will detect this and prevent you from overwriting your coworker by prompting you with an option - you can reload the content with the latest changes (discarding your work), or you can save a copy of the topic (keeping your changes in a new, duplicate copy of the topic).

:::image type="content" source="media/admin-share-bots/sharing-multi-conflict.png" alt-text="Screenshot showing a prompt that says Updated content available and gives you options to discard your changes or save a copy." border="false":::

If you save your changes to a new topic, you can then review your coworker's changes and merge the two topics, deleting the copy of the topic once you've finished.

[!INCLUDEfooter-include]