1.0.9

• Asterisk manager connection watchdog added (ping action sent every 30 seconds).
• Local channels excluded on Agent level (no local channels events sent to Odoo).
• Added deploy/docker-compose.agent.yml for pulling Agent from docker hub.
• FreePBX videos added to documentation.
• User notification refactored not to send double notifications.
• Channel and call user matching refactoring to handle situations where not exten is sent (queues, ring groups).
• Odoo bus.bus agent channel secured. Now on every connect Agent generates a secret channel token and polls to this channel. Now it's impossible to guess the channel name Agent is listening.
• Save settings bugfix.
• "Remove plus" option added to settings. Now you can configure either send numbers with + or not.
• A dozen of small usability improvements.

1.0.8

• Click2call partner's extension refactored. New field Phone extension added. When You click on Phone extension call button partner's Phone is dialed with Phone extension added to the number. By default one second pause is used before entering extension. To add more delay prefix Phone extension with more #, e.g. ####1001.
• Asterisk AgentCalled event is now handled. So if call is terminated with Queue application queue agents can have calling partner form opened. Don't forget to add agent permission of odoo AMI account.
• Systemd unit fix (deploy/agent/astcalls_agent.service) that is used to make Agent start on boot.
• Now you can keep your numbers in E.164 format .e.g +1234567890. When click2call is used + is removed before sending to Asterisk. Also remove + before calling get_caller_name URL from Asterisk dialplan. You can keep + in partner numbers to let SMS module work.
• Fixed issue with call recording and PJSIP multiple registrations and getting several channels with same uniquid.
• Statistics -> Custom -> Call report fix (Odoo 11 & 12 porting bug fix)

1.0.7

• Ooops with "number translations" - feature removed.
• Multiple odoo databases are supported now by Agent.
• Set caller name fix when multiple partners with same numbers.
• Incoming call notification popup :-P
• Added (really) ability to dial partner's extension setting partner number like 1234567890#101. Every # adds 1 second of pause before sending DTMF digits after the calls is answered.

1.0.6

• Free post-sale asterisk support is not available anymore.
• Nginx service added to docker deploy.
• Call recording refactoring (sending recording on CDR event instead of Hangup).
• Docker deploy refactored (again :-P), now all services are started from one compose file.
• Added call routing controller to allow Asterisk find calling partner's manager extension.
• Added ability to dial internal extensions setting partner number like 1234567890#101.
• Added number transforming and cutting spaces, brakets and dashes. So 1(23)123-23-23 will be correctly dialed.
• Asterisk IP address default False settings bug fix.

1.0.5

• PJSIP support added for click2call (Agent update required).
• Auto answer (Alert-Info SIP header) bug fix.
• Added Auto reload channels setting to handle call overloads.
• res_config_settings now properly inherited.
• FreePBX screenshots in doc fix.

1.0.4

• FreePBX setup screenshots added to the doc.
• Permissions fix (Access denied error if user was not in any asterisk calls group).
• Asterisk calls CRM addon ready.
• Calls history store days parameter added to the settings (old calls are deleted)

1.0.3

• Call history tree view now has a button either to open call's partner or create a new partner for call.
• Partner form click2dial for mobile field added.
• Minor bug fixes.
• Docker deploy moved to Postgres 10.
• Docker deploy added odoo.conf.
• Documentation update with FreePBX examples.

1.0.2

• Bug fixes :-P
• Odoo 12.0 version released!
• Documentation rewrite :-)
• Asterisk Odoo Agent broker script now can be downloaded directly from Odoo site.
• Added Asterisk allowed IP addresses restriction - you can limit potential sources of requests.
• Added ability to query callerid name from Asterisk dialplan using CURL function.
• Web callback features added:
  • Callback order - controls who is dialed first: customer phone or queue.
  • Callback days, attempts and call interval control dialing attempts.
  • Start time of callback - when requesting a callback from IVR menu you can specify callback start time (in Odoo datetime format) so that it will start on work hours.
• Added possibility to request a callback from Asterisk voice menu.
• Web notify addon is automatically downloaded during docker deploy.
• Asterisk example dialplan refactored (CURL example added).
• Systemd startup unit file added in deploy folder.

1.0.1

• Initial release.

Docker compose deploy

There is a deploy folder in the application package that contains docker-compose style installation. The deploy folder contains 3 directories:

