eva-library / channel-asterisk

This project explains the integration of eva with Asterisk and Verbio.

Integration eva Asterisk-Verbio

The following document details the integration of eva with Asterisk and Verbio. Before starting we must have the following:

Pre-requisites

• Google Cloud - Google Cloud Platform account.
• Asterisk - Download image(iso) of Asterisk (Recommended version 16+).
• Verbio - Purchase a Verbio license.
• Buydidnumber - Purchase a telephone number.

Installation Asterisk

The first thing we must do is go to the Google Cloud console.

Compute Engine > VM Instaces

And Create Instance.

Minimum requirements
SO	Ubuntu 18+
Machine type	custom (1 vCPU, 7.5 GB memory)
Size	30 GB
Disc	SSD persistent disk
Mode Boot disc	Boot, read/write
After created, we will have something similar to this, and by SSH we enter our instance.


Install dependencies:

sudo apt-get install build-essential wget libssl-dev libncurses5-dev libnewt-dev libxml2-dev linux-headers-$(uname -r) libsqlite3-dev uuid-dev git subversion

Enter the folder:

cd /usr/src/

Download the latest available version of Asterisk. For example:

sudo wget http://downloads.asterisk.org/pub/telephony/asterisk/asterisk-17-current.tar.gz

Unzip the downloaded package

sudo tar -xvzf asterisk-17-current.tar.gz

Install additional dependencies available in the installation script that comes with the downloaded Asterisk package

cd /usr/src/asterisk-16.6.1/contrib/scripts
sudo ./install_prereq install

Return to the base folder

cd /usr/src/asterisk-17.1.1/

Execute the following steps to install

sudo ./configure
sudo make menuselect             
sudo make
sudo make install
sudo make samples               
sudo make config
sudo ldconfig

Activate a User in Ubuntu to run the Service.

sudo groupadd asterisk
sudo useradd -d /var/lib/asterisk -g asterisk asterisk

Execute the following instructions to update the "group" and the "user" for the execution of the Asterisk service in the configuration files ...

sudo sed -i 's/#AST_USER="asterisk"/AST_USER="asterisk"/g' /etc/default/asterisk
sudo sed -i 's/#AST_GROUP="asterisk"/AST_GROUP="asterisk"/g' /etc/default/asterisk
sudo sed -i 's/;runuser = asterisk/runuser = asterisk/g' /etc/asterisk/asterisk.conf
sudo sed -i 's/;rungroup = asterisk/rungroup = asterisk/g' /etc/asterisk/asterisk.conf
sudo chown -R asterisk:asterisk /var/spool/asterisk /var/run/asterisk /etc/asterisk /var/{lib,log,spool}/asterisk /usr/lib/asterisk

Restart Ubuntu to verify that the Asterisk Service starts correctly.

sudo reboot

Verify the execution of the Asterisk Service.

sudo asterisk -vvvvrc

Expected output:

Integration Verbio

Integration with verbio is the provider's own and it is they who must provide the respective documentation.

Integration eva Asterisk+Verbio

extesions.conf: This file is the one that provides the connection between eva's broker and asterisk. The path is:

cd /etc/asterisk/extensions.conf

It is enough to configure these 2 files to achieve a correct connection between Asterisk and eva.

eva.agi: Allows you to connect a bot with a phone number. The path is:

cd /var/lib/asterisk/agi-bin

HELP

Here are some Asterisk commands that will help you to better understand and configure your VM.

Enter the Asterisk VM:

$ sudo asterisk -vvvvvvvvvvvvvvr

In some cases, trying to log in sends the following error message: Unable to connect to remote asterisk (does /var/run/asterisk/asterisk.ctl exist?) So the following command will be executed:

sudo asterisk -&

Restart VM Asterisk: After modifying any configuration file we must restart the Asterisk VM, for which we execute the following commands:

$ sudo /etc/init.d/asterisk restart 
$ sudo asterisk -vvvvvvvvvvvvvvr
$ dialplan reload

To review the apps that are installed.

$ sudo asterisk -vvvvvvvvvvvvvvr 
$ core show applications

The most important files to configure are:

File	Path	Description
eva.agi	/var/lib/asterisk/agi-bin/eva.agi	where we can connect our bot and associate it with a phone number.
verbio.conf	/etc/asterisk/verbio.conf	Contains the configuration properties of verbio.
extensions.conf	/etc/asterisk/extensions.conf	All eva connector setup with Asterisk and Verbio
dtmb.bnf	/var/lib/asterisk/agi-bin/dtmb.bnf	Contains the verb grammar settings. The path of that file must also be entered in the extensions.conf file

Other Important Paths to Check Within Asterisk

• astetcdir => /etc/asterisk
• astmoddir => /usr/lib/asterisk/modules
• astvarlibdir => /var/lib/asterisk
• astdbdir => /var/lib/asterisk
• astkeydir => /var/lib/asterisk
• astdatadir => /var/lib/asterisk
• astagidir => /var/lib/asterisk/agi-bin
• astspooldir => /var/spool/asterisk
• astrundir => /var/run/asterisk
• astlogdir => /var/log/asterisk
• astsbindir => /usr/sbin

Thanks!

eva professional services

*Components are not supported