Courier Netlify Microsoft Teams Bot

Netlify Status

This is an Microsoft Teams Bot that can be deployed to a Netlify Function. It contains commands for adding Courier recipient profiles for Microsoft Teams channels and users. This was created as a quick way to get started sending Microsoft Teams notifications using Courier.

Installation Options

First, sign up for a Courier Developer Account, it’s free to sign up and includes 10,000 notifications per month. Next, create a Microsoft Teams application using App Studio inside your Team. Then, choose an option below.

This starter focuses on building profiles using commands. Each command requires a recipient id and will update that profile stored in Courier. You can extend this bot to better fit your use case.

Option one: One-click deploy

Deploy to Netlify

Clicking this button will create a new repo for you that looks like this one, and sets that repo up immediately for deployment on Netlify. You will be prompted for a repo name and to provide the values for the following environment variables to use with Courier and the Microsoft Teams Bot.

  • Courier Auth Token (COURIER_AUTH_TOKEN), required - You can find this value in your Courier API Keys Settings.
  • MS Teams App ID (MSTEAMS_APP_ID), required - App ID generated in App Studio.
  • MS Teams App Password (MSTEAMS_APP_PASSWORD), required - App Password generated from the Bot Capabilities section of App Studio.

Option two: Manual clone

You will need to install the Netlify CLI and connect it to your Netlify site to run locally. You will need to use ngrok to test it locally.

  1. Clone this repo: git clone https://github.com/trycourier/courier-netlify-msteams.git
  2. Connect to Netlify using ntl init
  3. Add the above environment variables using ntl env:set [env var] [value]
  4. Run the app locally using ntl dev
  5. Make any changes and push to your repo to deploy.