<a class="reference external image-reference" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.svg"> </a> <a name="log-call"></a> <h2>Log-call</h2> <p>When a call has completed within Asterisk, FreeSWITCH or similar a callback can be added in a hangup handler to call a script which sends a request to Odoo to log the call.</p> <p>This module requires a module providing _get_ucp_url and _get_jitter functions in PhoneCommon. These provide a URL template for downloading recordings (false is fine) and the number of seconds to use to make sure there are no problems in merging call logs, respectively.</p> <p>Merging of call logs is automatic if, and only if, the call existing in the database as a state time between the start of the new call minus jitter and end of the new call plus jitter. It keep the data making the call the longest. It will keep the original attachment, ignoring a new one. It will append the new call description to the old making sure that the old ends with a new line.</p> <a name="installation"></a> <h3>Installation</h3> <p>To install this module, you need to simply click install.</p> <a name="configuration"></a> <h3>Configuration</h3> <p>To configure this module, you need to go to the configuration page for the FreeSWITCH server in question, within Odoo, make sure to edit the ucp_url field to be a url template for call recordings.</p> <p>The following macros are allowed: {odoo_type} (inbound, outbound) {odoo_src} (source phone number} {odoo_dst} (destination number) {odoo_duration} (length of call) {odoo_start} (start time of call in seconds since epoch) {odoo_filename} (file name on server) {odoo_uniqueid} (FreeSWITCH UUID of call)</p> <p>Make sure to set time jitter compensation which is the number of seconds to subtract from new call start and add to new call end, for call merging, to compensate for system/database load and time drift between FreeSWITCH server and Odoo/Odoo database server(s). 5 seconds is likely a good start. Above 10 seconds you get into the realm where you may have distinct calls confused. 20 - 30 seconds begins to guarantee this. It is best to keep this low and use a method to keep time synced.</p> <a name="usage"></a> <h3>Usage</h3> <p>To use this module, you will need to use one of the scripts in logcall/scripts which is appropriate for your server. You will also need Asterisk Logcall, FreeSWITCH Logcall, or something similar to provide ucp_url and server_jitter_compensation. Configure those.</p> <p>Note: the scripts, properly used, will work in most situations. Adjust for your local conditions. Please, contribute useful changes.</p> <p>For users who wish to enable automatic call logging, they will need to set the &quot;Automatically Log Incoming Calls&quot; preference.</p> <p>The user that will be handling to call backs should have &quot;Phone System Integration and Logging&quot; checked. It probably should be the same user you use for caller pop-up and Caller ID notification from other modules in connector-telephony. It should have no other permissions or group memberships besides what is set by those mentioned here.</p> <a name="known-issues-roadmap"></a> <h3>Known issues / Roadmap</h3> <p>None at this time.</p> <a name="bug-tracker"></a> <h3>Bug Tracker</h3> <p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/connector-telephony/issues">GitHub Issues</a>. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us smashing it by providing a detailed and welcomed feedback.</p> <a name="credits"></a> <h3>Credits</h3> <a name="images"></a> <h4>Images</h4> <ul class="simple"> <li>Odoo Community Association: <a class="reference external" href="https://github.com/OCA/maintainer-tools/blob/master/template/module/static/description/icon.svg">Icon</a>.</li> </ul> <a name="contributors"></a> <h4>Contributors</h4> <ul class="simple"> <li>Trever L. Adams &lt;<a class="reference external" href="mailto:trever.adams&#64;gmail.com">trever.adams&#64;gmail.com</a>&gt;</li> <li>Ondřej Kuzník &lt;<a class="reference external" href="mailto:ondrej.kuznik&#64;credativ.co.uk">ondrej.kuznik&#64;credativ.co.uk</a>&gt;</li> </ul> <a name="maintainer"></a> <h4>Maintainer</h4> <a class="reference external image-reference" href="https://odoo-community.org"><img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" /></a> <p>This module is maintained by the OCA.</p> <p>OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.</p> <p>To contribute to this module, please visit <a class="reference external" href="https://odoo-community.org">https://odoo-community.org</a>.</p>