telesign/php_telesign

The Telesign PHP SDK lets you easily integrate with our REST API.

Telesign Self-service PHP SDK

Telesign connects, protects, and defends the customer experience with intelligence from billions of digital interactions and mobile signals. Through developer-friendly APIs that deliver user verification, digital identity, and omnichannel communications, we help the world's largest brands secure onboarding, maintain account integrity, prevent fraud, and streamline omnichannel engagement.

Requirements

• PHP 7.2+.
• Composer (optional) - This package manager isn't required to use this SDK, but it is required to use the installation instructions below.

NOTE:

These instructions are for MacOS. They will need to be adapted if you are installing on Windows.

Installation

Follow these steps to add this SDK as a dependency to your project.

1. (Optional) Create a new directory for your PHP project. Skip this step if you already have created a project. If you plan to create multiple PHP projects that use Telesign, we recommend that you group them within a telesign_integrations directory.

    cd ~/code/local
    mkdir telesign_integrations
    cd telesign_integrations
    mkdir {your project name}
    cd {your project name}

2. In the top-level directory for your project, create a new Composer project.

composer init

Note that this command may need to be adjusted if your composer.phar file is not accessible in your PATH with the "composer" alias. If that is the case, reference the location of composer.phar on your file system for all Composer commands.

php {path to file}/composer.phar init

3. Enter the following selections when prompted:

• Package name (/) [{default vendor name}/{default package name}]: {your preferred vendor name}/{your project name} Use the same project name you chose for the top-level directory in step 1 above.
• Description []: Enter your preferred description or use the default.
• Author [{default author name and email address}, n to skip]: Enter your preferred description, use the default, or skip.
• Minimum Stability []: Enter your preferred value here or skip.
• Package Type (e.g. library, project, metapackage, composer-plugin) []: Enter your preferred package type.
• License []: Enter your preferred value here or skip.
• Would you like to define your dependencies (require) interactively [yes]? Enter your preferred value here or use the default.
• Would you like to define your dev dependencies (require-dev) interactively [yes]? Enter your preferred value here or use the default.
• Would you like to define your dev dependencies (require-dev) interactively [yes]? Enter your preferred value here or use the default.
• Add PSR-4 autoload mapping? Maps namespace "{vendor}{project}" to the entered relative path. [src/, n to skip]: Enter your preferred value here or use the default.

3. Install the Telesign Self-service PHP SDK as a dependency in the top-level directory of your Composer project using this command. Once the SDK is installed, you should see a message in the terminal notifying you that you have successfully installed the SDK.

   composer require telesign/telesign

Authentication

If you use a Telesign SDK to make your request, authentication is handled behind-the-scenes for you. All you need to provide is your Customer ID and API Key. The SDKs apply Digest authentication whenever they make a request to a Telesign service where it is supported. When Digest authentication is not supported, the SDKs apply Basic authentication.

What's next

• Learn to send a request to Telesign with code with one of our tutorials.
• Browse our Developer Portal for tutorials, how-to guides, reference content, and more.
• Check out our sample code on GitHub.

php_telesign's Issues

Draft Official Release for Tag v1.0.0

Can you draft an official release for tag v1.0.0? It does not show up on Packagist as a valid release and therefore it can't be installed via Composer. If you try to require v1.0.0 and install with Composer, you will get the following error:
The requested package telesign/telesign v1.0.0 exists as telesign/telesign[dev-master, v2.0.0, v2.1.0] but these are rejected by your constraint.

Thanks.

Code improvement

However we decided to not use TeleSign as because of unknown reasons TeleSign staff were impolite with us (probably this is a fake company or staff are school teenagers, this is why we assume TeleSign is just a garbage), but we improved and cleaned up your code a bit. Do you want us to submit a PR?

Link in readme is dead

Detailed documentation link https://portal.telesign.com/ is dead

Any plans to update compatibility with PHP 8.1?

After upgrade to PHP 8.1 got error:

PHP Deprecated http_build_query(): Passing null to parameter #2 ($numeric_prefix) of type string is deprecated
[internal] http_build_query
/vendor/telesign/telesign/src/rest/RestClient.php:210 telesign\sdk\rest\RestClient::execute
/vendor/telesign/telesign/src/rest/RestClient.php:154 telesign\sdk\rest\RestClient::post
/vendor/telesign/telesign/src/score/ScoreClient.php:22 telesign\sdk\score\ScoreClient::score

New release 2.2.2 is broken

It seems like your newest minor version update is broken. Recent update was about having content type "application/json" for PhoneIdClient. Code always assumes that if the request is POST then it must be "application/json" content type. That api has no required body parameters and we are not passing that. We are getting 503 HTTP response code for each request for phoneid api. It used to working with your older version 2.2.1 properly. Can you please fix this?

$content_type = in_array($method_name, ["POST", "PUT"]) ? "application/json" : "";

Thanks.

VerifyClient Class Does NOT Exist for PHP

in SMS Verify Section in the Website
there is a Code for PHP Example
But it Doesn't Work Because this doesn't work

# Instantiate a verification client object.
$verify_client = new VerifyClient($customer_id, $api_key);

I used v3.0.0