editor
698
edits
This is the support site for Andrews & Arnold Ltd, a UK Internet provider. Information on these pages is generally for our customers but may be useful to others, enjoy!
(clean up, typos fixed: a extension → an extension) |
|||
(23 intermediate revisions by one other user not shown) | |||
The FireBrick supports call recording by teeing off the two way audio from a call leg and sending to a SIP endpoint. The SIP endpoint will then record the call and handle it in any way you wish.
There are two elements to the A&A/FireBrick call recording software:
* a C application, ''voip-
* a python script
==Setting up ''voip-
The ''voip-
1.) the Makefile is dependent on deps/siptools.c. If you do not have access to the A&A svn, you'll need to:
a.) comment out the following lines in the Makefile:
b.) make sure that you have siptools.c in dep/
2.) depending on your version of voip-answer.c, you may need to set the email address parameter (i.e. the ''from'' address). Change line 803 from:
to whatever email address you want to the recordings to be sent from. (%c is the unique ID of the call recording)
(As of 9 August 2018, this has been replaced in voip-answer.c with "sip:%s%.*s", so no modification is necessary.)
3.) By default, the (temporary) path for the recordings is /tmp/. If you want to change this, amend line 62:
Once you have configured the script to your preferences, install it by running ''make''.
(If you do not have it installed already, you might need to install libpopt-dev.)
* ''dump'' / ''V'': outputs a packet dump
So, for example, if you wanted to run ''voip-
If you want to run it as a background process (which you probably do...), append an ampersand:
./voip-answer -r /voipuser/voip-answer/python/voip-rec-email/voip_rec_email.py -d /voipuser/voip-answer/sounds/ &
=Using the A&A / FireBrick call recording software for announcements (e.g. out of hours announcement)=
As well as acting as a SIP endpoint for recording calls, ''voip-
== Creating the announcement / playback files ==
* .wav
* A-LAW
*
* mono only
You can easily use Audacity to create suitable files; just remember to set the sample rate to
If, when you play the files back through ''voip-
If you have a recording at a different sample rate, using Audacity, change the project's sample rate to 8000, then change the recording's sample rate to 8000, and then use the "Change Speed" effect on the recording — if the original rate was 44100 Hz, apply a speed multiple of 5.50.
== Hosting the announcement / playback files ==▼
Files to be played back can be put in any directory readable by ''voip-
You send traffic to the announcement / playback files by configuring a new extension on the FireBrick, and giving it a SIP URI containing the relevant parameters.
The parameters you can choose from are:
=== Prefixes (in this order) ===
XXX= This call is not to be answered, but call progress. XXX is final status
= This call is not to be answered, but call progress. End with constant ringing
- Add a ring, may be repeated
! Add a SIT, may be repeated
N* The playback sequence is to be repeated N times
You can download aai.wav and sit.wav [https://support.aa.net.uk/images/9/98/Firebrick_tones.zip here].
=== Filenames ===
Following the prefix are dot separated filenames, assumed to be wav files, to play.
A filename can have a ? after it followed by another filename. This skips the second file if the first exists.
Each dot is also a small time delay, so several dots can be used for a pause.
=== Suffixes, one applies ===
=filename Record to file
* Silence
# Refer to #
So if you wanted two rings, followed by playback of a file called "onholiday.wav", you would specify the following SIP URI:
''--onholiday@hostname/address''
=Pre-call announcements (e.g. "this call will be recorded")=
You can combine these features with the REFER function ("#"), to create an extension which will first play back an announcement (such as "This call will be recorded"), before referring the call to your chosen destination.
▲If, when you play the files back through ''voip-record'', they sound distorted, chances are you have either got the sample rate wrong, or else accidentally recorded them in stereo.
You do not need to do anything with the voip-answer.c script (other than make sure your chosen recordings are in the right place).
▲== Hosting the announcement / playback files==
Configure your FireBrick:
▲Files to be played back can be put in any directory readable by ''voip-record''. You tell it which directory to look in by using the ''directory'' or ''-d'' switch. For example:
# As at 10 August 2018, make sure you have alphas enabled, and have at least alpha V1.48.123
▲''./voip-answer -d /voipuser/voip-answer/sounds/''
# Create a new telephone extension (or amend an existing one)
# Give it the username "Voicemail" and do not give it a password
# Add the URI: <your-pre-call-sound-file>#<extension you want to refer to>@hostname/address
So if you wanted to first play an announcement of called "callsarerecorded.wav", followed by a refer to your extension or hunt group number 500, you would use:
callsarerecorded#500@hostname/address
▲== Trigger the announcement / playback files==
|