10.19. Connect Microsoft Teams to AlgaPSA for Technician Workflows

The Microsoft Teams integration helps MSP teams keep day-to-day service work close to the conversations where technicians, dispatchers, and service managers already collaborate. After setup, technicians can open AlgaPSA from a Teams personal tab, use bot commands, search or create PSA records from messages, receive activity-feed notifications, and launch Teams meeting links for appointment workflows.

Use this guide when your MSP supports Microsoft 365 clients such as Northstar Accounting, GreenLeaf Dental Group, or Pioneer Law Group and wants faster handoffs between Teams conversations and AlgaPSA service records.

Figure 1: The Teams integration is active with a ready Microsoft profile, enabled capabilities, notification categories, and allowed technician actions.

What the Teams integration does

Capability	What technicians can do	MSP benefit
Personal tab	Open their AlgaPSA work queue, tickets, approvals, contacts, time entries, and project tasks from Teams.	Keeps technicians in context when moving from a Teams alert or bot response into the PSA.
Personal bot	Ask for assigned tickets, approvals, ticket details, notes, replies, assignments, time logging, and approval responses.	Reduces context switching for common service desk updates.
Group chat bot	Let the bot respond in Teams group chats when enabled.	Useful for dispatch or escalation rooms, but ticket details are visible to everyone in that chat.
Message extension	Search PSA records, create a ticket from a Teams message, or append a Teams message to an existing ticket or project task.	Turns client or internal Teams conversations into trackable PSA work.
Activity notifications	Send personal Teams feed notifications for assignments, customer replies, approval requests, escalations, and SLA risk.	Helps technicians and service managers act before work is missed.
Teams meetings	Generate Teams online meeting links for appointment and scheduling workflows.	Gives clients and technicians one-click meeting access from scheduled appointments.

Prerequisites

Before configuring Teams, confirm the following:

Edition access: Microsoft Teams is an Enterprise Edition integration. If you do not see the Teams settings, confirm the tenant has the required edition and feature access.
AlgaPSA permissions: You are an AlgaPSA administrator with permission to update system settings.
Microsoft app registration: Your Microsoft administrator has an app registration with a client ID, tenant ID, and client secret.
Microsoft profile in AlgaPSA: Create or confirm a ready Microsoft profile under Settings > Integrations > Providers before activating Teams.
Public base URL: The Teams app package should be generated from the production AlgaPSA URL that Microsoft Teams users will open.
User identity linking: Technicians who use Teams should sign in to AlgaPSA with their Microsoft identity or have a linked Microsoft account so Teams can map their Teams user to the correct AlgaPSA user.

Operational check: Use a named Microsoft profile such as Northstar Accounting Microsoft 365 or Main MSP Microsoft 365 rather than a generic “test app” label. Clear profile names make later troubleshooting much easier.

Step 1: Open the Teams settings

In AlgaPSA, go to Settings.
Select Integrations.
Open the Communication category.
Scroll to Microsoft Teams.

The page shows a readiness checklist, required OAuth scopes, Teams callback URLs, capability switches, notification categories, allowed actions, and the app package generator.

Step 2: Select the Microsoft profile

In the Microsoft profile field, choose the profile that should own Teams authentication and package generation.

A profile is ready for Teams when it has:

A Microsoft client ID.
A Microsoft tenant ID.
Stored client secret material.
An active, non-archived status.

After selecting the profile, click Save draft if you are still preparing the Microsoft app and Teams package. Click Activate Teams only after the Microsoft app registration and package installation plan are ready.

Step 3: Choose capabilities

Enable only the Teams surfaces your MSP is ready to support.

Capability	Recommended use
Personal tab	Enable for most Teams deployments. This is the safest starting point because it opens AlgaPSA with the user’s normal permissions.
Personal bot	Enable when technicians will use commands such as `my tickets`, `ticket <id>`, `add note`, or `log time`.
Group chat bot	Enable only after deciding which group chats can safely contain ticket details.
Message extension	Enable when technicians should search PSA records or create/update tickets from Teams messages.
Activity notifications	Enable when Teams should become a personal alert channel for assignments, customer replies, approvals, escalations, and SLA risk.

Security note: The group chat bot can show ticket information to every member of the chat. Use it for internal dispatch and escalation channels, not broad client-facing Teams channels unless your MSP has approved that workflow.

Step 4: Choose notifications and allowed actions

Use the Notifications column to decide which events should appear in a user’s Teams activity feed.

Common MSP defaults:

Notification category	When to enable it
Assignment events	Dispatchers assign tickets or project work directly to technicians.
Customer replies	Technicians need quick awareness when a client responds.
Approval requests	Service managers or client approvers need to respond quickly.
Escalations	Managers monitor aging or high-priority work.
SLA risk	Technicians need warning before a response or resolution target is missed.

Use the Allowed actions column to decide what users can change from Teams surfaces. For example, an MSP may allow Assign ticket, Add note, and Log time for all technicians, but restrict Reply to contact to technicians who are trusted to send customer-visible responses.

Every action still uses AlgaPSA permissions. If a user cannot update a ticket or approval in AlgaPSA, Teams will not bypass that permission.

Step 5: Generate the Teams app package

After the integration is active and a ready profile is selected, click Generate package.

Figure 2: Generate the Teams app package, then download the ZIP or manifest JSON for Microsoft Teams admin installation.

The generated package includes:

