ConnectorsSetup GuidesFraud

Telesign Connector

Integrate the Telesign Phone Number Intelligence API to assess the risk associated with phone numbers. This connector leverages Telesign's technology to provide a risk score, helping you identify and mitigate potential threats. For more details on the Telesign API, refer to their official documentation.

Ensure you have your Telesign API Key and Customer ID ready by visiting Telesign support.

Configuration

To set up the Telesign Connector in your project, navigate to the Connectors page, select the Telesign connector, and configure the following parameters:

  • Connector Name: Assign a unique name to your connector for easy identification, particularly useful when using multiple connectors of the same type.
  • Connector Description: Summarize the purpose of your connector.
  • API Key: Your Telesign API Key.
  • Customer ID: Your Telesign Customer-ID.

Testing

It's crucial to test your connector to ensure its configuration is correct:

  • Utilize the Test button to verify the setup of your connector.

This testing step confirms the connector is properly configured to analyze and score phone numbers effectively.

For additional help or troubleshooting, refer to Telesign's documentation or contact Descope support.

Using the Telesign Connector in a Flow

This flow shows how the Telesign connector is utilized to check the riskiness of a phone number.

Overview of Flow Using Telesign Connector

Connector Widgets in Flow Configuration

Check Phone Number

To request risk insights, set the Request Risk Insights parameter to true within the connector widget in your flow configuration. This setting enables the assessment of the phone number's risk level.

Connector Widget in Flow Configuration

Get Phone Number Information

This connector can also be used to retrieve detailed information such as carrier, phone type, and risk level about a phone number with the "Get Phone Number Info" widget.

Simply include the phone number, and optionally Originating IP, Account Lifecycle Event, and External ID, and the aforementioned information will be mapped to the connectors.telesign_getPhoneInfo key (or a key you customize). You can use a Condition Step to later refer to this key and query its data.

Get Phone Number Information Connector Widget in Flow Configuration

Condition to Check Risk Score

After obtaining the risk score, you should add a condition to your flow that checks if the risk score is greater than 600. Scores above 600 indicate a high likelihood of the phone number being involved in malicious activities.

Condition to Check Risk Score

Step-by-Step Guide

1. Add a Phone Input Screen

First, add a screen with a phone input.

Descope phone input screen

2. Add the "Check Phone" Connector Action to Your Flow

First, integrate the "Check Phone" action from Telesign into your flow. This action will analyze the phone number and return a risk score.

3. Add a Condition to Evaluate the Risk Score

Following the action, incorporate a condition to evaluate the risk score obtained from the Telesign connector. Use the result in the following format: connectors.telesign_checkPhone.risk.score. This score ranges from 0 to 1000, where 0 indicates safety and 1000 indicates a high likelihood of malicious activity.

For a risk score greater than 600, Telesign recommends taking protective measures.

Was this helpful?

Previous

reCAPTCHA v3

Next

HubSpot

On this page

Telesign ConnectorConfigurationTestingUsing the Telesign Connector in a FlowConnector Widgets in Flow ConfigurationCheck Phone NumberGet Phone Number InformationCondition to Check Risk ScoreStep-by-Step Guide1. Add a Phone Input Screen2. Add the "Check Phone" Connector Action to Your Flow3. Add a Condition to Evaluate the Risk Score