Microsoft Teams

Technical Preview

Overview

A client-mode connector for a curated messaging slice of Microsoft Graph Teams and Workflows Incoming Webhooks:

Catalog connector event	Entity / path	Notes
POST teams/{id}/channels/{id}/messages	`POST /teams/{team-id}/channels/{channel-id}/messages`	Host: `https://graph.microsoft.com/v1.0` — Bearer Entra token
POST Adaptive Card to webhook URL	`POST {webhook_path}`	Host: operator Workflows / Power Automate origin — no Authorization
POST chats/{id}/messages	`POST /chats/{chat-id}/messages`	Host: Graph v1.0 — Bearer Entra token

Default BASE_ADDRESS is https://graph.microsoft.com/v1.0. Topics use messaging/microsoft-teams/<object>/<verb>.

Workflows Incoming Webhooks are not on graph.microsoft.com. When calling Postwebhookadaptivecard, set connector BASE_ADDRESS to the webhook origin (scheme + host + port) and put path + query in webhook_path. Auth for the webhook is embedded in the URL; do not send an Authorization header.

Prefer Hub secrets for Entra access tokens. Channel/chat send usually needs a delegated token (ChannelMessage.Send, Chat.ReadWrite). This template has not been verified against a live Teams tenant. Status remains blocked until an authenticated live smoke succeeds.

Basic Syntax

# Coreflux REST_API template — Microsoft Teams (Graph + Workflows webhook)
# Auth Graph: Bearer {value.json.access_token}
# Auth Webhook: none (URL embeds signature)
# BASE_ADDRESS Graph: https://graph.microsoft.com/v1.0
# Webhook: set BASE_ADDRESS to webhook origin

DEFINE ROUTE MicrosoftTeamsRestApi WITH TYPE REST_API
    ADD REST_API_CONFIG
        WITH BASE_ADDRESS "https://graph.microsoft.com/v1.0"
        WITH ENABLE_CLIENT "true"
        WITH USE_SSL "true"
        WITH REQUEST_TIMEOUT '60'
        WITH DEFAULT_CONTENT_TYPE "application/json"
    ADD EVENT Postchannelmessage
        WITH SOURCE_TOPIC "messaging/microsoft-teams/channel/message"
        WITH DESTINATION_TOPIC "messaging/microsoft-teams/channel/message/response"
        WITH METHOD "POST"
        WITH ENDPOINT "/teams/{value.json.team_id}/channels/{value.json.channel_id}/messages"
        WITH HEADERS
            ADD "Accept" "application/json"
            ADD "Content-Type" "application/json"
            ADD "Authorization" "Bearer {value.json.access_token}"
        WITH BODY "{payload}"
    ADD EVENT Postchatmessage
        WITH SOURCE_TOPIC "messaging/microsoft-teams/chat/message"
        WITH DESTINATION_TOPIC "messaging/microsoft-teams/chat/message/response"
        WITH METHOD "POST"
        WITH ENDPOINT "/chats/{value.json.chat_id}/messages"
        WITH HEADERS
            ADD "Accept" "application/json"
            ADD "Content-Type" "application/json"
            ADD "Authorization" "Bearer {value.json.access_token}"
        WITH BODY "{payload}"
    ADD EVENT Postwebhookadaptivecard
        WITH SOURCE_TOPIC "messaging/microsoft-teams/webhook/adaptive-card"
        WITH DESTINATION_TOPIC "messaging/microsoft-teams/webhook/adaptive-card/response"
        WITH METHOD "POST"
        WITH ENDPOINT "{value.json.webhook_path}"
        WITH HEADERS
            ADD "Accept" "application/json"
            ADD "Content-Type" "application/json"
        WITH BODY "{payload}"

Events

Event	Method	Endpoint	Request topic	Response topic
Postchannelmessage	POST	`/teams/{team_id}/channels/{channel_id}/messages`	`messaging/microsoft-teams/channel/message`	`messaging/microsoft-teams/channel/message/response`
Postchatmessage	POST	`/chats/{chat_id}/messages`	`messaging/microsoft-teams/chat/message`	`messaging/microsoft-teams/chat/message/response`
Postwebhookadaptivecard	POST	`{webhook_path}`	`messaging/microsoft-teams/webhook/adaptive-card`	`messaging/microsoft-teams/webhook/adaptive-card/response`

Auth

Microsoft Graph (channel / chat):

Register an Entra ID app (or use an existing one) and obtain an access token for https://graph.microsoft.com.
Prefer delegated permissions: ChannelMessage.Send, Chat.ReadWrite / ChatMessage.Send.
Set connector BASE_ADDRESS to https://graph.microsoft.com/v1.0.
Pass access_token on the MQTT request payload so headers resolve: Authorization: Bearer {value.json.access_token}.
Store the token in Hub secrets / GET SECRET "TEAMS_GRAPH_TOKEN". Never commit real credentials.
Successful send returns HTTP 201.

Workflows Incoming Webhook (Adaptive Card):

In Teams, create a Workflow from a webhook template (or Power Automate “When a Teams webhook request is received”).
Copy the HTTP POST URL. Split into origin → BASE_ADDRESS and path+query → webhook_path.
POST an Adaptive Card wrapper (type: message, attachments[].contentType: application/vnd.microsoft.card.adaptive).
No Authorization header. Expect HTTP 200/202 depending on the connector.

Example payloads

Channel message:

{
  "access_token": "YOUR_ENTRA_ACCESS_TOKEN",
  "team_id": "TEAM_GUID",
  "channel_id": "CHANNEL_ID",
  "body": { "content": "Hello from Coreflux" }
}

Chat message:

{
  "access_token": "YOUR_ENTRA_ACCESS_TOKEN",
  "chat_id": "CHAT_ID",
  "body": { "content": "Operator ack" }
}

Webhook Adaptive Card (BASE_ADDRESS = webhook origin):

{
  "webhook_path": "/workflows/.../triggers/manual/paths/invoke?api-version=2016-06-01&sp=...&sv=1.0&sig=...",
  "type": "message",
  "attachments": [
    {
      "contentType": "application/vnd.microsoft.card.adaptive",
      "contentUrl": null,
      "content": {
        "type": "AdaptiveCard",
        "version": "1.4",
        "body": [{ "type": "TextBlock", "text": "Coreflux alarm", "weight": "Bolder" }]
      }
    }
  ]
}

Deploy notes

Deploy MicrosoftTeamsRestApi.lot only (-addRoute). Do not deploy hub-metadata.lot as a connector — it exists for Hub / -listTemplates (ADD METADATA + WITH IMAGE base64).
Hub category: REST API Connectors.
Doc link: https://docs.coreflux.org/latest/lot-language/routes/rest-api-apps/microsoft-teams

Quick Start

Coreflux MQTT Broker

LoT Language

Coreflux HUB

VS Code - LoT Notebooks

Coreflux Portal

Using AI with Coreflux

Product Updates

Overview

Basic Syntax

Events

Auth

Example payloads

Deploy notes

​Overview

​Basic Syntax

​Events

​Auth

​Example payloads

​Deploy notes

​Related

Overview

Basic Syntax

Events

Auth

Example payloads

Deploy notes

Related