Teams manifest version and package version.
The app ID and bot ID from the selected Microsoft profile.
Valid domains for your AlgaPSA deployment.
Deep links for My Work, ticket, and project task destinations.
Download buttons for the Teams app package ZIP and manifest JSON.

Download app package (.zip) and give it to the Microsoft Teams administrator, or install it through your Teams admin process if you manage Teams directly.

Operational check: Generate the package from the final production URL. If you generate the package from a temporary URL, Microsoft Teams may open the wrong AlgaPSA domain after installation.

Step 6: Install and test in Microsoft Teams

In Microsoft Teams admin center or the Teams client, install the AlgaPSA Teams app package according to your organization’s app policy.

After installation, test with one technician before broad rollout:

Open the AlgaPSA personal tab in Teams.
Sign in if prompted.
Confirm My Work loads.
Open a ticket deep link from a Teams notification or bot response.
Send the bot help or my tickets.
Use the message extension to search for a known ticket, such as a Northstar Accounting backup issue.
If enabled, create a ticket from a Teams message and confirm it appears in AlgaPSA with the correct client, board, status, and description.

Technician workflows after setup

Personal tab

The personal tab can open:

My work by default.
A specific ticket.
A project task.
An approval request.
A time entry.
A contact.

If a technician does not have access to the requested record, AlgaPSA falls back to My Work and shows an access message rather than exposing the restricted record.

Bot commands

Technicians can use commands such as:

Command example	Result
`help`	Shows available commands.
`my tickets`	Lists assigned tickets.
`my approvals`	Lists pending approvals.
`ticket 1234`	Opens a ticket summary with action links.
`assign ticket 1234 to Jamie`	Reassigns the ticket when permitted.
`add note 1234: Restarted backup agent and monitoring overnight.`	Adds an internal note.
`reply to contact 1234: We restored the mailbox and confirmed access.`	Sends a customer-visible reply when permitted.
`log time ticket 1234 30m: Validated Microsoft 365 backup restore.`	Creates a time entry.
`approve approval 5678`	Approves an approval request.

Message extension

The message extension is useful when service work begins in Teams. A technician can:

Search tickets, project tasks, contacts, and approvals.
Create a new ticket from a selected Teams message.
Append a Teams message as an internal note or customer reply to an existing ticket.
Hand off to the Teams personal tab when a full PSA screen is better than an inline card.

For example, if a dispatcher sees a Teams message that says “Northstar Accounting cannot access the shared tax folder,” they can create a ticket from that message and route it to the correct board without copying and pasting into AlgaPSA manually.

Activity notifications

When activity notifications are enabled, AlgaPSA can send personal Teams feed notifications for:

Ticket assignments.
Customer replies.
Approval requests.
Escalations.
SLA risk events.

Each notification links back to the Teams personal tab so the technician can review the related AlgaPSA record.

Teams meetings for appointments

Scheduling workflows can generate Microsoft Teams meeting links when the Teams meeting capability is configured. Use this for remote support appointments, onboarding calls, vCIO reviews, or escalation meetings.

Operational check: The default meeting organizer must be a Microsoft user allowed by your Microsoft Application Access Policy. If meeting creation fails, ask the Microsoft administrator to confirm the organizer policy.

Rollout checklist

Before enabling Teams for the whole MSP, verify:

The selected Microsoft profile is named clearly and shows ready status.
The Teams package was generated from the production AlgaPSA base URL.
The Teams app is installed for a pilot technician group.
Users can sign in from the Teams personal tab.
Bot commands return only records the user is allowed to see.
Message extension ticket creation uses the correct default board and status.
Customer-visible reply actions are enabled only for appropriate roles.
Group chat bot usage is limited to approved internal channels.
Activity notification categories match your escalation and SLA process.
Meeting organizer UPN and Microsoft Application Access Policy are confirmed if appointment Teams links are used.

Troubleshooting

Problem	What to check
Teams settings are missing	Confirm Enterprise Edition access and that the Teams integration is enabled for the tenant.
No Microsoft profile is available	Finish Microsoft profile setup first: client ID, tenant ID, and stored client secret are required.
Package generation is disabled	Save or activate Teams with a ready Microsoft profile before generating the package.
Teams opens the wrong URL	Regenerate the package from the correct production AlgaPSA base URL and reinstall/update the Teams app.
A user cannot open a ticket from Teams	Confirm the user is linked to the correct Microsoft account and has AlgaPSA permission to view the ticket.
Bot commands fail	Confirm the bot capability is enabled, the Teams app is installed, and the user’s Microsoft account maps to an AlgaPSA user.
Message extension search returns too little	Check the user’s AlgaPSA permissions and confirm the record exists under the expected client or board.
Customer replies should not be available	Disable Reply to contact in allowed actions or remove the user’s permission to send customer-visible replies.
Teams activity notifications are not delivered	Confirm activity notifications are enabled, the notification category is selected, and the recipient has a linked Microsoft account.
Teams meeting links fail to create	Confirm the default meeting organizer UPN and Microsoft Application Access Policy.

Best practices for MSPs

Start with Personal tab, Personal bot, and limited allowed actions for a pilot group.
Add Message extension after technicians understand how Teams-created tickets should be triaged.
Enable Activity notifications for events that truly need action; avoid duplicating every email notification in Teams.
Treat Reply to contact as a customer communication permission, not just a convenience action.
Review group chat bot usage with service managers because record details are visible to all chat members.
Keep the Microsoft profile owner and Teams package version documented for future Microsoft credential rotations.

Navigation