Microsoft Teams

​

Overview

​

Two ways to connect

​

Connection Method 1: Use Lua’s Teams bot (Quick Start)

1

Open the dashboard

lua admin

Or visit https://admin.heylua.ai.

2

Open your agent and add a channel

Click Agents in the main side navigation, select your agent’s card, click the + (plus) icon to add a channel, then choose Microsoft Teams.

Screenshot: The agent’s add-channel (+) control and the channel options

3

Choose Use Lua's Teams bot

Pick Use Lua’s Teams bot. No Azure credentials are required for this path.

4

Install the Lua Teams app

The dashboard gives you a Teams app package to install (or a direct install link). In Microsoft Teams, an admin uploads the app: Apps → Manage your apps → Upload a custom app, then selects the package Lua provided. If your tenant restricts custom app uploads, a Teams admin may need to approve it first in the Teams admin center.

5

Connect your agent

Installing the app doesn’t yet link it to your agent — one quick step does. The dashboard gives you a Connect link. Open it: it starts a chat with the Lua bot and pre-fills a one-time connect message. Just send it, and the bot replies “Connected to agent…” — your organization is now linked to this agent.

Why this step exists: Lua’s bot is shared across many organizations, so this one-time link is how Lua learns which agent your organization belongs to. (Running your own bot instead? Then there’s no connect step — see Bring Your Own Azure Bot.)

The connect link is single-use and expires after 24 hours. If it expires before you use it, regenerate it from the dashboard.

6

Start chatting

@mention the bot in a team channel, or send it a direct message, and your agent will reply.

Done — with zero Azure setup. No subscription, no Bot resource, no secrets to rotate.

​

Connection Method 2: Bring Your Own Bot (Advanced)

1. In the Azure Portal, create an Azure Bot (Single Tenant), set its Messaging endpoint to https://wa.heylua.ai/teams/webhook, and enable the Microsoft Teams channel.
2. Copy the bot’s App ID, create a client secret, and note your Tenant ID.
3. In the Lua dashboard, choose Bring your own bot, paste those three values, and click Connect — your bot is now linked to your agent. Download the app package Lua generates, upload it to Teams, then @mention or DM the bot.

​

Notes & limitations

• Reactive replies and warm follow-ups only. Your agent replies wherever it’s been messaged or @mentioned. There is no cold-start path — you can’t message a Teams user who has never contacted your agent. See Channel Capabilities for the full outbound matrix.
• Where the bot replies. The bot responds in the same chat or channel it was messaged or @mentioned in — a DM gets a DM reply, a channel @mention gets a channel reply.
• Tenant admin approval. Depending on your Microsoft 365 tenant’s app policies, uploading a custom Teams app (Lua’s shared bot or your own manifest) may require a Teams admin to allow custom app uploads or approve the app in the Teams admin center.
• Further reading: Microsoft’s Azure Bot Service documentation and Teams app manifest schema.

​

Sending Proactive Messages

import { Channels } from 'lua-cli';

await Channels.send({
  channel: 'teams',
  to: { userId },
  text: 'Heads up — your report is ready.',
});

​

Next Steps