<h1 class="title">Asterisk connector</h1> <p><a class="reference external" href="https://odoo-community.org/page/development-status"><img alt="Beta" src="https://img.shields.io/badge/maturity-Beta-yellow.png" /></a> <a class="reference external" 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.png" /></a> <a class="reference external" href="https://github.com/OCA/connector-telephony/tree/14.0/asterisk_click2dial"><img alt="OCA/connector-telephony" src="https://img.shields.io/badge/github-OCA%2Fconnector--telephony-lightgray.png?logo=github" /></a> <a class="reference external" href="https://translation.odoo-community.org/projects/connector-telephony-14-0/connector-telephony-14-0-asterisk_click2dial"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a> <a class="reference external" href="https://runbot.odoo-community.org/runbot/228/14.0"><img alt="Try me on Runbot" src="https://img.shields.io/badge/runbot-Try%20me-875A7B.png" /></a></p> <p>The technical name of this module is <strong>asterisk_click2dial</strong>, but this module implements much more than a simple <em>click2dial</em> ! This module adds 3 functionalities:</p> <ol class="arabic"> <li><p class="first">It adds a <em>Dial</em> button in the partner form view so that users can directly dial a phone number through Asterisk. This feature is usually known as <em>click2dial</em>. Here is how it works :</p> <ul class="simple"> <li>In Odoo, the user clicks on the <em>Dial</em> button next to a phone number field in the partner form view (or any form view with a phone number).</li> <li>Odoo connects to the Asterisk Manager Interface and Asterisk makes the user's phone ring.</li> <li>The user answers his own phone (if he doesn't, the process stops here).</li> <li>Asterisk dials the phone number found in Odoo in place of the user.</li> <li>If the remote party answers, the user can talk to his correspondent.</li> </ul> </li> <li><p class="first">It adds the ability to show the name of the calling party on the screen of your IP phone on incoming phone calls if the presented phone number is present in the partner/leads/employees/... of Odoo. Here is how it works:</p> <ul class="simple"> <li>On incoming phone calls, the Asterisk dialplan executes an AGI script <strong>set_name_incoming_timeout.sh</strong>.</li> <li>The <em>set_name_incoming_timeout.sh</em> script calls the <em>set_name_agi.py</em> script with a short timeout.</li> <li>The <em>set_name_agi.py</em> script will make an XML-RPC request on the Odoo server to try to find the name of the person corresponding to the phone number presented by the calling party.</li> <li>If it finds the name, it is set as the CallerID name of the call, so as to be presented on the IP phone of the user.</li> </ul> <p>It also works on outgoing calls, so as to display the name of the callee on the SIP phone of the caller. For that, you should use the script <em>set_name_outgoing_timeout.sh</em>.</p> </li> <li><p class="first">It adds a phone icon (<em>Open Caller</em>) in the top menu bar to get the partner/lead/candidate/event registrations corresponding to the calling party in one click. Here is how it works :</p> <ul class="simple"> <li>When the user clicks on the phone icon, Odoo sends a query to the Asterisk Manager Interface to get a list of the current phone calls.</li> <li>If it finds a phone call involving the user's phone, it gets the phone number of the calling party.</li> <li>It searches the phone number of the calling party in the Partners/Leads/Candidates/Event Registrations of Odoo. If a record matches, it takes you to the form view of this record. If no record matchs, it opens a wizard which proposes to create a new Partner with the presented phone number as <em>Phone</em> or <em>Mobile</em> number or update an existing Partner.</li> </ul> <p>It is possible to get a pop-up of the record corresponding to the calling party without any action from the user via the module <em>base_phone_popup</em>.</p> </li> </ol> <p>A detailed documentation for this module is available on <a class="reference external" href="http://www.akretion.com/products-and-services/openerp-asterisk-voip-connector">this page</a> of Akretion's Web site.</p> <p><strong>Table of contents</strong></p> <div class="contents local topic" id="contents"> <ul class="simple"> <li><a class="reference internal" href="#bug-tracker" id="id1">Bug Tracker</a></li> <li><a class="reference internal" href="#credits" id="id2">Credits</a><ul> <li><a class="reference internal" href="#authors" id="id3">Authors</a></li> <li><a class="reference internal" href="#contributors" id="id4">Contributors</a></li> <li><a class="reference internal" href="#maintainers" id="id5">Maintainers</a></li> </ul> </li> </ul> </div> <a name="bug-tracker"></a> <h2><a class="toc-backref" href="#id1">Bug Tracker</a></h2> <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 <a class="reference external" href="https://github.com/OCA/connector-telephony/issues/new?body=module:%20asterisk_click2dial%0Aversion:%2014.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p> <p>Do not contact contributors directly about support or help with technical issues.</p> <a name="credits"></a> <h2><a class="toc-backref" href="#id2">Credits</a></h2> <a name="authors"></a> <h3><a class="toc-backref" href="#id3">Authors</a></h3> <ul class="simple"> <li>Akretion</li> </ul> <a name="contributors"></a> <h3><a class="toc-backref" href="#id4">Contributors</a></h3> <ul class="simple"> <li>Alexis de Lattre &lt;<a class="reference external" href="mailto:alexis.delattre&#64;akretion.com">alexis.delattre&#64;akretion.com</a>&gt;</li> </ul> <a name="maintainers"></a> <h3><a class="toc-backref" href="#id5">Maintainers</a></h3> <p>This module is maintained by the OCA.</p> <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>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>Current <a class="reference external" href="https://odoo-community.org/page/maintainer-role">maintainer</a>:</p> <p><a class="reference external" href="https://github.com/alexis-via"><img alt="alexis-via" src="https://github.com/alexis-via.png?size=40px" /></a></p> <p>This module is part of the <a class="reference external" href="https://github.com/OCA/connector-telephony/tree/14.0/asterisk_click2dial">OCA/connector-telephony</a> project on GitHub.</p> <p>You are welcome to contribute. To learn how please visit <a class="reference external" href="https://odoo-community.org/page/Contribute">https://odoo-community.org/page/Contribute</a>.</p>