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 Widget in Flow Configuration

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

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

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.