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

Help shape the product by filling out our feedback form or by sending us an email

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)

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