cumpsd/asterisk repository overview

⁠Asterisk

This is my Asterisk learning repository.

⁠Goals

• Inter-house calling.
• Receive calls from Weepee.
• Receive calls from Google Hangouts. (page 511)
• Make calls to fixed and mobile lines.
• Show callerid on outgoing calls.
• Make calls to Google Hangouts.
• Provide an automated attendant system (Chapter 15, page 404).
• Provide voicemail.
• Provide voicemail to mail or to web.
• Send SMS.
• Receive SMS.
• Route calls to Mobile.
• Time-based routing. Code-based routing.
• Record calls.
• Call from Web (+ Video?)
• Music on hold (MP3? Spotify⁠?)
• Statistics (# Calls, Minutes, ...)
• Integrate Home API with it to send SMS.
• Fax integration.
• SRV incoming calling, to allow people to SIP call [email protected]⁠
• Integrate Google Services⁠
• Integrate Calendar⁠ (page 500)
• Use high quality sound⁠

⁠Resources

• http://nerdvittles.com/?p=130⁠
• https://github.com/andrius/asterisk⁠
• https://wiki.asterisk.org/wiki/dashboard.action⁠
• https://hibou.io/blog/news-info-1/post/announcing-asterisk-docker-14⁠
• https://help.ubnt.com/hc/en-us/articles/205203180-UniFi-VoIP-Asterisk-SIP-Configuration⁠
• https://community.openhab.org/t/howto-setup-alexa-to-announce-your-incoming-asterisk-calls-using-openhab/50911⁠
• https://github.com/rgrokett/RaspiAsteriskAlexa⁠

⁠IVR Ideas

• Leave a reminder -> Dictate
• Test audio -> Echo
• Test Music -> Stream

⁠Paths

• /etc/asterisk - Config
• /usr/lib/asterisk/modules - Modules, do not map
• /var/lib/asterisk - Resources
• /var/spool/asterisk - Voice messages, call recordings, ...
• /var/log/asterisk - CDRs, logs, ...

⁠GitHub Mapping

• /etc/asterisk -> etc
• /var/lib/asterisk -> lib
• /usr/lib/asterisk -> usrlib

⁠Generating Music on Hold from MP3

sudo apt-get install sox libsox-fmt-all lame

for f in *.mp3
    set rootname (echo $f | sed 's/\.[^.]*$//')
    lame --decode $f $rootname.wav
    sox -v 0.95 -V $rootname.wav -r 8000 -c 1 -t ul $rootname.sln
    sox -v 0.95 -V $rootname.wav -r 8000 -c 1 -t ul $rootname.alaw
    sox -v 0.95 -V $rootname.wav -r 8000 -c 1 -t ul $rootname.g722
    sox -v 0.95 -V $rootname.wav -r 8000 -c 1 -t ul $rootname.g729
    sox -v 0.95 -V $rootname.wav -r 8000 -c 1 -t ul $rootname.gsm
    sox -v 0.95 -V $rootname.wav -r 8000 -c 1 -t ul $rootname.ulaw
end

⁠Commands

• core reload
• module show
• dialplan reload
• tcpdump -i eth0 -s 65535 -w /var/log/asterisk/dump1.trace

⁠Modules

Modules to look at.

⁠Applications

• app_dial

• app_stack

• app_voicemail

• app_authenticate

• app_cdr

• app_channelredirect

• app_chanspy

• app_confbridge

• app_controlplayback

• app_dictate

• app_directed_pickup

• app_directory

• app_disa

• app_echo

• app_exec

• app_fax

• app_festival

• app_followme

• app_originate

• app_playback

• app_read

• app_record

• app_sayunixtime

• app_skel

• app_speech_utils

• app_system

⁠CDR

• cdr_csv
• cdr_syslog

⁠Channel Drivers

• chan_bridge
• chan_sip
• chan_gtalk or chan_motif

⁠Codec Translators

• codec_alaw
• codec_a_mu
• codec_g722
• codec_gsm
• codec_ulaw
• codec_g729 (paid)

⁠Format Interpreters

• format_g723
• format_g726
• format_g729
• format_gsm
• format_h263
• format_h264
• format_jpeg
• format_ogg_vorbis
• format_pcm
• format_sln
• format_vox
• format_wav

⁠Dailplan Functions

• func_aes
• func_audiohookinherit
• func_blacklist
• func_callerid
• func_cdr
• func_channel
• func_curl
• func_cut
• func_devstate
• func_dialgroup
• func_dialplan
• func_enum
• func_env
• func_global
• func_lock
• func_logic
• func_math
• func_md5
• func_presencestate
• func_rand
• func_redirecting
• func_sha1
• func_shell
• func_speex
• func_sprintf
• func_srv
• func_strings
• func_sysinfo
• func_uri
• func_vmcount

⁠PBX Modules

• pbx_config

⁠Timing Interfaces

• res_timing_timerfd

⁠Calendar Integration

• res_calendar
• res_calendar_caldav
• res_calendar_exchange
• res_calendar_icalendar

⁠RTP

• res_rtp_asterisk

⁠Other

• res_agi

• res_crypto

• res_curl

• res_fax

• res_http_post

• res_http_websocket

• res_musiconhold

• format_mp3

⁠Credits

• Example music on hold from OMONOKO - Wild Heart (2019)⁠