Difference between revisions of "IVRS"

From Karnataka Open Educational Resources
Jump to navigation Jump to search
(Created page with "This page helps anyone to deploy IVRS to send voice SMS from your Kalpavriksha(Ubuntu) machine with a data card. Call charges as per network would apply. Belo...")
 
 
(40 intermediate revisions by 5 users not shown)
Line 1: Line 1:
This page helps anyone to deploy IVRS to send voice SMS from your [[Kalpavriksha|Kalpavriksha(Ubuntu)]] machine with a data card. Call charges as per network would apply. Below instructions were modified from [http://mojolab.org/archives/50 Mojolab] site where this was used to install [https://github.com/ccidmysore/swara Swar]a software. This was tested on [[Kalpavriksha|Kalpavriksha(Ubuntu)]] with Huwawei E173 and is currently used in [[GHS Dommaluru | Government High School, Domlur]]. An opensource IVRS program called [http://asterisk.org Asterisk] is used to run Swara software.
+
[http://karnatakaeducation.org.in/KOER/index.php/%E0%B2%90_%E0%B2%B5%E0%B2%BF_%E0%B2%86%E0%B2%B0%E0%B3%8D_%E0%B2%8E%E0%B2%B8%E0%B3%8D_%E0%B2%95%E0%B3%88%E0%B2%AA%E0%B2%BF%E0%B2%A1%E0%B2%BF ಕನ್ನಡದಲ್ಲಿ ನೋಡಿ]
 +
==About==
  
Make sure each step below is successful without errors:
+
IVRS(Interactive Voice Response System) is commonly used platform to reach people connected through mobile/telephones. This page is about how one can set it up and send Voice SMS at any place with minimal requirements.
--------------------------------------------------------------------------
+
In the school context we can us this software to communicate with parents easily. Most of our school parents are not capable to read sms or letters. from IVRS software we can reach all parents even if they are using basic mobile phones. From IVRS, schools can reach all parents easily by sending voice call. teachers can record their voice message and then send it through IVRS to parents mobile numbers. Same time parents will receive the call and they will hear their recorded message.
  
Step 1: Install ssh, lamp and other required packages
+
== Installation and Deployment==
sudo apt-get install openssh-client openssh-server
+
This page helps anyone to deploy IVRS to send voice SMS from your [[Kalpavriksha|Kalpavriksha(Ubuntu)]] machine with a data card. Call charges as per network would apply. Below instructions were modified from [http://mojolab.org/archives/50 Mojolab] site where this was used to install [https://github.com/ccidmysore/swara Swara] software. This was tested on [[Kalpavriksha|Kalpavriksha(Ubuntu)]] with Huwawei E173 and is currently used in [[GHS Dommaluru | Government High School, Domlur]]. An opensource IVRS program called [http://asterisk.org Asterisk] is used to run Swara software.<br>
sudo apt-get install tasksel
 
sudo tasksel install lamp-server
 
sudo apt-get install ncurses-dev libxml2-dev g++
 
sudo apt-get install lame mysql-server wget gcc g++ bison zlib1g zlib-bin openssl php5-mysql php5 apache2 python-mysqldb
 
  
Step 2: Enter superuser mode and run below commands to install python packages required for asterisk.
+
'''Please[http://karnatakaeducation.org.in/KOER/en/index.php/IVRS_Installation Click here]''' to know detailed installation steps. <br>
su -
 
<Enter your password>
 
apt-get install python-setuptools
 
easy_install MySQL-Python
 
easy_install tweepy
 
easy_install oauth2
 
easy_install stopwatch
 
easy_install simplejson
 
  
Step 3: Disabling your firewall
+
--------------------------------------------------------------------
sudo ufw disable
+
Please enter the given commands in terminal without any mistakes. After Installation completes please download '''VoiceBlast''' application from website. save this VoiceBlast file in '''Downloads''' folder on your computer. While processing with IVRS, we need to save our recorded audios and phone number list only in the folder.
  
 +
=Contexts=
 +
==Parents Teachers Meetings==
 +
When schools are planning to have parent-teacher meeting at school to dicsuss strudents learning progress, attendance and ther issues, school can use IVRS to invite parents to this meeting. school can request parents through IVRS voice call to participate in Parent-Teacher meeting.<br>
 +
Examples:
 +
#[https://soundcloud.com/gurumurthy-kasinathan/call-to-parents-to-attend-meeting-ejipura Ejipura IVRS Message to 8&9 students parents]
 +
#[https://soundcloud.com/gurumurthy-kasinathan/call-to-10th-parents-to-attend-meeting-ejipura Ejipura IVRS Message to 10th students parents]
 +
#[https://soundcloud.com/gurumurthy-kasinathan/tankgarden-school-ivrs-clip-call-for-parents-meeting-1 Tank Garden school IVRS Message to parents]
 +
#[https://soundcloud.com/gurumurthy-kasinathan/call-to-parents-to-attend-meeting-agara Agara school IVRS message to parents]
 +
#[https://soundcloud.com/gurumurthy-kasinathan/bagrahara-school-audio-on-parents-meeting-call B.Agarahara School IVRS message to parents]
  
Step 4: Installing asterisk. Note install only this version of asterisk in this way only. Go to http://downloads.asterisk.org/pub/telephony/asterisk/old-releases/  link and download '''asterisk-1.6.2.23.tar.gz''' file. Run below commands to install it
+
==School Level Programmes==
cd /usr/src
+
Same like parent-teacher meeting school can also communicate parents about school level programmes like National festival celebration, Cultural activities, community meetings, anniversary programmes etc. It will encourage parents to attend school programmes.<br>
sudo tar zxvf ~/Downloads/asterisk-1.6.2.23.tar.gz
+
Example:
sudo apt-get install ncurses-dev libxml2-dev g++
+
#[https://soundcloud.com/gurumurthy-kasinathan/audugodi-call-to-parents-about-kudremukha-programme2 Adugodi school IVRS message to parents to attend school programme]
cd asterisk-1.6.2.23
 
sudo ./configure
 
sudo make clean
 
sudo make
 
sudo make install
 
sudo make samples
 
  
Step 5: Create new database for swara in mysql
+
==Special Classes in School==
/usr/bin/mysql_secure_installation (Answer yes to every question, set a new password for the root user)
+
In schools, for 10th students there will be regular special classess now. and its important to inform parents about special class timings. So that they will be aware about their children and it will help parents to send their children on early hours to school. Same information can send through IVRS voice calls to parents.<br>
mysql -u root -p
+
Example:
mysql>create database swara;
+
#[https://soundcloud.com/gurumurthy-kasinathan/yediyuru-call-to-parenst-abour-special-class Yediyuru school IVRS message to parents]
mysql>exit
 
  
Step 6: Enter superuser mode and run below commands to install and setup Swara
+
==Progress Card==
wget https://github.com/ccidmysore/swara/tarball/developers
+
School intention is to send progress card to home is to  make parents awarded about their children progress. Most of the time students will not show their Progress card to parents and they will make parents signature instead of parents. In this context school can send a voice call through IVRS to inform about progress card issued and request them to see the progress and to make signature.and also school can request parents to meet class teachers if students progress is not good.
mv developers /opt/swara.tgz
 
cd /opt
 
tar xvzf swara.tgz
 
mv ccidmysore-swara-1cc734f swara
 
cd /var/www/
 
ln -s /opt/swara/web /var/www/swara
 
  
Step 7: Set up symlinks and Asterisk configurations
+
==Irregular and Slow learn Students==
 +
If students are not attending classes regularly, most of the time parents may not aware about it. If school inform parents about their children absence, then parents can enquire and observe their children. and also school can make communication to parents about their children poor learning progress. and here school can insist parents to focus on their children reading at home. School can make list of Irregular and Slow learn Students and can send voice calls to those parents through IVRS.
  
ln -s /opt/swara/web /var/www/html
+
For Example:
<create folder name as asterisk in /usr/share>
+
#[https://soundcloud.com/gurumurthy-kasinathan/ejipura-school-ivrs-call-to-parents Ejipura school IVRS message to parents] <br>
ln -s /opt/swara/bin /usr/share/asterisk/agi-bin
+
#[https://soundcloud.com/gurumurthy-kasinathan/sets/tcol-schools-ivrs-audio-clips Wilson Garden school IVRS message to parents]
ln -s /opt/swara/bin /usr/share/asterisk/sounds
+
#[https://soundcloud.com/gurumurthy-kasinathan/beguru-school-ivrs-audio-about-irregular-students-iformatiion Beguru school IVRS message to parents]
cp /opt/swara/conf/extensions.conf /opt/swara/conf/sip.conf /etc/asterisk
 
cd /usr/share/asterisk
 
mkdir orig && mv sounds agi-bin orig/
 
ln -s /opt/swara/bin agi-bin && ln -s /opt/swara/sounds sounds
 
cd /opt/swara/conf
 
<Edit swara.conf and put in your database password>
 
sudo gedit swara.conf
 
cp swara.conf /etc
 
cp extensions.conf /etc/asterisk
 
cp sip.conf /etc/asterisk
 
mysql -u root -p swara < swaradb.sql
 
cd /opt/swara/web
 
mkdir /opt/swara/sounds/web && ln -s /opt/swara/sounds/web audio
 
ln -s /opt/swara/sounds/web upload
 
chmod a+rwx -R /opt/swara
 
touch /var/log/swara.log
 
chmod a+rwx -R /var/log/swara.log
 
  
Step 8: Download and install chan_dongle-1.1.r14.tgz from https://code.google.com/archive/p/asterisk-chan-dongle/downloads
+
==To make reading at home==
cd ~/Downloads
+
It will help students learning if parents are aware about their children education. They should always encourage children to engage in reading and writing at home. school can request parents to focus on their children reading /writing activities at home.
tar -xvf chan_dongle-1.1.r14.tgz
 
cd chan_dongle-1.1.r14
 
sudo ./configure
 
sudo make
 
sudo make install
 
  
Step 9: Setup chan dongle with Asterisk:
+
For Example 
cd ~/Downloads/chan_dongle-1.1.r14/etc/
+
#[https://soundcloud.com/gurumurthy-kasinathan/dommaluru-ivrs-call-to-parents-to-prepare-their-child-to-exam Dommaluru school IVRS message-1 to parents]
<Copy the dongle.conf file to /etc/asterisk/>
+
#[https://soundcloud.com/gurumurthy-kasinathan/dommaluru-hm-call-to-parents-to-make-child-reading-at-home Dommaluru school IVRS message-2 to parents]
sudo cp ~/Downloads/chan_dongle-1.1.r14/etc/dongle.conf /etc/asterisk/
+
#[https://soundcloud.com/gurumurthy-kasinathan/hombegowdabhs Hombegowda high school IVRS message to parents]
<Open the file /etc/asterisk/dongle.conf and set the IMEI setting with the IMEI number of the dongle>
+
#[https://soundcloud.com/gurumurthy-kasinathan/vijaya-high-school-ivrs-message-1-to-parents Vijaya high school IVRS message-1 to parents]
sudo gedit /etc/asterisk/dongle.conf
+
#[https://soundcloud.com/gurumurthy-kasinathan/vijaya-high-school-ivrs-message-2-to-parents-about-special-classes Vijaya high school IVRS message-2 to parents about special classes]
<Save and close the dongle.conf file after adding IMEI number of the dongle>
+
#[https://soundcloud.com/gurumurthy-kasinathan/mes-hm MES high school IVRS message to parents]
+
#[https://soundcloud.com/gurumurthy-kasinathan/gangamma-hombegowda-girls-high-school-ivrs-message-2-to-parents-about-special-classes Gangamma Hombegowda girls high school IVRS message to parents]
 +
 
 +
==School Admission==
 +
Schools may have several activities to increase school strength. One of the best idea is, they can contact nearby HPS schools and can get final class students database with parents contact numbers. By collecting parents contact numbers school can send voice calls to those parents and explaining about the facilities available in the school and can request them to admit their child to this our school. 
 +
 
 +
Example:
 +
# [https://soundcloud.com/gurumurthy-kasinathan/dommaluru-ivrs-call-to-hps-parents-for-admission Dommaluru School IVRS message to HPS Parents].
  
Step 10: Setup Asterisk and swara to make calls:
+
==Other Contexts==
<Open the file "/etc/asterisk/dongle.conf" and set the values for Context as "from-sip" and exten as "swara-local">
+
#School Level Programmes
sudo gedit /etc/asterisk/dongle.conf
+
#Community Programmes
<Save and close the dongle.conf file
+
#Health Camps
+
#School Trips
 +
#Scholarship Distribution
 +
#Exam Time Table anouncement
 +
#School Holiday delcaration
 +
#Sports activities
 +
etc
  
Step 11: Download and extract folders from http://karnatakaeducation.org.in/swarabinFiles.zip to /opt/swara/
+
=Preparation to use IVRS=
cd ~/Downloads
+
#Need to arrange a data card for school.Generally data cards has been used for internet purpose, but for IVRS we need to have voice call option with outgoing call facility. Internet is required only for IVRS installation and its not essential to run IVRS.  
wget http://karnatakaeducation.org.in/swarabinFiles.zip
+
#Before sending voice calls, we need to think about message and context. its better to script the message.
unzip swarabinFiles.zip
+
#Scripted message can be recorded by using below steps:
cd swarabinFiles/
+
##We can make voice record by desktop computers. but here head set/mike is compulsory to record. because desktop computers will not have direct input option. in Ubuntu computers we will use '''Audacity''' to record.
sudo cp -r bin/ /opt/swara/
+
##Through laptops also we can record the voice, here we directly use the ubuntu technology "Audacity" to record the voice.To have good voice recording we must use mike or headsets.   
sudo cp -r conf/ /opt/swara/
 
  sudo cp -r lib/ /opt/swara/
 
sudo cp -r tools/ /opt/swara/
 
  
 +
==Methods of recording on a computer or laptop==
 +
Be prepare with script and then record it in computer.  To record we can use '''Audacity''' application in UBUNTU,  to open audacity in your computer / laptop  go to Application – Sound and Video – Audacity.  then in that by pressing the record ('''red button''') button you can start recording process. To save your recording go to  FILE and then click on Export.  Here while saving File Format must be .wav format. also select VoiceBlast folder from Downloads to keep this recording clip. And then click on Export, it will save in your computer. 
 +
 +
NOTE : While recording the voice in Audacity the frequency must be set to  8000GHz . see the picture 1<br>
 +
And Audio input channel should 1.Mono input channel, to set this please go to menu bar and click on sterio drop down option, see the picture 2<br>
 +
1. [[File:Audacity 2.png|200px]]       
 +
2. [[File:Audacity1.png|400px]]
  
Step 12: Setup Asterisk to use swara configs
+
==Methods of recording on mobile==
  <Edit /etc/asterisk/extension.conf>
+
Be prepare with script and then record it in by your mobile phone. Normally in all android sets you will have Voice Recording option and you can use different applications also. In that “Tape-a-talk” application is most popular one and you can download this from your android playstore.
  sudo gedit /etc/asterisk/extension.conf
+
In your mobile you can do Voice Recording by opening the application in silent area. Later you can transfer this recorded voice to computer. In computer through Audacity you can make changes to your recorded voice and you can save in .wav format and keep that in your computer or laptop in Downloads folder , in that VoiceBlast folder. <br>
<Under [from-sip], change>
+
NOTE : NOTE : While recording the voice in Audacity the frequency must be set to 8000GHz.
exten => swara-local,n,AGI(menu_system_localized.py)
 
to
 
  exten => swara-local,n,AGI(/opt/swara/bin/menu_system_localized1.py)
 
  <Save and close the file after changing as shown above>
 
  
 +
=Method to send IVRS recorded voice=
 +
#After completing voice recording, you can send recorded voice through IVRS .
 +
#First you have to insert your data card to computer.
 +
# Then go to '''Application''' > '''Office''' > IVRS 1.
 +
Here you will see the running terminal.
 +
#Again go to '''Application''' > '''Office''' > IVRS 2
  
Installation is now completed. Now to run the IVRS and send voice-sms, connect the USB dongle to the USB drive and follow below steps:
+
After this, you will the picture of the window which you are seeing below. here you have to select the recorded voice list option, later select the phone numbers to whom you have to send the recorded voice. you can mention the duration of the recorded voice.It should be minimum of 15 seconds.<br>
----------------------
+
[[File:VoiceBlast.png|400px]]
  
  1. Open the terminal. change to root using the command "su -"
+
next click on '''SEND''' button. later you will see the progress of sending the voice in one of the terminal. in this you can see who all received the call. who have not received and even switched off numbers list also.
2. Now run the command "asterisk -vvvvvvc". This should run without fail and the CLI prompt should come
 
3. On the CLI command prompt run the command "agi set debug on"
 
4. Call to the number and you should hear the IVR prompt
 
5. Stop to this run "core stop gracefully"
 
6. Stop and Restart " core restrat gracefully"
 
7. check Dongle is ready "dongle show devices"
 
  
 
[[Category:Ubuntu]]
 
[[Category:Ubuntu]]

Latest revision as of 12:16, 14 March 2019

ಕನ್ನಡದಲ್ಲಿ ನೋಡಿ

About

IVRS(Interactive Voice Response System) is commonly used platform to reach people connected through mobile/telephones. This page is about how one can set it up and send Voice SMS at any place with minimal requirements. In the school context we can us this software to communicate with parents easily. Most of our school parents are not capable to read sms or letters. from IVRS software we can reach all parents even if they are using basic mobile phones. From IVRS, schools can reach all parents easily by sending voice call. teachers can record their voice message and then send it through IVRS to parents mobile numbers. Same time parents will receive the call and they will hear their recorded message.

Installation and Deployment

This page helps anyone to deploy IVRS to send voice SMS from your Kalpavriksha(Ubuntu) machine with a data card. Call charges as per network would apply. Below instructions were modified from Mojolab site where this was used to install Swara software. This was tested on Kalpavriksha(Ubuntu) with Huwawei E173 and is currently used in Government High School, Domlur. An opensource IVRS program called Asterisk is used to run Swara software.

PleaseClick here to know detailed installation steps.


Please enter the given commands in terminal without any mistakes. After Installation completes please download VoiceBlast application from website. save this VoiceBlast file in Downloads folder on your computer. While processing with IVRS, we need to save our recorded audios and phone number list only in the folder.

Contexts

Parents Teachers Meetings

When schools are planning to have parent-teacher meeting at school to dicsuss strudents learning progress, attendance and ther issues, school can use IVRS to invite parents to this meeting. school can request parents through IVRS voice call to participate in Parent-Teacher meeting.
Examples:

  1. Ejipura IVRS Message to 8&9 students parents
  2. Ejipura IVRS Message to 10th students parents
  3. Tank Garden school IVRS Message to parents
  4. Agara school IVRS message to parents
  5. B.Agarahara School IVRS message to parents

School Level Programmes

Same like parent-teacher meeting school can also communicate parents about school level programmes like National festival celebration, Cultural activities, community meetings, anniversary programmes etc. It will encourage parents to attend school programmes.
Example:

  1. Adugodi school IVRS message to parents to attend school programme

Special Classes in School

In schools, for 10th students there will be regular special classess now. and its important to inform parents about special class timings. So that they will be aware about their children and it will help parents to send their children on early hours to school. Same information can send through IVRS voice calls to parents.
Example:

  1. Yediyuru school IVRS message to parents

Progress Card

School intention is to send progress card to home is to make parents awarded about their children progress. Most of the time students will not show their Progress card to parents and they will make parents signature instead of parents. In this context school can send a voice call through IVRS to inform about progress card issued and request them to see the progress and to make signature.and also school can request parents to meet class teachers if students progress is not good.

Irregular and Slow learn Students

If students are not attending classes regularly, most of the time parents may not aware about it. If school inform parents about their children absence, then parents can enquire and observe their children. and also school can make communication to parents about their children poor learning progress. and here school can insist parents to focus on their children reading at home. School can make list of Irregular and Slow learn Students and can send voice calls to those parents through IVRS.

For Example:

  1. Ejipura school IVRS message to parents
  2. Wilson Garden school IVRS message to parents
  3. Beguru school IVRS message to parents

To make reading at home

It will help students learning if parents are aware about their children education. They should always encourage children to engage in reading and writing at home. school can request parents to focus on their children reading /writing activities at home.

For Example

  1. Dommaluru school IVRS message-1 to parents
  2. Dommaluru school IVRS message-2 to parents
  3. Hombegowda high school IVRS message to parents
  4. Vijaya high school IVRS message-1 to parents
  5. Vijaya high school IVRS message-2 to parents about special classes
  6. MES high school IVRS message to parents
  7. Gangamma Hombegowda girls high school IVRS message to parents

School Admission

Schools may have several activities to increase school strength. One of the best idea is, they can contact nearby HPS schools and can get final class students database with parents contact numbers. By collecting parents contact numbers school can send voice calls to those parents and explaining about the facilities available in the school and can request them to admit their child to this our school.

Example:

  1. Dommaluru School IVRS message to HPS Parents.

Other Contexts

  1. School Level Programmes
  2. Community Programmes
  3. Health Camps
  4. School Trips
  5. Scholarship Distribution
  6. Exam Time Table anouncement
  7. School Holiday delcaration
  8. Sports activities

etc

Preparation to use IVRS

  1. Need to arrange a data card for school.Generally data cards has been used for internet purpose, but for IVRS we need to have voice call option with outgoing call facility. Internet is required only for IVRS installation and its not essential to run IVRS.
  2. Before sending voice calls, we need to think about message and context. its better to script the message.
  3. Scripted message can be recorded by using below steps:
    1. We can make voice record by desktop computers. but here head set/mike is compulsory to record. because desktop computers will not have direct input option. in Ubuntu computers we will use Audacity to record.
    2. Through laptops also we can record the voice, here we directly use the ubuntu technology "Audacity" to record the voice.To have good voice recording we must use mike or headsets.

Methods of recording on a computer or laptop

Be prepare with script and then record it in computer. To record we can use Audacity application in UBUNTU, to open audacity in your computer / laptop go to Application – Sound and Video – Audacity. then in that by pressing the record (red button) button you can start recording process. To save your recording go to FILE and then click on Export. Here while saving File Format must be .wav format. also select VoiceBlast folder from Downloads to keep this recording clip. And then click on Export, it will save in your computer.

NOTE : While recording the voice in Audacity the frequency must be set to 8000GHz . see the picture 1
And Audio input channel should 1.Mono input channel, to set this please go to menu bar and click on sterio drop down option, see the picture 2
1. 200px 2. 400px

Methods of recording on mobile

Be prepare with script and then record it in by your mobile phone. Normally in all android sets you will have Voice Recording option and you can use different applications also. In that “Tape-a-talk” application is most popular one and you can download this from your android playstore. In your mobile you can do Voice Recording by opening the application in silent area. Later you can transfer this recorded voice to computer. In computer through Audacity you can make changes to your recorded voice and you can save in .wav format and keep that in your computer or laptop in Downloads folder , in that VoiceBlast folder.
NOTE : NOTE : While recording the voice in Audacity the frequency must be set to 8000GHz.

Method to send IVRS recorded voice

  1. After completing voice recording, you can send recorded voice through IVRS .
  2. First you have to insert your data card to computer.
  3. Then go to Application > Office > IVRS 1.

Here you will see the running terminal.

  1. Again go to Application > Office > IVRS 2

After this, you will the picture of the window which you are seeing below. here you have to select the recorded voice list option, later select the phone numbers to whom you have to send the recorded voice. you can mention the duration of the recorded voice.It should be minimum of 15 seconds.
VoiceBlast.png

next click on SEND button. later you will see the progress of sending the voice in one of the terminal. in this you can see who all received the call. who have not received and even switched off numbers list also.