Skip to content

Commit cc6fa0d

Browse files
committed
Add Teams instructions
1 parent 2f916f2 commit cc6fa0d

File tree

7 files changed

+97
-13
lines changed

7 files changed

+97
-13
lines changed
Loading
Loading
Loading
Loading
Loading

powerapps-docs/maker/canvas-apps/sample-coronavirus-app.md

Lines changed: 97 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -211,6 +211,41 @@ connect it to your new data sources.
211211

212212
1. **Save** and **Publish** the app.
213213

214+
### Update the request help Flow
215+
This flow will send an adaptive card to a central Teams team requesting help.
216+
217+
![Import app package](media/sample-crisis-communication-app/media/21-Request-Help.png)
218+
219+
220+
Before completing these step, first create a Teams team for your crisis management team. Once you do, you can get the ID for it
221+
and bring it into your flow. If you need help creating a Teams team, jump to [Create a central crisis management Teams team]() NEEDS A LINK
222+
223+
1. Navigate to the Teams channel that you want to post all of your help requests to
224+
1. Select the **...** menu for the channel.
225+
1. Select **Get link to channel**
226+
227+
![Get link to channel](media/sample-crisis-communication-app/17-Get-link-to-channel.png)
228+
229+
1. Copy link and paste it in a text editor
230+
231+
![Copy link](media/sample-crisis-communication-app/18-Copy-link.png)
232+
233+
1. Extract the Team ID, which is everything after `groupId=` and before `&tenantId=`. For example,
234+
for this URL, `https://teams.microsoft.com/l/channel/19%3ab2fa9fc20f3042a9b63fc5890e1813f8%40thread.tacv2/General?groupId=8bc7c0c2-0d4c-4fb8-af99-32da74c9237b&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47`,
235+
the channel ID would be `8bc7c0c2-0d4c-4fb8-af99-32da74c9237b`.
236+
1. Extract the channel ID, which is everything after `https://teams.microsoft.com/l/channel/` and before `/General`. For example,
237+
for this URL, `https://teams.microsoft.com/l/channel/19%3ab2fa9fc20f3042a9b63fc5890e1813f8%40thread.tacv2/General?groupId=8bc7c0c2-0d4c-4fb8-af99-32da74c9237b&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47`,
238+
the channel ID would be `19%3ab2fa9fc20f3042a9b63fc5890e1813f8%40thread.tacv2`.
239+
1. Navigate to [flow.microsoft.com](https://flow.microsoft.com)
240+
1. Select **My flows** from the left navigation.
241+
1. Select **...** for **CrisisCommunication.RequestHelp** and select **Edit**.
242+
![Edit app](media/sample-crisis-communication-app/20-Edit-Flow.png)
243+
1. Open the **Team Id** card.
244+
1. Paste the Team ID into the **Value** field.
245+
1. Open the **Channel ID** card.
246+
1. Paste the Channel ID into the **Value** field.
247+
![Set Team IDs](media/sample-crisis-communication-app/22-Set-Team-IDs.png)
248+
214249
## Import and setup the admin app
215250
To manage the app you just imported, you'll want to repeat the same steps for the admin app.
216251

@@ -289,7 +324,6 @@ Complete all of the fields and select **Save** once you are done.
289324
| Admin email | AdminContactEmail | Used to notify others who is administering the application. |
290325
| Logo URL | Logo | The logo of your app which will appear in the top left corner. |
291326
| AAD group ID | AADGroupID | Used to send notifications to end-users about internal company updates via the *Notify users on new crisis communication news* flow. |
292-
| Teams channel ID | TeamsChannelID | Used to push help requests to the central response teams' Team channel. |
293327
| APP URL | AppURL | The ___location of the app so that the *Notify users on new crisis communication news* flow can redirect users after selecting **Read more**. |
294328
| Government RSS Feed | GovernmentRSSFeed | Used to populate the world news feature within the app. Useful if you want to provide additional information to your employees from a trusted source. |
295329
| Notification method | PreferredSentNotification | Used by the *Notify users on new crisis communication news* flow to determine which distribution channel it should use when sending out notifications. |
@@ -306,16 +340,6 @@ Complete all of the fields and select **Save** once you are done.
306340

307341
1. Paste the ID into the **AAD group ID** field within the admin application.
308342

309-
#### Finding the Teams channel ID of your response Team
310-
1. Navigate to the Teams channel that you want to post all of your help requests to
311-
1. Select the **...** menu for the channel.
312-
1. Select **Get link to channel**
313-
1. Copy link and paste it in a text editor
314-
1. Extract the channel ID, which is everything after `https://teams.microsoft.com/l/channel/` and before `/General`. For example,
315-
for this URL, `https://teams.microsoft.com/l/channel/19%3ab2fa9fc20f3042a9b63fc5890e1813f8%40thread.tacv2/General?groupId=8bc7c0c2-0d4c-4fb8-af99-32da74c9237b&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47`,
316-
the channel ID would be `19%3ab2fa9fc20f3042a9b63fc5890e1813f8%40thread.tacv2`.
317-
1. Copy and paste this ID into the **Teams channel ID** field within the admin application.
318-
319343
### Setup emergency contacts
320344
1. Navigate to **Company Contacts**
321345
1. Select **Create new contact**
@@ -388,13 +412,15 @@ Complete all of the fields and select **Save** once you are done.
388412
| Answer | Answer | The answer to the FAQ |
389413
| Deprecated | Deprecated | Allows you to hide an FAQ. |
390414

391-
## Test the Crisis Communication app
415+
## Test and share the app
392416
Now that you've successfully setup all of the data, you can now test the app to make sure it works:
393417

394418
1. Sign in to [Power Apps](https://make.powerapps.com).
395419
2. Select **Apps** from the left navigation.
396420
3. Select **Crisis Communication** to play the app. 
397421

422+
Once you've successfully tested the app, you can share the app with everyone in your company.
423+
398424
## Import and setup the notification flow
399425

400426
The app uses a flow to send notifications to end users whenever there is a new company update.
@@ -474,7 +500,65 @@ The app uses a flow to send notifications to end users whenever there is a new c
474500
> You may receive an error if one of your connections has not been authorized yet.
475501
If this happens, please open the card with the unauthorized connection and reauthorize.
476502

477-
### Edit the news notification flow
503+
### Test the news notification flow
478504
To test the news notification flow, go back to the admin app and create a new internal company update.
479505
Afterwards, all of the users within your distribution list will receive an update by your preferred notification
480506
preference.
507+
508+
> [!NOTE]
509+
> If you run into errors, make sure that you have successfully entered in your distribution group's ID in the admin
510+
settings within the admin app.
511+
512+
## Integrate your app into Teams
513+
Now that you have a functioning app that has been shared with everyone, you can deploy the app using Teams and create
514+
a crisis management team within Microsoft Teams to respond to issues.
515+
516+
### Deploy the app to the app bar
517+
If you are a Teams admin, you can push the app to all of your users within the Teams app bar.
518+
519+
![App in Teams](media/sample-crisis-communication-app/19-App-in-Teams.png)
520+
521+
1. Sign in to [Power Apps](https://make.powerapps.com).
522+
1. Select **Apps** from the left navigation.
523+
1. Select the **...** menu for the **Crisis Communication** app.
524+
1. Select **Add to Teams**
525+
1. Select **Download app**
526+
1. Open **Teams**
527+
1. Navigate to **Apps** from the left app bar.
528+
1. Select **Upload a custom app**.
529+
1. If you are a Teams admin, you will see the ability to upload an app for your entire tenant. Select **Upload for Contoso**.
530+
1. Upload the file that you downloaded from Power Apps.
531+
1. Navigate to the [Teams admin center](https://admin.teams.microsoft.com/dashboard)
532+
1. Select **Setup Policies** under **Teams apps** in the left navigation.
533+
1. Select **Global (Org-wide setup)**
534+
1. Select **Add apps**
535+
1. Search for and select the **Crisis Information** app you uploaded.
536+
1. Select **Add*.
537+
1. Select **Save**.
538+
539+
> [!NOTE]
540+
> It may take up to 24 hours for users to see the app automatically pinned in their app bar.
541+
542+
### Create a central crisis management Teams team
543+
To coordinate your crisis response, you'll want to create a central Teams team for your crisis management team
544+
and populate it with all of the relevant information.
545+
546+
1. Navigate to Teams
547+
1. Select **Teams** from the left app bar
548+
1. Select **Join or create a Team**
549+
1. Select **Create team** and complete the remaining steps
550+
551+
Once you've successfully created your team, you can pin relevant information as tabs. For example,
552+
you may want to pin the crisis management admin app or the Power BI report to your team. To add the admin app as a tab:
553+
554+
1. Select the **+** button
555+
1. Search for and select **Power Apps**
556+
1. Search for and select **Crisis Information Admin**
557+
1. Select **Save**
558+
559+
To add the Power BI report:
560+
1. Select the **+** button.
561+
1. Search for and select **Power BI**
562+
1. Search for and select your Power BI report
563+
1. Select **Save**
564+

0 commit comments

Comments
 (0)