Home›Integrations›Promoting to Microsoft Teams

Promoting to Microsoft Teams

Let Block Editor content authors promote pages to a Microsoft Teams channel using an incoming webhook workflow.

The Block Editor lets content authors promote content across many channels in your business, including Microsoft Teams. This guide explains how to configure Interact to promote to your Teams workspace.

Before you start

You need:

  • A Power User account in Interact with access to Control Panel > Block Editor.
  • A Microsoft Teams account with permission to create workflows in the target channel.

Note: Posting to private channels is not currently supported by Workflows.

Step 1: Set up an incoming webhook workflow

  1. Select More options next to the channel or chat you want to create a workflow for, then select Workflows.

Workflows option on a channel

  1. Choose Send webhook alerts to a channel.

Selecting the webhook workflow template

Note: The webhook template "Post to a chat when a webhook request is received" may not be available depending on your organisation type. For more help, contact your IT admin.

  1. Once the workflow opens, you can change its name.
  2. Authenticate with your account so your workflows can post to the channel or chat. To choose a different account, select Switch account and choose the account you want to use.
  3. Once you have updated the name and authenticated the correct account, select Next.

Naming and authenticating the workflow

  1. On the next page, choose the channel this notification will post to. If you are using this workflow from a channel, these fields auto-populate. After filling out the required details, select Add workflow.

Choosing the target channel

  1. Once the workflow is created, a new dialog shows the URL that you can copy.

Workflow URL dialog

  1. To copy the workflow URL again later, open the Workflows app within Teams, select the workflow that was created, select Edit, and expand the trigger When a Teams webhook request is received.

The webhook is now available in the Teams channel. For more on Power Automate workflows, see Use Power Automate flows in Microsoft Teams.

Step 2: Configure a promotion channel

  1. Go to Control Panel > Block Editor > Promotion Channels > Add New Channel.
  2. Specify the Name and Type. The Name is what your content authors see when selecting which platform to promote to. Set the Type to Microsoft Teams.
  3. Mark it as active.
  4. In the credentials section, replace [Url] with the URL from the Teams workflow or connector.
  5. In the configuration section, replace [Provider] with incoming-webhook.
  6. Select Save.

Teams promotion channel configuration

You can now promote a page to a public or private Teams channel.

Promote dialog showing Teams

Promoted page in Teams

Section: Integrations