Versions Compared

Old Version 9

changes.mady.by.user XCALLY Knowledge

Saved on

compared with

New Version Current

changes.mady.by.user Product Knowledge

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
ON THIS PAGE

On this page

Table of Contents
minLevel1
maxLevel
7
Image Removed   Here
3
outlinefalse
stylenone
typelist
printablefalse

📋 What’s about

Here you find the configuration steps for the SMS providers interface supported by XCALLY Motion SMS Channel.

General

(blue star) Requirements

Panel
bgColor#EAE6FF

  • You need a valid account with positive balance on the chosen platform

  • You need a SMS-capable phone number on the chosen platform

  • The Motion instance must have a public address accessible via HTTPS. For security reasons we strongly recommend using a Reverse Proxy → find out more

Go to this wiki page to find out how to set up XCALLY Motion SMS accounts for these interactions.

Setup

⚙️ Configuration:

🔸 Twilio Configuration

In the following section we will provide you a brief description on how to properly configure a Twilio account on XCALLY Motion SMS Channel.

Info

The message status (checkmark) is automatically updated when the positive delivery report is received by Motion

Retrieve Account SID

The Account SID information is the same for each Twilio account and it could be retrieved in Twilio Console

Image RemovedImage Added

Retrieve Auth Token

The Auth Token information is the same for each Twilio account and it could be retrieved in Twilio Console

Image RemovedImage Added

Configure incoming message

In order to To receive incoming SMS message in your XCALLY Motion Account, you need to properly configure the Messaging options in the Twilio Phone Number configuration:

  • Open the Phone Numbers section from Twilio Console

  • Select the Phone Number from the list

    Image RemovedImage Added

  • Configure the Messaging properties as displayed in the following image

    Image RemovedImage Added

The Webhook property must be retrieve from XCALLY Motion SMS Account

Troubleshooting

Please check the Debugger section inside your Twilio management console. You can find error messages there in case of setup mistakes.
i.e. the below Twilio debugger messages mean that you did not setup a proper SSL https certificate inside your XCALLY machine:

Image RemovedImage Added

🔸 Skebby Configuration

In the following section we will provide you a brief description on of how to properly configure a Skebby account on XCALLY Motion SMS Channel.

Configure incoming message

In order to To receive incoming SMS message messages in your XCALLY Motion Account, you need to properly configure the Sms Automation settings in the Skebby portal:

  • Open Receive SMS settings

Image Removed

  • Add New SMS Automation rule

Image Removed

  • Configure the rule properties as displayed in the following screenshot

Image Removed
Image Added
Warning

Please be sure that Encoding property is UTF-8 and mode is POST HTTP

The POST HTTP property must be retrieved from XCALLY Motion SMS Account

Configure delivery report

Info

Remember that this option is working if you select Classic+ as method: the message status checkmark is updated when the positive delivery report is received by Motion

In order to To receive the Delivery Report for outgoing SMS messages, you need to properly configure the Notify Url property in Skebby Advanced Settings:

  • Open Settings - Advanced Settings


Image Removed

  • Configure the Settings Notify

Url

  • URL property

Image Removed
Image Added
Warning

Please be sure that method is POST

The Settings Notify Url property must be

retrieve

retrieved from the XCALLY Motion SMS Account

🔸 Connectel Configuration

In the following section, we will provide you a brief description on how to properly configure Connectel account on XCALLY Motion SMS Channel.

Retrieve Auth Token

The Auth Token must be generate generated and it could be retrieved in Connectel Account

Image RemovedImage Added


Configure incoming message

The task is not automated. Please contact Connectel Helpdesk to set the Webhook URL: it must be retrieved from XCALLY Motion SMS Account

Configure delivery report

Info

Remember that the message status checkmark is updated when the positive delivery report is received by Motion

In order to To receive the Delivery Report for outgoing SMS messages, you need to properly configure the Callback URL property in Token Settings:

  • Open Account - Authentication tokens

Image Removed
  • Image Added

  • Select Authentication token used in SMS Account

Image Removed
  • Image Added

  • Open Settings

Image Removed
  • Image Added

  • Configure the Callback Url property

Image Removed
  • Image Added

The Settings Notify Url property must be retrieved from the XCALLY Motion SMS Account

🔸 ClickSend Configuration

In the following sections, we will provide you with a brief description on of how to properly configure a ClickSend account on the XCALLY Motion SMS Channel.

Retrieve Password/API Key

As an alternative to a Password account, you can fill the password field with API Key property.

