V3 Cloud Providers

V3 Cloud Providers

 Overview

In the Cloud Providers section, you can configure the services to be used in XCALLY, primarily to implement quality analysis and bot functionalities.

For example, you can create a new Cloud Provider account to transcribe voice recordings (such as customer calls stored in the Recordings section). Once transcribed into text, the system can analyze the content of the call to detect the sentiment of the conversation.

Manually listening to recorded calls to evaluate your business performance and customer satisfaction can be time-consuming and inefficient. For this reason you can use Quality Analysis tools:

  • transcribing the call recording may help you determine the topics that customers are calling about

  • detecting the sentiment of the conversation (if the call is a compliment or a complaint, that is returning an array of scores to estimate the probability that the input text is positive, negative, neutral, or mixed) can help you implement corrective measures to solve the problem.

On these links you can find the full documentation of Quality Analisys on XCALLY New Experience with OpenAI or AWS.

Cloud Providers Section

This guide describes the configuration using the XCALLY New Experience, available for this section from XCALLY version 3.49.0. We recommend using the New Experience web interface to take full advantage of the latest features.

Under Tools → Cloud Providers section you can find the list of created cloud providers:

image-20250331-064327.png

 You can:

  • search for a specific cloud provider

  • clear all filters

  • manage columns, by selecting or not them

  • activate the advanced search for each field

By clicking on the three dots button next to a created cloud provider, you can edit or delete it. By choosing edit, you can change the related API Key, copy it or view it (clicking on eye icon).

image-20250331-064618.png

Create Cloud Providers

To create a new cloud provider:

image-20250331-064448.png
  1. Click the Add button

  2. Indicate the relative name and select the service (among AmazonAWS, Microsoft Azure, OpenAI, Deepseek and Google)

  3. Fill the required data, according to the provider you selected

  4. Click Add to confirm

Amazon AWS

Requirements

To configure a new cloud provider based on Amazon AWS, you need a valid Amazon AWS Account.

In this way you can run:

  • Amazon Transcribe to transform call recordings from audio to text

  • Amazon Comprehend to run analysis on the transcripts (text analysis, key phrases and sentiment)

You also need to configure an S3 bucket (see how to Create your first S3 bucket), making sure to select the appropriate AWS Region.


For Transcribe and other Quality Analysis features to work properly, ensure that under the Permissions tab, in the Grantees section, you have write access to both Object and Bucket ACLs.

Before using the system, please configure in the General Settings - Quality Analysis the Amazon storage (the nearest Bucket for your geographical region) where data will be saved, the Accounts to be used for both services and the language to be used (only one language per service can be chosen) when you run transcribe and sentiment analysis.

Moreover, we recommend to enable these permissions for the AWS user:

image-20241105-153226.png

To create a new account, click the Add button and insert the information:

image-20250417-100812.png

 

  • Name: a name chosen by you

  • Service: AmazonAWS

  • Specific Service Parameters that you can retrieve in your AmazonAWS account:

    • Access Key ID

    • Secret Access Key

 

Microsoft Azure

To create a new account, click the Add button and check this page to find out how to configure it.

image-20250417-101942.png

 

 

OpenAI

Requirements

An OpenAI paid account is required.

To create a new account, click the Add button and insert the information:

image-20250417-092916.png
  • Name: choose a name for this account

  • Service: OpenAI

  • API Key: Insert the API Key retrieved on your OpenAI account

If you need to retrieve your API Key on OpenAI follow these steps:

  1. You have to login to your profile and select User API keys

image-20240703-121328.png
Consider that OpenAI has deprecated the API Key system by now using a system of project-based API Keys
  1. Create new secret key, by choosing a name and you can select All or restricted permissions

image-20240722-093049.png

If you choose restricted, remember to give these permissions to use correctly OpenAI model and configure assistant:

  • Models read

  • Model capabilities write

  • Assistants write

  • Threads write

  • Fine-tuning none

  • Files write

  1. You need to copy the created key before closing the window because when you click on Done it will not be visible anymore. Then you can paste it on relative account section on XCALLY Cloud Provider configuration.

Google

To create a new account, click the Add button and insert the information:

image-20250417-102209.png
  • Name: choose a name for this account

  • Service: Google

  • API Key: Insert the API Key retrieved on your Google account. Discover how on next paragraph

If you want to configure Google TTS/ASR/Google Dialogflow in your Cally Square project, you need to generate and retrieve Key on Google Cloud

  • Access to your Google Cloud account

  • Click on your project and select new project, assigning a name

    image (11)-20240523-104035.jpg
    • Then enter in the created project

    • From the menu on the left, select APIs & Services section → Enabled APIs & services

    image (12)-20240523-104603.jpg

     

    • Search from the bar, services you want to enable. For example you can search and activate:

      • Cloud Speech-to-text API (for ASR block)

      • Cloud Text-to-speech API (for TTS block)

    image-20240524-060821.jpg

We recommend to enable on the project all the API services that you consider useful for your needs

By selecting the API, you can then click to Enable

  • From the section below, you will see the list of all activated API services:

image-20240524-073030.png

  • Now you have to create API Keys, which apply to Google modules you have enabled on Google.
    To create them you need to access to APIs & ServicesCredentials

    image (1)-20240524-062722.jpg

     

    image (2)-20240524-063610.jpg

  • The system creates an API key, that can be without restrictions (so available for all services connected to the project) or if you want to enable it for specifc services, you can click on 3 dots menu → Edit API key

image-20240524-065042.png
  • On section API restrictions, you can select Restrict key and select from the list the APIs you want to associate

image-20240524-065328.png
  • Then you can see them in selected APIs:

image-20240524-065452.png
  • Moreover you can change key name (for example to indicate to whom you gave the key or to specify the use of the key).
    And you can set an application restriction on IP addresses (e.g. your public Motion IP) to filter the IPs on which you want to use the key (also for security reasons)

image-20240524-070102.png
  • From editing section or clicking on Show Key, you can copy your API key

image-20240524-065849.png
  • And paste it in input API key of your Google Cloud Provider (used then to configure TTS/TSR blocks)

image-20240524-072312.png

 

Deepseek

Requirements

A DeepSeek paid account is required

 

image-20250512-130428.png

 

To create a new account, click the Add button and insert the information:

  • Name: choose a name for this account

  • Service: DeepSeek

  • API Key: Insert the DeepSeek Key retrieved on your DeepSeek account

  • API base URL: the main address that is used to access the API of the service.