Microsoft Teams

mkdir my-teams-bot && cd my-teams-bot
npm init -y && npm pkg set type=module

{
  "compilerOptions": {
    "target": "es2022",
    "module": "nodenext",
    "moduleResolution": "nodenext",
    "strict": true,
    "skipLibCheck": true,
    "noEmit": true,
    "types": ["node"],
    "jsx": "react-jsx",
    "jsxImportSource": "@copilotkit/channels-ui"
  },
  "include": ["bot.tsx"]
}

import { createServer } from "node:http";
import { createBot } from "@copilotkit/channels";
import { teams, SanitizingHttpAgent } from "@copilotkit/channels-teams"; 
import { BuiltInAgent, CopilotSseRuntime } from "@copilotkit/runtime/v2";
import { createCopilotNodeListener } from "@copilotkit/runtime/v2/node";

// The agent. Runs in-process for the quickstart.
const runtime = new CopilotSseRuntime({
  agents: {
    assistant: new BuiltInAgent({
      model: "openai/gpt-5.4", // reads OPENAI_API_KEY
      prompt: "You are a helpful Microsoft Teams assistant. Keep replies short.",
    }),
  },
});
createServer(
  createCopilotNodeListener({ runtime, basePath: "/api/copilotkit" }),
).listen(8200);

// The bot: the Teams adapter + one handler.
const bot = createBot({
  adapters: [
    teams({ port: 3978 }), // serves POST /api/messages
  ],
  // One agent connection per Teams conversation.
  agent: (threadId) => {
    const agent = new SanitizingHttpAgent({
      url: "http://localhost:8200/api/copilotkit/agent/assistant/run",
    });
    agent.threadId = threadId;
    return agent;
  },
});

bot.onMessage(async ({ thread }) => {
  await thread.runAgent(); 
});

await bot.start();
console.log("Teams bot listening on http://localhost:3978/api/messages");

export OPENAI_API_KEY=sk-...

npx tsx bot.tsx

npx @microsoft/m365agentsplayground

What can you do?

import { Message, Header, Section, Actions, Button } from "@copilotkit/channels-ui"; 

bot.onMessage(async ({ thread, message }) => {
  if (message.text.toLowerCase().includes("deploy")) {
    await thread.post(
      <Message accent="#5B5FC7">
        <Header>Deploy v1.4.2</Header>
        <Section>Ship **v1.4.2** to production?</Section>
        <Actions>
          <Button
            style="primary"
            onClick={async ({ thread }) => {
              await thread.post("🚀 Shipping!");
            }}
          >
            Ship it
          </Button>
          <Button
            onClick={async ({ thread }) => {
              await thread.post("Standing down.");
            }}
          >
            Cancel
          </Button>
        </Actions>
      </Message>,
    );
    return;
  }
  await thread.runAgent();
});

import { defineBotTool } from "@copilotkit/channels";
import { Message, Header, Actions, Button } from "@copilotkit/channels-ui";
import { z } from "zod";

const confirmSend = defineBotTool({
  name: "confirm_send",
  description:
    "Ask the user to approve before sending. BLOCKS until they click; returns {confirmed}.",
  parameters: z.object({ summary: z.string() }),
  async handler({ summary }, { thread }) {
    const choice = await thread.awaitChoice<{ confirmed?: boolean }>( 
      <Message accent="#E2B340">
        <Header>{`📣 ${summary}?`}</Header>
        <Actions>
          <Button style="primary" value={{ confirmed: true }}>Approve</Button>
          <Button style="danger" value={{ confirmed: false }}>Reject</Button>
        </Actions>
      </Message>,
    );
    return choice?.confirmed ? "Approved, proceed." : "Declined, stop.";
  },
});

const bot = createBot({
  adapters: [teams({ port: 3978 })],
  agent: makeAgent, // as above
  tools: [confirmSend], 
});

devtunnel create copilotkit-teams -a
devtunnel port create copilotkit-teams -p 3978
devtunnel host copilotkit-teams

export OPENAI_API_KEY=sk-...
export clientId=<application-client-id>
export clientSecret=<client-secret-value>
export tenantId=<directory-tenant-id>
npx tsx bot.tsx

{
  "$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.19/MicrosoftTeams.schema.json",
  "manifestVersion": "1.19",
  "version": "1.0.0",
  "id": "<new-teams-app-uuid>",
  "developer": {
    "name": "Your company",
    "websiteUrl": "https://example.com",
    "privacyUrl": "https://example.com/privacy",
    "termsOfUseUrl": "https://example.com/terms"
  },
  "name": { "short": "CopilotKit Bot", "full": "CopilotKit Teams Bot" },
  "description": {
    "short": "A CopilotKit assistant for Microsoft Teams.",
    "full": "A Microsoft Teams bot powered by CopilotKit."
  },
  "icons": { "color": "color.png", "outline": "outline.png" },
  "accentColor": "#5B5FC7",
  "bots": [
    {
      "botId": "<application-client-id>",
      "scopes": ["personal", "team", "groupChat"],
      "supportsFiles": false,
      "isNotificationOnly": false
    }
  ],
  "validDomains": ["<your-public-host>"]
}

cd appPackage
zip -r appPackage.zip manifest.json color.png outline.png