This module provides common methods and wizards which can be useful to develop a connector between Odoo and a telephony system. It depends on the official module phone_validation which handle the reformatting of phone numbers using the phonenumbers Python library, which is a port of the library used in Android smartphones. For example, if your user is linked to a French company and you update the form view of a partner with a badly written French phone number such as '01-55-42-12-42', Odoo will automatically update the phone number to E.164 format '+33155421242'. This module extends this reformatting to create() and write() methods.
This module is used by the Odoo-Asterisk connector of the OCA.
auto_awesome What this module does
AI-generated from the code · Odoo 18.0Adds phone-number tools to Odoo: a Dial button next to phone fields, automatic international reformatting of stored numbers, and a wizard to clean up all existing numbers. It also lets Odoo find a partner from an incoming caller's number.
This module is the shared phone foundation used by telephony connectors. It does not connect to a phone system by itself, but it prepares Odoo for it.
What users see: - A small "Dial" link with a phone icon appears next to phone and mobile fields on forms. Clicking it saves the record and asks the phone system to dial the number. - A "Telephony" menu appears under Settings, containing a "Reformat Phone Numbers" wizard. This wizard rewrites the phone and mobile numbers of all partners into standard international format (for example +33 1 41 98 12 42) and reports any numbers it could not reformat. It opens automatically after installing the module. - In Settings, a "Telephony" section lets you set how many digits must match at the end of a number for an incoming call to be recognised.
Automatic behaviour: - Phone numbers are reformatted to international format when records are created or updated, using the country of the record, its partner, or the company. - Odoo can look up a partner, lead or employee from a caller's number by comparing the last digits, using the configured number of digits (default 8, must be positive). - A "Number Not Found" wizard lets you create a new partner or update an existing one with the caller's number, choosing whether it is a fixed or mobile number.
It touches res.partner, res.company, res.users, res.config.settings and adds a "Phone CallerID" access group.
Depends on
Required by other modules
Menus it adds
Models and fields (7)
- res.company · extends an existing modelnumber_of_digits_to_match_from_end (Number of Digits To Match From End)
- res.partner · new model
- phone.common · new model
- number.not.found · new modele164_number (E.164 Number), number_type (Fixed/Mobile), calling_number, to_update_partner_id (Partner to Update), current_partner_phone (Current Phone), current_partner_mobile (Current Mobile)
- res.config.settings · extends an existing modelnumber_of_digits_to_match_from_end (Number of Digits)
- phone.validation.mixin · new model
- reformat.all.phonenumbers · new modelstate, phonenumbers_not_reformatted (Phone numbers that couldn't be reformatted)
Text generated by AI (DeepSeek) from reading the Odoo 18.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub
Availability by version
Reviewed: 2026-11-03Confirmation status: 6 confirmed, 3 with no information of 9 versions.
Sources · Odoo 14.0
Confirmed on 2026-11-03 in branch 14.0 of OCA/connector-telephony.
terminal Installation and usage
No verified informationInstallation instructions, the distribution package, dependencies and configuration steps are not shown because they have not yet been verified in the module documentation for any version.
Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.