• agent (a middleware between Odoo and Asterisk, you already have Odoo and Asterisk you may want to run only a docker based Agent installation).
• odoo (installation of Odoo and PostgreSQL, if you already have Asterisk running then you may want to run docker based Odoo and Agent.
• asterisk (If you want a complete all-in-one suite run all components).

To customize your installation use docker-compose.override.yml to set your custom values.

Odoo

Install asterisk_calls Odoo module in usual way. Do a database backup before installation (just in case :-P).

[options]
workers = 2
longpolling_port = 8072

astcall_odoo | 2018-09-10 15:37:58,920 18 INFO ? odoo.service.server: Evented Service (longpolling) running on 0.0.0.0:8072

__init__() got an unexpected keyword argument 'server_hostname'

Asterisk

You need is to allow Agent to connect to your Asterisk server AMI port (usually 5038). This app does not use asterisk database connection to Odoo.

You need to cut leading + on numbers incoming from trunks before passing it to get_caller_name.

Here are the examples of required configuration options.

cdr.conf:

[general]
enable=yes
unanswered = yes
congestion = yes

cdr_manager.conf:

[general]
enabled = yes

[mappings]
start => started
answer => answered
end => ended
linkedid => linkedid
sequence => sequence

manager.conf:

[general]
enabled = yes
webenabled = no # Asterisk calls does not use HTTP interface
port = 5038 # You can put any port here but adjust MANAGER_PORT variable for Agent.
bindaddr = 0.0.0.0 # You can put your IP here and set ASTERISK_HOST variable for Agent.

[odoo] # Adjust also MANAGER_LOGIN for Agent
secret=odoo # Adjust also MANAGER_PASSWORD for Agent
displayconnects = yes
read=call,dialplan,cdr
write=call,originate
deny=0.0.0.0/0.0.0.0
permit=127.0.0.1

Important! For security reasons always use deny/permit options in your manager.conf. Change permit option to IP address of your Asterisk server if agent is not started on the same box.

 ; Call from DID numbers e.g. PSTN numbers connected to Asterisk box.
[test-incoming]
exten => _X.,1,Set(CURLOPT(conntimeout)=3)
exten => _X.,n,Set(CURLOPT(dnstimeout)=3)
exten => _X.,n,Set(CURLOPT(httptimeout)=3)
exten => _X.,n,Set(CURLOPT(ssl_verifypeer)=0)
; Record call
exten => _X.,n,MixMonitor(${UNIQUEID}.wav)
; Get caller ID name from Odoo
exten => _X.,n,Set(CALLERID(name)=${CURL(http://odoo:8072/asterisk_calls/get_caller_name?number=${CALLERID(number)})})

; Get partner's manager channel if set.
exten => _X.,n,Set(manager_channel=${CURL(http://odoo:8072/asterisk_calls/get_partner_manager?number=${CALLERID(number)})})
exten => _X.,n,ExecIf($["${manager_channel}" != ""]?Dial(${manager_channel}/${EXTEN},60,t))
;
exten => _X.,n,Answer
exten => _X.,n,Playback(demo-thanks)
exten => _X.,n,Queue(sales)

[post-dial-send-dtmf]
exten => s,1,NoOp(DTMF digits: ${dtmf_digits})
same => n,ExecIf($["${dtmf_digits}" = ""]?Return)
same => n,Wait(${dtmf_delay})
same => n,SendDTMF(${dtmf_digits})
same => n,Return

[test-users]
exten => _X.,1,MixMonitor(${UNIQUEID}.wav)
; Local users pattern
exten => _XXXX,2,Dial(SIP/${EXTEN},30,TU(post-dial-send-dtmf))
; Outgoing calls pattern
exten => _XXXXX.,2,Dial(SIP/provider/${EXTEN},30,TU(post-dial-send-dtmf))

FreePBX setup

Setup and configuration videos are available here.

Configure custom dialplans

Set custom context for trunks

Set custom context for users

Agent

The Agent connects to Asterisk Manager Interface (AMI) and listen for events like Newchannel, Cdr, Hangup, etc. These events are sent to Odoo using odoorpc library.

Agent can be run in any place. But the prefereable one is the same server where Asterisk is installed. In this case Agent can have access to call recording files and can forward them to Odoo. This is the only difference from other cases like running Agent on the Odoo server or as a docker service (set RECORDING_UPLOAD_ENABLED=0 environment variable to disable call recording uploads).

Installation steps:

• Download Agent package from Odoo Asterisk Calls -> Settings -> Download Asterisk Agent green button.
• Copy it to your Asterisk server.
• Install requirements from requirements.txt
• Edit start_agent.sh and adjust configuration variables.
• Run start_agent.sh

To install the required libraries:

cd /agent/
pip install -r requirements.txt

Now you can start_agent.sh:

bash-4.4# DEBUG=1 ./agent.py
2018-09-11 19:35:04,883 - DEBUG - __main__ - Connecting to 127.0.0.1:5038 with odoo:odoo
2018-09-11 19:35:04,890 - INFO - __main__ - Connecting to Odoo at odoo:8069
2018-09-11 19:35:04,893 - DEBUG - __main__ - Notify on start not set
2018-09-11 19:35:04,926 - INFO - __main__ - Managed connected
2018-09-11 19:35:06,220 - INFO - __main__ - Connected to Odoo as asterisk_agent
2018-09-11 19:35:06,221 - DEBUG - __main__ - Starting odoo bus polling at http://odoo:8072/longpolling/poll

To get it up when system starts add this script to the startup scripts of your system.

Set DEBUG=1 to enable debug mode.

Settings

You should visit Asterisk Calls -> Settings and do some configuration.

Web callback

In order to use web callback You have to install Website Builder application.

Odoo 10 requirement: be sure to pass Odoo process worker instance (port 8069) to website site visitors.

Web callback form is accessible at http://localhost:8069/contact_call URL (put your hostname).

Callback from IVR menu

In example below callers getting out of the sales queue have a choice to press 0 and request a WEB callback.

exten => 500,1,Queue(sales,RtC,,,15)
same => n,Background(ask-for-callback)
same => n,WaitExten(3)
same => n,Hangup()

exten => 0,1,Set(foo=${CURL(http://localhost:8072/asterisk_calls/callback?queue=sales&phone=${CALLERID(num)}&exten=500)})
same => n,Playback(thanks-for-callback-order)
same => n,Hangup()

You can also specify a callback time so that call will come on work hours. Here is an example of dialplan:

exten => 500,1,Queue(sales,RtC,,,15)
same => n,Background(ask-for-callback)
same => n,WaitExten(3)
same => n,Hangup()

exten => 0,1,Set(foo=${CURL(http://localhost:8072/asterisk_calls/callback?queue=sales&phone=${CALLERID(num)}&exten=500)})
same => n,Playback(thanks-for-callback-order)
same => n,Hangup()