Skip to content

Commit

Permalink
Add support link for playbooks-for-microsoft-teams.rst (#7382)
Browse files Browse the repository at this point in the history
* Update playbooks-for-microsoft-teams.rst

* Update playbooks-for-microsoft-teams.rst

---------

Co-authored-by: Jesse Hallam <[email protected]>
  • Loading branch information
esethna and lieut-data authored Sep 9, 2024
1 parent 46a3794 commit 2c7ab12
Showing 1 changed file with 16 additions and 11 deletions.
27 changes: 16 additions & 11 deletions source/integrate/playbooks-for-microsoft-teams.rst
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
Mattermost Playbooks for Teams
==============================
Mattermost Playbooks for Microsoft Teams
========================================

.. include:: ../_static/badges/ent-cloud-selfhosted.rst
:start-after: :nosearch:

Mattermost Playbooks for Teams improves cross-organizational alignment and awareness by enabling access to your :doc:`active, repeatable processes </guides/repeatable-processes>` and :ref:`status updates <repeatable-processes/notifications-and-updates:status updates>` in Mattermost directly in Microsoft Teams.

Stakeholders working in Microsoft Teams now gain enhanced visibility into ongoing incidents, while incident responders working in Mattermost can stay focused on incident response and eliminate context switching.
Stakeholders working in Teams now gain enhanced visibility into ongoing incidents, while incident responders working in Mattermost can stay focused on incident response and eliminate context switching.

With the Mattermost Playbooks for Teams integration, you can:

Expand All @@ -28,24 +28,24 @@ Update and configure the Playbooks integration for Mattermost

A Mattermost system admin must complete the following steps:

1. Go to the **System Console > Plugin Management** page to upload the `latest preview build of Mattermost Playbooks <https://github.com/mattermost/mattermost-plugin-playbooks/releases/tag/v2.0.1%2Btabapp>`_ with support for the Microsoft Teams app integration.
1. Go to the **System Console > Plugin Management** page to upload the `latest preview build of Mattermost Playbooks <https://github.com/mattermost/mattermost-plugin-playbooks/releases/tag/v2.0.1%2Btabapp>`_ with support for the Teams app integration.

2. Once uploaded, select **Settings** under the Playbooks plugin to **Enable Teams Tab App**, and enter your Microsoft Teams tenant ID in the **Authorised Tenant IDs for Teams Tab App** field.
2. Once uploaded, select **Settings** under the Playbooks plugin to **Enable Teams Tab App**, and enter your Teams tenant ID in the **Authorised Tenant IDs for Teams Tab App** field.

Install the Mattermost Playbooks for Teams application
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Any Microsoft Teams user in the associated tenant that was configured for the Playbooks integration must complete the steps below to access playbooks and runs within Microsoft Teams.
Any Teams user in the associated tenant that was configured for the Playbooks integration must complete the steps below to access playbooks and runs within Teams.

1. Sign in to your Microsoft Teams account from a `browser <https://teams.microsoft.com/>`_ or the desktop application.

2. Select the **[+] Apps** button in the Microsoft Teams sidebar.
2. Select the **[+] Apps** button in the Teams sidebar.

3. Search for "Mattermost Playbooks for Teams" and then select **Add** to install the application.
3. Search for "Mattermost Playbooks" and then select **Add** to install the application.

4. (Optional) Pin the application to your Teams sidebar by right-clicking on it and selecting **Pin**.

5. Once the Mattermost Playbooks for Teams app is installed, enter the URL for your Mattermost Enterprise self-managed or cloud server.
5. Once the Mattermost Playbooks app is installed, enter the URL for your Mattermost Enterprise self-managed or cloud server.

Choose which Mattermost playbook runs are accessible to Microsoft Teams users
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Expand All @@ -69,11 +69,16 @@ Playbooks and runs that include the **@msteams** bot as a participant are visibl
Setup complete
~~~~~~~~~~~~~~

Setup is now complete. In Microsoft Teams, you should now see a list of all active runs where the **@msteams** is a participant. You can select any active run to see recent status updates in chronological order.
Setup is now complete. In Teams, you should now see a list of all active runs where the **@msteams** is a participant. You can select any active run to see recent status updates in chronological order.

FAQ
-----

Where can I get support for the Mattermost Playbooks for Teams app?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
You can browse existing open issues or submit a new issue for support `here <https://github.com/mattermost/mattermost-teams-tab/issues>`_.


Do I need a Mattermost instance to use this application?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Expand All @@ -82,4 +87,4 @@ Yes, you must have an active Mattermost Enterprise self-managed or cloud deploym
Why don't I see any runs after entering my Mattermost server URL?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Please ensure you've added the **@msteams** bot to any runs you want to be accessible within Microsoft Teams. You can automate this step for future runs of a Playbook by inviting the **@msteams** bot as a participant in the **Actions** section of any Playbook configuration.
Please ensure you've added the **@msteams** bot to any runs you want to be accessible within Microsoft Teams. You can automate this step for future runs of a Playbook by inviting the **@msteams** bot as a participant in the **Actions** section of any Playbook configuration.

0 comments on commit 2c7ab12

Please sign in to comment.