Inbound Spam Protection

Important: Due to the complexity of this template, you should contact the IntelePeer account manager or Customer Success (CS) representative before attempting to use it. The CS team will help you install and set up the template.

The Inbound Spam Protection SmartFlows template is used for screening inbound calls. The template can be used to combat robocallers who place unwanted calls to your organization.

The telephone (DID) and toll-free numbers you want to protect will be assigned to the flow. For each inbound call to those numbers, the calling party number is screened for its spam risk. Low risk numbers are transferred to the originally dialed number with no flow interaction with the caller; the caller is unaware the call passed through a screening logic. Medium risk and high-risk numbers trigger flow interaction with the caller; human callers will successfully navigate the interaction whereas robocallers will not.

For more information, check out Understanding Inbound Spam Protection.

Actions

Inbound Call – The Inbound Call trigger prepares the flow for a call.

Setvar (Variables_Settable) - Defines variables used later in the flow; requires modification.

Setvar (Variables_Fixed) - Defines variables used later in the flow; not to be modified.

Cond (Enabled?) - Checks whether spam protection screening is enabled or disabled.

Transfer - Transfers the call to the originally dialed number.

Audio - Audio announcement for various responses; for example, if a transfer action fails.

Hangup - Hang up in case of failure on the transfer or in case the transfer is successfully answered by the recipient but the recipient subsequently hangs up before the caller hangs up.

Switch - Checks whether the caller invoked privacy on the calling party number. Private numbers are not shared with the SmartFlows platform and thus cannot be used to query the YouMail API.

Add List Item (List_Add) - Creates an entry for the call in the flow's diagnostic log via list management.

Regex - Checks whether the calling party number is part of the North American Numbering Plan (country code 1). The YouMail API is not queried for non-NANP numbers.

Update List Item (List_Update) - Updates the flow's diagnostic log for calls where the calling party number is private or non-NANP (since those calls are exempt from YouMail spam risk evaluation). Orq, indicates the flow took the fail exit branch off the YouMail API query.

External Web Call (YouMail) - Makes API query to YouMail to determine spam risk level for calling party number.

Cond - Verifies the YouMail API query returned an expected HTTP response status codes.

String Operations - Generates three pseudo-random digits derived from the API transaction timestamp for later use.

Switch (YouMail Outcome Switch) - Sends the flow down different branches depending on whether the YouMail risk level was low, medium, or high.

DTMF (Yellow, Red) - Provides challenge question and DTMF response to the question.

Counter - Counts the quantity of incorrect entries.