Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                
Permalink
Newer
Older
100644 177 lines (104 sloc) 9.54 KB
August 5, 2020 12:51
1
---
September 21, 2020 14:19
2
title: "Share chatbots with other users in Microsoft Teams"
3
description: "Work on Power Virtual Agents chatbots with other people in your team, and see who else has recently modified topics."
September 10, 2020 11:28
4
keywords: "Administration, share, multi-author, PVA, teams"
5
ms.date: 01/25/2022
February 15, 2022 10:02
6
August 5, 2020 12:51
7
ms.topic: article
8
author: iaanw
9
ms.author: iawilt
10
manager: shellyha
October 15, 2021 12:13
11
ms.reviewer: micchow
September 10, 2020 11:28
12
ms.custom: "multi-author, admin, ceX, teams"
January 10, 2023 12:26
13
ms.service: power-virtual-agents
August 5, 2020 12:51
14
ms.collection: virtual-agent
15
---
16
October 15, 2021 16:22
17
# Share your bot with other users in Microsoft Teams
August 5, 2020 12:51
18
September 10, 2020 11:28
19
Select the version of Power Virtual Agents you're using here:
August 5, 2020 12:51
20
September 10, 2020 11:28
21
> [!div class="op_single_selector"]
23
> - [Power Virtual Agents web app](../admin-share-bots.md)
24
> - [Power Virtual Agents app in Microsoft Teams](admin-share-bots-teams.md)
August 5, 2020 12:51
25
26
Share your bot with other users so they can chat with the bot or collaborate together to author it.
November 12, 2020 11:02
27
30
- [Learn more about what you can do with Power Virtual Agents](fundamentals-what-is-power-virtual-agents-teams.md).
31
- To manage who can chat with the bot in your organization, the bot's [end user authentication setting](configuration-end-user-authentication-teams.md) must be configured to **Only for Teams** or **Manual**, with **Azure Active Directory** or **Azure Active Directory V2** as the provider and **Require user sign-in** enabled.
October 11, 2021 23:51
32
33
## Share bots for users to chat with
35
A user can always chat with a bot if it was created in the same team. You can share bots with users outside of the team with the **Share** options available in Power Virtual Agents.
October 11, 2021 23:51
36
37
### Share bot with security groups
October 11, 2021 23:51
39
You can share your bot with security groups so their members can chat with the bot.
40
41
1. Select **Share** at the top of the bot's overview page.
October 11, 2021 23:51
42
43
:::image type="content" source="../media/admin-share-bots/sharing-bot-homepage-teams.PNG" alt-text="Sharing UI entry point in bot overview page.":::
October 11, 2021 23:51
44
45
1. Specify the security group name that you would like to share the bot with.
October 11, 2021 23:51
46
47
> [!NOTE]
48
> You can only share a bot with security groups. You cannot share with individual users directly.
49
>
50
> You can manage individual user access by adding or removing users from the security group.
51
>
52
> To make a security-enabled group, please refer to [Microsoft Graph documentation](/graph/api/resources/groups-overview#security-groups-and-mail-enabled-security-groups).
October 11, 2021 23:51
53
54
:::image type="content" source="../media/admin-share-bots/sharing-bot-specify-security-group-teams.PNG" alt-text="Specify security group in Sharing UI.":::
October 11, 2021 23:51
55
56
1. Review the security group's permissions.
October 11, 2021 23:51
57
58
:::image type="content" source="../media/admin-share-bots/sharing-review-sg-permission-teams.PNG" alt-text="Review security group permission in Sharing UI.":::
October 11, 2021 23:51
59
60
1. 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.
October 11, 2021 23:51
61
62
> [!NOTE]
63
> Only security groups with email enabled will receive an email invitation. You can directly **Copy link** and share it with users to install the bot in Microsoft Teams.
October 11, 2021 23:51
64
65
1. Select **Share** to share the bot with the security group.
October 11, 2021 23:51
66
67
### Share bot with everyone in the organization
October 14, 2021 21:21
69
You can share your bot to allow everyone in the same organization as the bot to chat with it.
October 11, 2021 23:51
70
71
1. Select **Share** at the top of the bot's overview page.
October 11, 2021 23:51
72
73
1. Select **Everyone in _your organization's name_**.
October 11, 2021 23:51
74
75
1. Select **User - can use the bot** option.
October 11, 2021 23:51
76
77
:::image type="content" source="../media/admin-share-bots/sharing-share-everyone-in-org-teams.PNG" alt-text="Set user permission for everyone in the organization in Sharing UI.":::
October 11, 2021 23:51
78
79
> [!NOTE]
80
> Power Virtual Agents will not send an email invitation to everyone in the organization. You can directly **Copy link** and share it with users to install the bot in Microsoft Teams.
October 11, 2021 23:51
81
82
1. Select **Share** to share the bot with everyone in the organization.
October 11, 2021 23:51
83
October 14, 2021 21:21
84
### Stop sharing the bot
October 11, 2021 23:51
86
You can stop sharing the bot with a security group or everyone in your organization.
87
88
### Stop sharing with a security group
89
90
1. Select **Share** at the top of the bot's overview page.
October 11, 2021 23:51
91
92
1. Select **X** next to the security groups that you want to stop sharing the bot with.
October 11, 2021 23:51
93
94
:::image type="content" source="../media/admin-share-bots/sharing-unshare-sg-teams.PNG" alt-text="Unshare security group in Sharing UI.":::
October 11, 2021 23:51
95
96
1. Select **Share** to stop sharing the bot with the security groups.
October 11, 2021 23:51
97
98
### Stop sharing with everyone in the organization
October 11, 2021 23:51
99
100
1. Select **Share** on the bot's overview page.
October 11, 2021 23:51
101
102
1. Select **Everyone in _your organization's name_**.
October 11, 2021 23:51
103
104
1. Select **None** option.
October 11, 2021 23:51
105
106
:::image type="content" source="../media/admin-share-bots/sharing-unshare-everyone-in-org-teams.PNG" alt-text="Unshare everyone in the organization in Sharing UI.":::
October 11, 2021 23:51
107
108
1. Select **Share** to stop sharing the bot with everyone in the organization.
October 11, 2021 23:51
109
110
## Share bots to collaborate with others
September 10, 2020 07:57
111
112
You can collaborate with others when building chatbots in Microsoft Teams. This means other members of your team can make edits and changes, and you can see who else is editing a topic.
113
114
Your permissions are determined by your [Microsoft Teams roles](/microsoftteams/assign-roles-permissions) in the team where your bot is created:
September 21, 2020 09:44
115
116
- Team Owners can create, view, edit, and configure all bots in the team where they are Team Owners.
September 21, 2020 11:49
117
- Team Members can create, edit, and configure bots they have created. They can view other member's bots in the team.
September 10, 2020 11:28
118
119
> [!NOTE]
120
> If you are an owner of an Azure Active Directory group associated with a team, but you are not also a member of that group, you might not see the team in the Power Apps and Power Virtual Agents apps in Microsoft Teams.
121
>
122
> You can add yourself as a member to the team and it will resolve the issue after a few minutes.
September 10, 2020 11:28
123
October 11, 2021 23:51
124
To share your bot with other users for collaboration, you need to [add them to your team](https://support.microsoft.com/office/add-members-to-a-team-in-teams-aff2249d-b456-4bc3-81e7-52327b6b38e9).
125
126
> [!NOTE]
127
> It could take up to 15 minutes before the new team member sees the team in the Power Virtual Agents app.
128
129
You can see a list of the teams you belong to, and each bot within that team by going to the **Chatbots** tab on the top bar. Teams are listed on the left, selecting a team shows the chatbots in that team. Where ever you are in the app, you can always get back to the list of chatbots by selecting **Chatbots** at the top.
September 21, 2020 10:04
130
131
> [!TIP]
132
> **My chatbots** shows all the bots you created and is an easy way for you to find your bot across multiple teams. You can find bots created by other team members by selecting the team.
133
134
:::image type="content" source="../media/admin-share-bots/admin-share-bots-list.png" alt-text="The teams and chatbots are listed in the Chatbots tab.":::
135
136
You can open bots for editing by selecting the bot's name.
137
138
If you select the check mark next to the bot's name, you can go straight to the Topics or Analytics page for that bot. You can also select **Edit** to go to the bot's overview page.
139
140
:::image type="content" source="../media/admin-share-bots/admin-share-bots-edit.png" alt-text="The Topics and Analytics buttons appear when a bot is selected.":::
141
142
If you select the menu icon next the bot's name you can then select **Edit** to go to the bot's overview page, or go to the Topics or Analytics pages.
143
144
:::image type="content" source="../media/admin-share-bots/admin-share-bots-hamburger.png" alt-text="The bot's menu lets you edit details, topics, and see analytics":::
145
September 21, 2020 11:49
146
If you rename, restore, or delete a team, it could take up to 2 hours for the changes to be reflected in the Power Virtual Agents app.
September 10, 2020 07:57
147
October 11, 2021 23:51
148
## Data permissions
October 14, 2021 21:21
150
To make sure users who chat with your bot can run the [Power Automate](advanced-flow-teams.md) flows correctly, you should test your bot to make sure their permissions with the integrated systems are configured correctly.
October 11, 2021 23:51
151
August 5, 2020 12:51
152
## Collaborate on bots
153
154
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.
August 5, 2020 12:51
155
156
This can help prevent conflicts if multiple people are working on the same topic.
157
158
:::image type="content" source="../media/admin-share-bots/sharing-multi-authors-teams.png" alt-text="Screenshot showing the Power Virtual Agents list of topics with the Currently editing column highlighted.":::
August 5, 2020 12:51
159
160
> [!NOTE]
161
> The list of authors in the **Currently editing** column is only refreshed when the page is loaded.
August 5, 2020 12:51
162
163
A list of who's editing the page appears as user icons on the top of the authoring canvas when you've opened a topic for editing.
August 5, 2020 12:51
164
165
:::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.":::
August 5, 2020 12:51
166
September 15, 2020 15:38
167
After 30 minutes of inactivity you will not be identified as editing the topic.
August 5, 2020 12:51
168
September 15, 2020 15:38
169
Occasionally, multiple people might make changes to a topic and attempt to save their changes at the same time.
August 5, 2020 12:51
170
171
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).
August 5, 2020 12:51
172
173
:::image type="content" source="../media/admin-share-bots/sharing-multi-conflict-teams.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":::
August 5, 2020 12:51
174
175
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.
February 17, 2021 12:07
176
October 11, 2021 23:51
177
[!INCLUDE[footer-include](../includes/footer-banner.md)]