Microsoft Teams Bot API Integrations

import { axios } from "@pipedream/platform" export default defineComponent({ props: { microsoft_teams_bot: { type: "app", app: "microsoft_teams_bot", } }, async run({steps, $}) { return "Azure Bot successfully authenticated." }, })

To connect your Teams Bot to Pipedream, you'll need to create a bot in Azure, set up a webhook in Pipedream, and configure the Teams app manifest. Follow the detailed instructions below to get started.

Configuring a Teams Bot in Azure Portal

To get started, you'll need the following:

An Azure account
A Microsoft Teams account
Basic familiarity with Azure Portal

Quickstart

Create a bot in the Azure Portal
Set up a Pipedream webhook
Configure the bot's messaging endpoint
Create and upload the Teams app manifest
Install the bot in Teams
Configure your Pipedream workflow

For detailed instructions, follow the steps below.

Detailed Setup Instructions

1. Create a Bot in Azure

Sign in to the Azure Portal
Create a new "Azure Bot" resource
During creation:
- Select "Create new" Microsoft App ID
- Note down the generated App ID (client_id)
Navigate to the "Configuration" section
Generate a new client secret
Note down the secret value immediately (you won't be able to see it again)

2. Set Up Pipedream Webhook to receive bot messages

Go to Pipedream
Create a new workflow starting with an HTTP trigger
Copy the generated webhook URL (format: https://xxx.m.pipedream.net)
- This will be your bot messaging endpoint

3. Configure Bot's Messaging Endpoint

Return to your Azure Bot resource
Under "Configuration"
Set Messaging endpoint to your Pipedream webhook URL

4. Create Teams App Manifest

Create a new file called manifest.json with the following template:

{
    "$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.14/MicrosoftTeams.schema.json",
    "manifestVersion": "1.14",
    "version": "1.0.0",
    "id": "<your-bot-app-id>",
    "packageName": "com.yourcompany.bot",
    "developer": {
        "name": "Your Company",
        "websiteUrl": "https://your-website.com",
        "privacyUrl": "https://your-website.com/privacy",
        "termsOfUseUrl": "https://your-website.com/terms"
    },
    "name": {
        "short": "Your Bot Name",
        "full": "Your Bot Full Name"
    },
    "description": {
        "short": "A brief description",
        "full": "A full description of your bot"
    },
    "icons": {
        "outline": "outline.png",
        "color": "color.png"
    },
    "accentColor": "#FFFFFF",
    "bots": [
        {
            "botId": "<your-bot-app-id>",
            "scopes": [
                "personal",
                "team",
                "groupchat"
            ],
            "supportsFiles": false,
            "isNotificationOnly": false
        }
    ],
    "permissions": [
        "messageTeamMembers"
    ]
}

Create two icon files:
- outline.png (32x32 pixels)
- color.png (192x192 pixels)
Zip these three files together

5. Install Bot in Teams

Open Microsoft Teams
Go to Apps > Upload a custom app
Upload your zip file
Follow installation prompts, and your bot will now be added to Microsoft Teams!

6. Configure Pipedream Workflow

Add "Microsoft Teams Bot" app in Pipedream
Enter your Bot's App ID and client secret
Configure your workflow to process and respond to messages