The API Key is the same for each ClickSend account and it could can be retrieved in ClickSend Dashboard in API Credentials popup:

  • Click on API Credentials

    Image RemovedImage Added


  • Get API Key property

    Image RemovedImage Added


Configure incoming message

In order to receive incoming SMS message in your XCALLY Motion Account, you need to properly configure the SMS Inbound Rules in ClickSend SMS Settings:

  • Open SMS - Settings section from ClickSend Dashboard

  • Open Inbound SMS Settings section

  • Add new SMS Inbound Rule for your dedicated number as described below

    Image RemovedImage Added

    The URL property must be retrieve from XCALLY Motion SMS Account

Configure delivery report

Info

Remember that the message status checkmark is updated when the positive delivery report is received by Motion

In order to To receive the Delivery Report for outgoing SMS messages, you need to properly configure the SMS Delivery Report rulein SMS Settings:

  • Open SMS - Settings section from ClickSend Dashboard

  • Open Delivery Report Settings

  • Add new SMS Delivery Report Rule as described below

    Image RemovedImage Added


The Action Address property must be retrieve from XCALLY Motion SMS Account

🔸 Plivo Configuration

In the following section, we will provide you a brief description on how to properly configure a Plivo account on the XCALLY Motion SMS Channel.

Info

The message status (checkmark) is automatically updated when the positive delivery report is received by Motion

Retrieve Auth ID

The Account SID information is the same for each Plivo account and it could be retrieved in Plivo Console

Retrieve Auth Token

The Auth Token information is the same for each Plivo account and it could be retrieved in Plivo Console

Configure incoming message

In order to To receive incoming SMS message messages in your XCALLY Motion Account, you need to add a new application for SMS channel and assign it to your phone number:

  • Open the Applications section from SMS channel

    Image Removed


    Image Added

  • Add New Application as displayed in the following image

    Image RemovedImage Added

The Message URL property must be retrieve retrieved from XCALLY Motion SMS Account

  • Open Numbers section from Phone Number

    Image RemovedImage Added

  • Edit your number and select your application as Plivo App

    Image RemovedImage Added

🔸 Clickatell Configuration


In the following section, we will provide you a brief description on of how to properly configure a Clickatell account on XCALLY Motion SMS Channel.

First of all, you must login must log in to https://www.clickatell.com/ and click on Sign in:

Now you will be asked to choose among three accounts typeaccount types:

Image RemovedImage Added

Click on Sign in on the SMS Platform/Touch/Whatsup type: 

Image RemovedImage Added

