Quick start
import { Steps } from “@astrojs/starlight/components”;
The fastest path from “I’m curious” to “an AI is answering my customers’ questions” is about 5 minutes of clicking and 5 more minutes of waiting for Azure to provision resources.
What you need
- An Azure subscription in any region where Azure OpenAI is available (most are).
- Owner or Contributor + User Access Administrator on that subscription (the deploy creates RBAC role assignments).
- Microsoft Teams admin access in your tenant (one-time sideload of the Teams app).
- A website where you can paste a
<script>tag (for the widget).
If you don’t have admin on Teams or Azure, send your admin the install link — the install wizard prompts for everything they’ll need.
Five-minute walkthrough
-
Pick a plan.
On the Azure Marketplace listing, click Get It Now and choose Start (3 seats / $49), Growth (7 seats / $99), or Professional (15 seats / $199). All plans have a 30-day grace window if you cross your seat quota — you won’t be locked out the moment your team grows.
-
Run the deploy wizard.
Azure opens our custom wizard. You’ll need:
- Stack name — 3-12 lowercase letters + digits, e.g.
acmesupport. Becomes the suffix on every resource name (Cosmos, Key Vault, Function App, etc.). - Region — pick one with Azure OpenAI;
westus3is a good default. - Allowed widget origins — your website domains, e.g.
https://www.acme.com. Use*to allow any origin during evaluation. - Optional system prompt — shape the assistant’s tone. Leave blank for a helpful-generalist default.
Click Review + Create → Create. Deployment takes ~5 minutes.
- Stack name — 3-12 lowercase letters + digits, e.g.
-
Save your admin key + AAD app secret.
When the deployment kicks off, the wizard shows two one-time secrets:
- Admin key — gates
/api/dashboard,/api/cost,/api/sessions/*on your stack. - AAD app secret — used by the Teams app for SSO.
Copy both to your password manager. They cannot be recovered. (If you miss them, we have rotation recipes.)
- Admin key — gates
-
Sideload the Teams app.
In your customer dashboard, click Teams setup. Step 2 downloads a per-deployment Teams .zip. Open Teams Admin Center, click Upload new app, and select the .zip. That’s it — your agents now see a PointOfContactAI tab in Teams.
-
Embed the widget.
Add this one line to your site’s footer (replace
{customer-fa-host}with your Function App hostname — visible in the dashboard footer):<script src="https://{customer-fa-host}/api/widget.js" async></script>Refresh your page — a small chat bubble appears in the bottom-right. Click it; the assistant says hello.
What you have now
- An AI assistant answering visitors on your site.
- A Teams tab where your agents can claim chats when AI alone isn’t enough.
- A live dashboard at
https://{customer-fa-host}/api/dashboard?code=<admin-key>showing token cost, active sessions, and seat usage.
Next
- Configure the AI’s system prompt to ground answers in your specific product.
- Pin the Teams app tenant-wide so all your agents see it automatically.
- Set tighter
allowedOriginsbefore launching to production traffic.