October 20, 2017
Updated:  March 1, 2020

Single Sign On functionality is intended for third party Customer service providers logging in to a sticky.io domain.

Please see the attached file at the bottom of the page for an example of how to implement and receive the link necessary for sticky.io Single Sign On. Implementing Single Sign On directly is an advanced feature and is only necessary for tight integration of sticky.io to call center software. Most call centers will be able to use our https://my.sticky.io agent portal to manage single sign on for call center agents.

There are URL based integrations that can be used to link call center software (e.g. Five9) to sticky.io Platform single sign on. When you are assigned a single sign on account as a call center, you will be assigned a group ID. Your system will also need to have knowledge of the client subdomain that you are attempting to access. The format for the "pop URL" will be:

https://my.sticky.io/sso/group/[client_subdomain]?group=[group_id]

For example, if you are assigned group_id=21 and are attempting to connect to client_subdomain=demoaws:

https://my.sticky.io/sso/group/demoaws?group=21

If the agent has not logged into my.sticky.io before, they will be prompted to login with their assigned username/password, but then be directed straight to the Platform for demoaws (e.g. https://demoaws.sticky.io). The next time the agent takes a call and is directed to a new Platform, they should not have to sign in as long as the session has not timed out. For example if the next call is for client_subdomain=sandboxdemo, the next pop URL will be:

https://my.sticky.io/sso/group/sandboxdemo?group=21

This would take the agent straight into sandboxdemo (https://sandboxdemo.sticky.io) without logging in again.

In the case that a call center wants to directly implement the low level SSO API, the following information would need to be provided by sticky.io to the call center partner.

The required fields to make a successful request are:

  • Platform-Key (This will be given to you by sticky.io)
  • department_id (These will be given to you by sticky.io)
  • username (your agents should have unique usernames in order to track activity of an agent)
  • fullname (full name of the agent)

To perform the request, you will send a cURL request to https://<APPKEY>.sticky.io/sso/0 where <APPKEY> is the client that you are requesting the token from. For example, a request would be sent to https://demoaws.sticky.io/sso/0

In the headers of the request, include the following:

  • Content-type: application/json,
  • Platform-Key: <PLATFORM_KEY>

The <PLATFORM_KEY> value will be provided to you by sticky.io. In addition, a whitelist of IP addresses from the call center that will be making this SSO request MUST be provided to sticky.io in order to set this up.

Finally, for the data portion of the cURL you will include the parameters for the request in JSON format. The required fields are listed above. There are optional fields that can be added to the request:

  • campaign_id (This is a csv of the sticky.io campaign IDs that the user will have permission to, if you leave this parameter blank, sticky.io will assume that the user has access to all campaigns)
  • email (the email address of the agent)
  • call_center_did (inbound phone number the customer called into)
  • customer_cid (customer phone number via caller ID)

The response returned will be in JSON format. The values returned are as follows:

  • success
  • code
  • url
  • message
  • status
  • descriptor

A successful response will return a success of 1 and code of 200.  

Any failures will return a success of 0, the code for the failure that occurred, and a message with a description of why the request has failed.

<?php
// Be sure to update the <APPKEY> and <PLATFORM_KEY> accordingly

$username      = '';
$fullname      = '';
$department_id = '';

$headers = [
   'Content-type: application/json',
   'Platform-Key:  <PLATFORM_KEY>',
];

$data    = [
   'username'      => $username,
   'fullname'      => $fullname,
   'department_id' => $department_id,
];

$curl = curl_init();

curl_setopt_array($curl,
   [
      CURLOPT_URL            => 'https://<APPKEY>.stickycrm.io.com/sso/0',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_TIMEOUT        => 30,
      CURLOPT_SSL_VERIFYHOST => true,
      CURLOPT_SSL_VERIFYPEER => false,
      CURLOPT_HTTP_VERSION   => CURL_HTTP_VERSION_1_1,
      CURLOPT_CUSTOMREQUEST  => 'POST',
      CURLOPT_HTTPHEADER     => $headers,
      CURLOPT_POSTFIELDS     => json_encode($data),
   ]
);

$response = curl_exec($curl);

curl_close($curl);

if ($results = json_decode($response))
{
   print_r($results);
}
else
{
   echo 'Something went wrong. Double check your configuration.';
}


Did this answer your question?