and then login using the your credentials on the Clickatell Portal (https://portal.clickatell.com):

Image RemovedImage Added

The system will show you the API key for the SMS integration. Click on Manage SMS integration to add the solution account:

Image RemovedImage Added


Create the new integration:

Image RemovedImage Added


following the next steps:

  • Tab Details: Give a name to your integration (optionally fill describe form): choose Production Environment to obtain
    an active integration (Sandbox is used by developers). Then  click on HTTP Api Type;

  • Tab Features: select Two-Way Messaging (automatically it will select Time Critical as a delivery type)

Image RemovedImage Added

  • Tab settings: Enable 3 part messages (Optional: it allows you to send longer messages)

Image RemovedImage Added

and insert the provided endpoint URL to receive notifications when the Customer receives messages, then select POST method.

Image RemovedImage Added

  • Tab Two-Way Settings: insert the provided endpoint Url that will receive notification when the Customers send a message to the XCALLY Motion Agent. You can also customize the Stop Commands (e.g. for US, those proposed are mandatory)

At the end Save your Integration.

Now you can check the setting:

and keep note of the API Key (generated for this integration) that will be used later to create the specific Clickatell SMS Account on XCALLY Motion (mandatory field).

🔸 CSCTelecom Configuration 

In the following section we will provide you a brief description on how to properly configure a CSC account on XCALLY Motion SMS Channel.

Info

For information on this service and signing up, please contact CSCTelecom at sales@csc.lv or go to https://multisms.lv/en/

First of all, login to the CSCTelecom platform at https://sms.csc.lv/ using your credentials:

and you will access to CSC messaging dashboard, where you can send messages using the provided numbers:

Image RemovedImage Added


On the dashboard, you can monitor reports about your sent and received messages:

Image RemovedImage Added

and you can manage your senderID or eventually, you can change it and use a mobile phone (check your SMS messaging contract with CSC).

Image RemovedImage Added


You can also retrieve useful information about your SMS interactions also in Statistics section, where your interactions will be shown as graphs and delivery reports:

Image RemovedImage Added

Go to Miscellaneous > Settings:

  • check your username

  • retrieve your generated apiKey (you will use it later on XCALLY Motion SMS configuration)

  • fill the fields Delivery receipts URL and Incoming URL, inserting respectively the values retrieved on XCALLY Motion Delivery Report URL and Receive URL:

At the end Save all.

🔸 Infobip Configuration

The configuration on Infobip is managed directly from by the Infobip Support Team.

Contact them in order to get the following:

  • name

  • password

  • telephone number

  • Base URL (read details below)

and send to Infobip the Receive URL generated by the New SMS Account creation on XCALLY Motion.

When the integration is activated the Infobip Team will notify you.

Info

About Base URL

You can also find the Base URL at https://dev.infobip.com/getting-started/base-url

Image RemovedImage Added

  • Insert username and password inside the form mask

Image RemovedImage Added

  • once returned on the home page, click on HTTP API on the top left, near the Infobip logo 

Image RemovedImage Added

  • go to Base Url, copy the URL generated and past it inside Motion

Image Removed

⚠️ Please notice that the correct syntax is: xxxxx.api.infobip.com

Image Added

🔸 IntelePeer Configuration

In the following section we will provide you a brief description on how to properly configure an Intelepeer account on XCALLY Motion SMS Channel.

Go to IntelePeer Customer Portal, and insert your credentials (username, password) to have access to your IntelePeer Service Dashboard:

Image RemovedImage Added


Go to User Management to add new Users and Contacts:

Image RemovedImage Added

Click on the contact row to open the editor, and manage roles and privileges:

Go to the switch button (you can find it on the website header).
Select Trusted Senior Specialist to go to My Application Dashboard (you’ll see four big buttons, each for every service available on the portal. Select SMS service button):

Image RemovedImage Added

The first dashboard you’ll see is the table list of all the numbers (longcodes and shortcodes) provisioned by IntelePeer to send SMS to customers. 

Take note of one of your provisioned numbers and control if they are enabled (they will be used to create XCally Motion SMS Accounts):

Image RemovedImage Added


Info

You can create as many accounts on Motion as the numbers enabled on IntelePeer portal, but you can associate only one number to each SMS account.


Click on the cog icon (you find it on the right corner) to open SMS management submenu. Here you can create an apiKey (1 month, 6 months, 1 year expire period available), that will be used to grant permissions to all REST API actions performed by XCally Motion Sms Integration:

Image RemovedImage Added

Now you’re ready to create your first Intelepeer SMS account (to do this, remember to take note of one of your enabled numbers and of the generated apiKey).

🔸 Bandwidth Configuration

In the following section, we will provide you with a brief description on how to properly configure a Bandwidth account on XCALLY Motion SMS Channel.

Info

The message status (checkmark) is automatically updated when the positive delivery report is received by XCALLY Motion

After creating a Bandwidth Account with a telephone number associated to it, follow the instructions below to configure the interaction with XCALLY Motion.

Retrieve Account ID

The Account ID can be conveniently found in the URL when logged in to the Bandwith Dashboard , as well as in the top right-hand corner of the landing page.

Info

AccountId Location in Dashboard URL: https://dashboard.bandwidth.com/portal/r/a/{accountId}

Retrieve Application ID

For the integration, you need to configure an Application in your Bandwidth account:

  1. Open Bandwidth Dashboard

  2. Open the Applications section and click on Create New on the left

  3. Fill the following fields:

    1. Application name

    2. Enable Use multiple callback URLs

    3. Inbound callback URL 

    4. Outbound callback URL 

    5. Enable message-delivered, message-failed and message-sending callbacks

  4. Finally press Create application button to retrieve Application ID

Image RemovedImage Added

Once the app has been configured, you need to link the app to the phone number via the location:

  1. Open Bandwidth Dashboard

  2. Open the Applications section and select the application on the left

  3. Scroll down to ASSOCIATED LOCATION section and click on + ASSOCIATE LOCATION button

  4. Select the Location associated to your Phone Number and Save


Image RemovedImage Added

Retrieve Credentials

For the integration it is possible to use the username and password of the Bandwidth account or sub-account, or it is possible to generate the API Credentials:

  1. Open Bandwidth Dashboard

  2. Open the Applications section and click on API CREDENTIALS at the top right corner

    Image Removed


    Image Added


  3. Press CREATE NEW button to generate a new API Token and API Secret

    Image Removed


    Image Added

🔸 Telnyx Configuration

Please consult the following page to properly configure a Telnyx account on XCALLY Motion SMS Channel.