Microsoft Teams Integration Guide

Last updated on 

This guide will cover how to send real-time notifications to your Teams channels directly from a flow in Cue.

Overview

In this guide you will find the following sections:

Requirements for Integration

You'll need the following in order to set up this integration:

  • a Teams account with permission to edit Teams channel
  • access to Flows in your Cue workspace (e.g. the Admin role)

Create a Teams Workflow

First, you'll need to create a new workflow in Teams that:

  1. is triggered by a webhook
  2. will post a message to a Teams channel

You can read the official Teams guide for setting up webhooks here.

  1. Click on the channel More options and select Workflows
  2. Search for webhooks and select Send webhook alerts to channel
  3. Give it a name like Cue Notifications and click Next
  4. Ensure you have selected the correct Team and Channel and click next
  5. You will be given a webhook URL to use in the notifications.

Once you've created the Teams workflow you can grab the Web request URL that can be called to trigger the workflow, for example:

https://company.webhook.office.com/webhookb2/48634fa1-b59d-495e-95c6-b562ada06720@111bfc7f-a925-48b6-9802-4c6754c35b6f/IncomingWebhook/61b4196ffde246b887b87d72024f19c3/8320d57d-1b20-8954-9d18-111105d1ae8b/V2i3VxYnQ8R1Zi_s1F83xT5NHztVwynbhInTStnAXXft41

You can then make an HTTP request from a Cue flow with data to trigger this Teams workflow.

Create a Cue Flow to trigger the Teams Workflow

Next, we'll setup a simple Cue chatbot flow where someone on WhatsApp can "Request a call" and a notification gets pushed through to Teams as a channel message.

  1. Request a callback step
  2. HTTP Request step
  3. Thank you message step

Add an HTTP step to call the Teams workflow

When adding your HTTP Step to the flow paste in the new Web request URL you copied from your Teams workflow and set the JSON body of the request to match the variables you set up in the Teams workflow. These requests to Teams don't require authentication.

Make sure the JSON body you are creating in this request step matches the same shape that your Teams Workflow expects. In this case, your JSON body should include a text property with the respective message.

When typing in the JSON body field you can type { to open the autocomplete for dynamic properties that can be included during the conversation. In this case profile is the user's WhatsApp profile name (what you see when you receive a push notification from them) and the contactIdentifier which is the phone number for the person interacting on this WhatsApp channel.

Test your Teams notification

Once you have set up and published your flow you can message your channel to interact with that chatbot flow and see that your Teams notification works.

Need Help?
Need a hand setting it up? Reach out to us at support@cuedesk.com and we can help you get set up.