Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Image Removed

Image Added
Panel
titleOn this Page:
Table of Contents

XCALLY

MOTION is

MOTION is fully integrated with VIDAOO, a professional Video WEBRTC solution powered by Xenialab, in order to provide the best advanced Web Video experience both on the Customer side and the Agents side.
Please contact our Sales Team in order to get VIDAOO: sales@xcally.com

Explore VIDAOO documentation at this link


What is Vidaoo?

image2020-11-16_17-55-18.pngImage Added
image2020-11-16_17-56-23.pngImage Added

Let's discover how we can outline Vidaoo:

  • is a professional Video Conference WEBRTC solution ( Web Real-Time Communication is a free, open-source project that provides web browsers and mobile applications with real-time communication (RTC) via simple application programming interfaces (APIs).

  • allows you to send chat messages to participants in the video call 

  • is a click-to-Video Cloud Platform for Call Center and Customer Care

  • provides a Unified Meeting Experience platform that brings HD video conferencing, mobility and web meetings together as a Cloud Service

  • extends the collaboration functions for the Organization

  • offers crystal-clear video conversation and high quality screen sharing, anytime and from anywhere, with up to 100 people

  • can be used in order to enhance the Customer Center potentials adding a powerful and customizable Unified Collaboration tool

  • the Customer Contact & Touch Points are available on several devices supporting Web Real-Time Communication* (e.g. Kiosks, Tablets, Smartphones, etc.)

  • can work blended with the Customer Care suite offered by XCALLY Motion (native integration) or any other SIP application (gateway-based integration)

  • provides a full set APIs for Customer’s Applications Integration

  • has been developed using a micro-service model for faster deployments

  • has a microservices-based application architecture on AWS, represented by a collection of small, autonomous and self-contained services which are built to serve a single business functionality/capability

Vidaoo and XCALLY Motion

Vidaoo can work blended with the Customer Care suite offered by XCALLY Motion (native integration) but also with any other SIP application (gateway-based integration).

The main advantages of this integrated solution are the following:

  • Voice Routing (Es. Asterisk Queues) with announcements (Es. AVG Hold time)

  • IVR (Playback, ASR, etc.)

  • Voice Reporting and Analytics

  • Voice Realtime

 

Image Added

Requirements

req-20240104-164920.pngImage Added
Panel
bgColor#FFEBE6

☑️ Vidaoo is available for Windows, Mac, iOS, Android and works with an internet connection

☑️ In order for VIDAOO to properly send the Video Calls to the XCALLY platform it is mandatory to open the VIDAOO public address - TCP port 443 on your XCALLY Machine: 35.180.105.193

☑️ If you use iptables on XCALLY, please ensure you open it: nano/etc/sysconfig/iptables  (for centOS Machines).
For Debian, look at the

iptables rules

iptables rules in the file:/etc/iptables/rules.v4 according with your needs

insert

Insert the following line: -A INPUT -

s 3General Architecture and

s 3.248.184.180 -p tcp -m tcp --dport 443 -j ACCEPT
restart your iptables: service iptables restart

☑️ In order for the Vidaoo service to properly work with your XCALLY MOTION machine, it is mandatory to setup a valid SSL certificate inside your XCALLY motion instance.

The tested as compatible browsers are:

  • Google Chrome (recommended 30+) 
  • Firefox (recommended 27+)


☑️ You need an internet connection - broadband wired or wireless (3G or 4G/LTE), Speakers and a microphone - built-in or USB plug-in or wireless Bluetooth and a webcam or HD webcam if you need to capture picture (built-in or USB plug-in)

☑️ Here you find the Browsers minimum versions on which it has been tested: Chrome: 86.0.4240.183 | Firefox: 81.0.1 |
Edge: 86.0.622.63 | Safari (Mac): 13.1.3. Consider that on Firefox and Safari it is not possible to specify an audio output device other than the default one

☑️ Processor Minimum Single Core 1Ghz or Higher | Recommended Dual Core 2Ghz or Higher (i3/i5/i7 or AMD equivalent)

☑️ RAM 4Gb recommended

Vidaoo Architecture

Vidaoo has a microservices-based application architecture on AWS, which represents a collection of small, autonomous and self-contained services which are built to serve a single business functionality/capability. Compared to monolithic design structures, microservices offer:

  • Improved fault isolation: problems within a microservice can be isolated and solved without affecting the other modules

  • Eliminate vendor or technology lock-in: adding new microservices based on different technologies does not affect the existing ones

  • Ease of understanding: microservices are within anyone's reach

  • Smaller and faster deployments: microservices are more flexible and portable

  • Scalability: microservices can easily scale inside a cloud platform

Image Added

Vidaoo is a solution based on KURENTO - Open Source Software WebRTC media server:

The main advantage of Kurento is its versatility by introducing the concept of a Media Workflow, that allows to define in the code how and where the media flows. 

This allows a WebRTC developer to compose and integrate very important features such as computer vision, real-time media modification and interoperate with RTP (VoIP) services.

  • Kurento can also be configured to function as SFU or MCU (or both) in a single instance

  • Kurento is an Open source WebRTC media server. This supports both audio and video and also offers a set of client APIs which allows the developer to create advanced video applications for WWW and smartphone platforms

  • Kurento Media Server features include group communications, transcoding, recording, mixing, broadcasting and routing of audiovisual flows.

Image Added

General Features

The XCALLY Motion VIDAOO Video Web application architecture is designed to provide:

  1. Smart Video Routing Management to your Customer Care Agents, according to Queue distribution and Skills

  2. Strong security

  3. Easy configuration

Image Removed
Image Added



How it works

There are two scenarios in which the solution VIDAOO can be used:

SCENARIO 1  

The Customers can engage a Video Communication Session with the Agent using a simple Web browser button (on PC, Mobile, Kiosk, etc.), like in the following examples:

Image Removed
Image AddedImage Added

Image Removed

In order to activate the Web browser button, follow these steps: 

  1. Create the Web Browser Button 

    • Activate the web project

    • Check and edit parameters

  2. Authenticate on VIDAOO

  3. Connect XCALLY to VIDAOO

    • Create an OpenChannel Account

    • Associate the Agents to the OpenChannel Account

  4. Track the video call route

    • Create a Webhook automation

    • Notify Agents of incoming video call


Create the Web Browser Button

Activate the web project 

The web button is able to connect the website and VIDAOO using a web project, through the API. In order to create the web button or a more complete contact form with the web button  on the specific website, you need to edit your website code.

  • Download the web project Vidaoo-contact form:

View file
namevidaoo-contactform.zip

height150

The project is based on: 

HTMLImage Removed
  • HTML (HyperText Markup Language)- standard markup language for documents designed to be displayed in a web browser. 

  • Java- high-level, class-based, object-oriented programming language that is designed to have as few implementation dependencies as possible.

  • CSS (Cascading Style Sheets)- style sheet language used for describing the presentation of a document written in a markup language such as HTML.

  • PHP- server side scripting language embedded in HTML, used for programming dynamic web pages

  • Drag the Vidaoo-contact form project into the domain directory (a server host supporting HTML and PHP is needed)


Check and edit parameters

The PHP file is responsible for making the API request. For the purpose of successfully activating and editing the request, check the parameters in the PHP directory. 

  • You have the possibility to edit the Contact Form with the web button, choosing and personalizing the fields shown to the Customer 

Image Removed

Image AddedImage Added

  • You have the possibility to edit the string $data in vidaoo.php, setting various fields of the meeting session

Image Removed
Image Added

For example:

- 'topic' is the topic of the meeting (i.e. MY_WEBSITE), which appears  also in the video call session and in VIDAOO reports.

Image Removed
Image Added
Image Removed
Image Added

- 'metadata' are video call data in JSON format useful for VIDAOO automations. 

Authenticate on VIDAOO

The API links the website to the VIDAOO solution,

 to

 to which we must have access.

 So

 So, you need to authenticate your account VIDAOO on the web project, inserting your API KEY.  

customized permissions
  • customized permissions (i.e. you can create the "Clicktocall" role only to generate and manage meetings) 

Image Removed
Image Added
  • Create a user, associating the customized role (i.e. you can create a user "Clicktocall" dedicated to the web project)

Image Removed
Image Added
  • Generate the token connected to the new user, clicking on the key button and then create the API token

Image Removed
Image Added
  • Copy the token

Image Removed
Image Added
  • Move to the Vidaoo-contact form web project

  • Paste the token in the PHP directory string 'X-APIKEY', aimed at having your authentication done

Image Removed
Image Added

Connect XCALLY to VIDAOO

The Customer can now click a button and generate a video call (VIDAOO Quick Meeting).   

In order to let Agents receive notifications and answer the video call, you have to connect XCALLY to the VIDAOO project: 

  • Create an OpenChannel Account (i.e. Clicktocall Vidaoo)

Image RemovedImage Removed
Image Added
  • Add agents to the new OpenChannel Account to associate specific Agents to VIDAOO account and manage the video call

Track the video call route

Create a Webhook automation

  • From the XCALLY new OpenChannel Account, copy the URL included in the Receive URL section. This URL will be fundamental to create an XCALLY webhook from VIDAOO.

Image Removed

Image AddedImage Added
  • Move to VIDAOO

  • Create an XCALLY webhook automation : When the Customer clicks on the web button, the Agent receives a notification and can join the video call.  

  • Select the condition when: a meeting is created

Image Removed
Image Added
  • Among the Actions, select the XCALLY Webhook 

  • In the field Url, paste the URL included in the Receive URL section of the XCALLY Openchannel Account

  • You can also customize your webhook, according to your needs

Image Removed
Image Added

Notify Agents of incoming video call

  • When the Customer click on the web button,

the Agents belonging
  • the Agents belonging to the VIDAOO OpenChannel Account receive the notification of a video request on

XCALLY Motion Omni Desktop InterfaceImage Removed
  • XCALLY Motion Omni Desktop Interface

Image Added
  • When one of the Agents accepts the interaction, he/she finds the video session link

Image Removed
Image Added
  • After entering the link, the session is established and the VIDAOO meeting starts!


SCENARIO 2

The VIDAOO Session can be activated by the Agent with a Customer during a Chat interaction.  

Clicking

on 

on Start Video Call a web link to join a video call is generated. 

Image Removed
Image Added

  • The VIDAOO link is shown to the Agent (in the interaction form):

Image Removed
Image Added
  • Simultaneously, the Customer receives the VIDAOO link and is invited

to participate
  • to participate:

Image Removed
Image Added

Please note: 

  • The Vidaoo feature is

available only
  • available only if the Administrator has configured the Video option for the specific Chat Website.

  • The number of available sessions set for your Account on Vidaoo must not be exceeded. 


Video call Overview 

When entering the VIDAOO meeting following Scenario 1 or Scenario 2, the video call can be managed in a

very simple

very simple and intuitive way. 
Below, a brief overview of the video call is presented. Click here for further reading. 

CUSTOMERImage Removed

Image Added


The Customer can use the buttons on the screen in order to:

Image Removed
Image Added

disable/enable Video

Image Removed
Image Added

disable/enable Audio

Image Removed
Image Added

switch to full-screen

many more custom buttons can be displayed!

              

At the end of the conversation, the customer can press Image Modified to leave leave or end the video meeting.


 AGENTImage Removed

Image Added


The Agent can use the buttons on the screen in order to:

Image Removed
Image Added

disable/enable Video

Image Removed
Image Added

disable/enable Audio

Image Removed
Image Added

switch to full-screen

Image Removed
Image Added

enable/disable screen sharing

Image Removed
Image Added

Start/Stop recording the video

Image Removed
Image Added

Snap a picture from the video 

many more custom buttons can be displayed!

At the end of the conversation, the Agent can press Image Modified to leave leave or end the video meeting.

VIDAOO for Administrators, Users and Developers

Explore VIDAOO documentation: