Setup - Teams Phone Agent Spam Detection

  • Applies to: Microsoft Teams

Important

Teams Phone Agent is now generally available.

Book a Teams Phone Agent Discovery Session to learn what Teams Phone Agent does, how it fits your organization, and how to plan your deployment. We can also help you work through setup and configuration questions. Teams Phone Agent Discovery Sessions

We want your feedback

Help us improve Teams Phone Agent. Share your feedback on our planning and setup documentation, the Teams admin center experience, Teams Phone Agent features, or tell us about features and improvements you’d like to see.

Caution

Daylight Savings Time changes – Manual changes to Teams Phone Agent time zones required by some customers.

On November 1, 2026, Daylight Savings Time will end in North America.

In Canada, the provinces of Alberta and British Columbia will remain on Daylight Savings Time and will not move the clocks back one hour.

Customers with Teams Phone Agent time zone configurations that reference (UTC-7:00) Mountain Time (US & Canada) or (UTC-8:00) Pacific Time (US & Canada) must be updated as follows:

  • Alberta: Permanently moves to UTC-6:00.

    • Change the Teams Phone Agent time zone selection from (UTC-7:00) Mountain Time (US & Canada) to (UTC-6:00) Saskatchewan.

  • British Columbia: Permanently moves to UTC-7:00.

    • Change the Teams Phone Agent time zone selection from (UTC-8:00) Pacific Time (US & Canada) to (UTC-7:00) Arizona.

This article is for IT pros and Teams administrators who want to configure spam detection for teams phone agent calls.

Planning and licensing review

Planning

Licensing

Known issues

None.

What's new in Teams Phone Agent (last six months)

  • October 14, 2026
    • Teams Phone Agent now supports 42 voices, including 33 new ones.
  • September 30, 2026
  • September 29, 2026
  • September 1, 2026
    • Appointments integration with Microsoft Bookings can be configured via PowerShell.
  • August 31, 2026
  • August 17, 2026
    • Automatic Recording for Teams Phone Agent can be configured via PowerShell.
  • August 12, 2026
    • Spam detection can be configured via PowerShell.
    • AI disclaimer customization can be configured via PowerShell.
    • Maximum call length can be configured in PowerShell.
  • July 20, 2026
  • June 15, 2026
    • Entered Frontier Public Preview

Spam detection templates for Teams Phone Agent

Each spam detection template for Teams Phone Agent requires that the following items be configured:

Name

The name of the template.

Description

A description for the template.

Enable spam detection

Enable or disable spam detection.

Action

The action Teams Phone Agent should take when it determines the call is spam.

Supported values: DisconnectCall | TransferCallToOperator | TransferCallToTarget

  • DisconnectCall - the call will be disconnected.
  • TransferCallToOperator - the call will be transferred to the configured operator. If no operator has been configured, the call will be disconnected.
  • TransferCallToTarget - the call will be transferred to the target defined by the -CallTarget parameter.

Target

The call target when -Action is set to TransferCallToTarget.

Exclusion scope

A list of e.164 formatted phone numbers that will never be considered as spam.

Inclusion scope

A list of e.164 formatted phone numbers that will always be considered as spam.

PowerShell examples

Spam detection for Teams Phone Agent is currently configured through PowerShell only. Configuration in the Teams admin center is coming soon.


Expand to see PowerShell examples

Microsoft Teams PowerShell module 7.9.1-preview or later is required.

Example 1

Create a new spam detection template that disconnects calls determined to be spam 
New-CsMainlineAttendantSpamDetectionTemplate -Name "Spam Detection - Disconnect" -Description "Calls determined to be spam will be disconnected" -EnableSpamDetection $true -Action "DisconnectCall"

Example 2

Create a new spam detection template that transfers calls determined to be spam to the operator 
New-CsMainlineAttendantSpamDetectionTemplate -Name "Spam Detection - Disconnect" -Description "Calls determined to be spam will be disconnected" -EnableSpamDetection $true -Action "TransferCallToOperator"

Note

Configure an Operator for the Teams Phone Agent. If no operator is configured, the Teams Phone Agent disconnects the call.

Example 3

Create a spam detection template that never classifies calls from the CEO as spam 
New-CsMainlineAttendantSpamDetectionTemplate -Name "Spam Detection - Disconnect - Except CEO" -Description "Except CEO - Calls determined to be spam will be disconnected" -EnableSpamDetection $true -Action "DisconnectCall" -ExclusionScope @("+14255551212")

Assign a spam detection template to a Teams Phone Agent

To assign an existing spam detection template to a Teams Phone Agent 
Get-CsMainlineAttendantSpamDetectionTemplate

A list of existing spam detection templates is returned. Each template has a unique ID.

$tpa=Get-CsAutoAttendant -Identity <TeamsPhoneAgentGUID>
$tpa.SpamDetectionTemplateId = <ID from above>
Set-CsAutoAttendant -Instance $tpa

There are two ways to get the TeamsPhoneAgentGUID:

  1. Edit the Teams Phone Agent in the Teams admin center. The GUID is in the URL:

    https://admin.teams.microsoft.com/auto-attendants/v2/6d0713c0-d800-49aa-8a97-a2d868e0d112

  2. Use Get-CsAutoAttendant | Select-Object Identity, Name to list the first 100 Teams Phone Agents and Auto Attendants. To list more, see Get-CsAutoAttendant.

  • Last updated on