MBI Calls OVH

🎯 Module Overview

MBI Calls is a Dolibarr module for business phone management through the OVH API (version 2.3). It connects Dolibarr to your OVH switchboard CTI events to centralize incoming and outgoing calls inside your CRM, automatically link them to your third parties, and monitor the phone activity of your sales and support teams.

Works only with the OVH VoIP service (VoIP Entreprise plan).

🌐 Demo: https://demo.mbicloud.fr 🛒 Discover our other modules on Dolistore.

📞 Benefits

• Centralize all OVH phone calls directly inside Dolibarr
• Automatic caller identification (third party / contact) at the very moment the phone rings
• Time saved: one click to open the customer card, the call reason and the callback to schedule
• Easier sales and support follow-up thanks to a unified history and reporting
• Compatible with the native Dolibarr ClickToDial for outgoing calls in one click
• Multi-user: each agent can be linked to their own OVH line and see only their own calls

⚙️ Key Features

🔔 Real-time display and notifications

• Top-right dropdown menu (phone icon) listing the latest incoming calls with number, third-party / contact name (with link to the card), date, missed/answered icon and call duration. The menu opens automatically when a call comes in and refreshes in real time. Available only with the Eldy theme.
• Active call card displayed at the bottom of the page: follows the in-progress call state and stays visible until the ring ends or the call is handled.
• Country flag displayed for each call based on the number prefix.
• "Paste number" button on unknown calls when creating a new third party: fills the phone field of the new third party with the caller number in one click.

🧩 Dashboard widgets

• Call history: same display as the dropdown, on the home dashboard.
• Numbers to call back: list of pending callback reminders, with a color code reflecting urgency.
• Call queue statistics: today's KPIs (total, answered, lost, answer rate, average wait, average duration, per-user breakdown).

🏢 Third-party and contact linking

• Unified, separator-tolerant phone matching: national, +33, 0033 and trailing-digits variants.
• Wide-field lookup: third-party phone and fax; contact landline, mobile and personal numbers.
• Contact display instead of the third party when the number matches a linked contact.
• Manual re-association: unidentified calls in the dropdown can be linked to a third party.
• "Calls" tab added to the third-party card, with pagination and date sorting.

📝 Reasons and reminders

• Reason can be added to each call (viewable and editable from the dropdown, the widget and the third-party tab).
• Callback reminders scheduled at the date and time of your choice.
• User assignment: each reminder can be assigned to a specific Dolibarr user.
• Reason / reminder independence: you can add a reason without a reminder, and a reminder without a reason.
• "Numbers to call back" widget with urgency color coding; the reminder disappears after validation.
• Optional e-mail digest of due callback reminders, sent by a scheduled job provided by the module.

📊 Statistics and reporting

• Dedicated "Call statistics" page (Companies menu) with filters by date range, direction, status, user and number/company.
• KPIs: total calls, answer rate, average duration, average wait.
• Breakdown by day and by user.
• Recent call details and CSV export containing the full data set (no volume limit).

📅 Agenda integration

• Automatic agenda event on answered calls (option), linked to the third party and the contact, with direction, line, duration and attribution to the user linked to the line.

🔗 ClickToDial

• Compatible with the native Dolibarr ClickToDial (usable from the dropdown, widgets and lists).
• Call started without double dialing (only one call placed through Dolibarr).
• "Starting the call" notice displayed to confirm the trigger.

🛡️ Security and architecture

• Dolibarr proxy available for OVH: a server endpoint (request/ovh/events.php) listens to OVH events from Dolibarr and stores incoming calls in the database, alongside the browser-side listener. The OVH API key is only used by authenticated sessions with the module rights.
• AJAX endpoints protected by Dolibarr rights or by a secure key.
• Raw OVH events stored in a dedicated table (llx_mbi_calls_ovh_events) for debugging and analysis.
• OVH CTI debug page: live decoded events feed + raw JSON, with stored-history purge.
• Multi-entity: every call and OVH event is tagged with the Dolibarr entity, and all user-facing reads are entity-scoped.

🏷️ Lines and users

• User ↔ OVH line mapping: each Dolibarr user can be linked to their own agent number; display and permissions can be restricted to their own calls.
• Outgoing numbers configurable to detect call direction.
• Dedicated permissions: full access to all calls, or limited access to own calls and missed calls.

🛠️ Configuration and maintenance

• Configuration page: OVH API key, number of calls displayed, outgoing numbers, per-user lines, call queue duration, agenda event creation, reminder e-mails.
• History purge (llx_mbi_calls) in one click from the setup page. Warning: irreversible.
• External script page (request/ovh/events.php) that logs calls even when no Dolibarr tab is open, as long as this script page stays open.
• Resilient browser-side listener (JavaScript mode): keeps listening when the tab is in the background, renews its leader lease on every poll cycle to survive background timer throttling, and reconnects to OVH immediately without waiting for the Dolibarr save.

🆕 Recent updates (2.3 / 2.2 / 2.1 / 2.0)

• OVH event handling aligned with the official flow: call duration computed only from start_calling / bridge-agent-start, answered/missed status hardened.
• Redesigned active-call card (Dolibarr 23 / Eldy), proper OVH timezone conversion (no more 2-hour offset).
• Resilient browser listener (background tabs, throttling), wider lookup including the third-party mobile number, unified ClickToDial from third-party / contact cards.
• Unified, separator-tolerant phone matching, manual re-association of unknown calls, statistics page with CSV export, multi-entity support, scheduled job for reminder e-mails.
• Dolibarr v23 compatibility, hardened public/AJAX endpoints, OVH CTI proxy, raw OVH events storage, debug page, optimized indexes on llx_mbi_calls.

✅ Compatibility

• Dolibarr: 12+ (recommended Dolibarr 21+ / 23)
• PHP: 8.0+
• Theme: dropdown menu available only with the Eldy theme.
• Phone: OVH VoIP Entreprise (OVH CTI API / easyHunting eventToken).

Module version: auto
Publisher/Licence: MB Informatique / AGPL
User interface language: English, French
Help/Support: MB Informatique
Prerequisites:

• Dolibarr min version: auto
• Dolibarr max version: auto

🔧 Installation

1. Drop the mbicalls folder into /htdocs/custom/, or use the Deploy / Install external module option from the Dolibarr modules list.
2. Go to Home > Setup > Modules/Applications.
3. Activate MBI Calls in the modules list.
4. Enable the module permissions for the relevant users (a user without permissions will see no data).
5. Fill in the OVH API key in the module configuration (detailed instructions on the configuration page, starting from https://eu.api.ovh.com/console/).
6. Enable the widgets on the home dashboard (Call history, Numbers to call back, Call queue statistics).
7. (Optional) Enable the MBI Calls cron job in Home > Admin tools > Scheduled jobs to send reminders by e-mail.

ℹ️ Usage notes

• If some calls do not open the dropdown and some call data is not recorded, install a CORS browser extension (e.g. Allow CORS: Access-Control-Allow-Origin or CORS Everywhere).
• The external script page (request/ovh/events.php) is only useful to record calls outside Dolibarr usage hours; it is not required while Dolibarr is open in a browser.
• If an OVH ClickToDial module is already active, MBI Calls reuses its flow: clicks on a number from the dropdown or the widgets work without double-dialing.
• The "Last 24h" home summary is available from Dolibarr 11.0.0 onwards.

🎓 Services

• Training on the module is available at €80 excl. VAT.
• Support and updates included for the duration of your license.

📄 End-user License Agreement

The MBI Calls module is edited by MB Informatique SARL (SIRET: 83434236200029), whose head office is located at 120 rue de l'île Napoléon 68170 Rixheim FRANCE - Tel.: 03 67 262 242. This End-user License Agreement legally frames the use of the services of the MBI Calls module.

MB Informatique SARL declines all responsibility for any viruses that may infect the User's computer equipment after use or access to this module.

The total guarantee of data security, integrity, and confidentiality, whatever it may be, is not guaranteed by MB Informatique SARL.

MB Informatique SARL cannot be held responsible for its use outside the legal framework, nor for any unavailability of the OVH VoIP service or its API.

This contract is valid for an indefinite period. The beginning of the use of the module's services marks the application of the contract with regard to the User.

👨 💻 Publisher

MBI Calls is a custom Dolibarr module developed by MB Informatique.

It was designed for organizations using an OVH VoIP switchboard that want to centralize their phone activity inside Dolibarr, save time on caller identification and steer their sales and support activity through an enriched call history.

Publisher: MB Informatique
Contact: info@mb-informatique.fr
Website: https://www.mb-informatique.fr

🛠 CHANGELOG

Update 2.3.1 (16/06/2026)

• Redesigned the call reason / callback reminder popup with a modern layout (caller card, sectioned fields, modern textarea and inputs) consistent across the dropdown, the third-party "Calls" tab and the home calls widget.
• Fixed the callback reminder date being silently rolled to the next year because of a datepicker / server format mismatch (jQuery datepicker now uses the locale-matching format and the server rejects overflowed dates).
• Fixed new callback reminders defaulting to the first user in the list: they are now assigned to the connected user by default, so they appear in the user's "Numbers to call back" widget right away.
• Fixed the reason popup not opening when clicked from the third-party "Calls" tab (broken inline JS quoting).

Update 2.3.0 (09/06/2026)

• Aligned OVH CTI event handling with the OVH example flow: ringing events create/display the active incoming call, while call duration now starts only on start_calling or bridge-agent-start.
• Fixed answered/missed status and duration calculations across the dropdown, third-party call tab, dashboard box and statistics page so calls without a real answer are no longer counted as answered.
• Improved active call popup rendering and refresh: bottom call card now follows the active-call state, respects linked user/line scoping, and is protected against early cross-tab refreshes.
• Fixed OVH event date conversion to the Dolibarr/server timezone to avoid a two-hour offset in displayed call dates.
• Refined the bottom active-call card styling for Dolibarr 23 / Eldy and adjusted compact icon width.
• Removed the temporary global button top margin rule to avoid layout side effects.

Update 2.2.0 (08/06/2026)

• Improved reliability of the browser-side OVH event listener (JavaScript mode): it now keeps listening when the tab is in the background, renews its leader lease on every poll cycle to survive background timer throttling, reconnects to OVH immediately after each response instead of waiting for the Dolibarr save, and no longer posts empty keep-alive responses.
• Company phone matching now also looks up the third party's mobile number and no longer matches the fax number (contacts already matched landline, personal and mobile numbers).
• Click-to-dial from a third party / contact card (and from lists) now opens the calls popup and shows the "Starting the call" notice, just like click-to-dial from the calls dropdown; the call is still placed through Dolibarr's native click-to-dial, so there is no double dialing.

Update 2.1.0 (03/06/2026)

• Unified, separator-tolerant phone matching for linking calls to contacts/companies (national, +33, 0033 and trailing-digits variants), also matching company fax.
• Added manual re-association: unidentified calls in the dropdown can now be linked to a third party.
• Consolidated agenda event creation on answered calls (links third party + contact, records direction, line and duration, attributes the event to the assigned user).
• Added an optional scheduled job that e-mails users a digest of their due callback reminders.
• Added a call statistics / reporting page (filters by date, direction, status, user and number) with KPIs, per-day and per-user breakdowns and CSV export.
• Added multi-entity support: calls and OVH events are now tagged with the Dolibarr entity, and all user-facing reads are entity-scoped.

Update 2.0.1 (17/05/2026)

• Fixed OVH events session persistence and continuity handling (read/write/clear with TTL and invalid-session detection).
• Fixed events.php runtime error on affected_rows() and aligned request timeout handling with FastCGI constraints.
• Added detailed OVH session diagnostics in debug mode (requested/returned session, source, continuity, DB before/after, counters).
• Improved calls dropdown stability (unique DOM ids, consistent selector ids, filter persistence, and missing-calls display refinements).
• Updated OVH API key setup instructions and translated the new help text across module language files.

Update 2.0.0 (08/05/2026)

• Improved Dolibarr v23 compatibility and reduced PHP warnings on recent versions.
• Secured public/AJAX endpoints with read rights or secure key validation.
• Added OVH CTI proxy handling to avoid exposing the OVH API key in the browser.
• Added support for OVH queue events such as agent-offering.
• Added storage of raw OVH events in llx_mbi_calls_ovh_events for debugging and analysis.
• Added an OVH CTI debug page with live decoded events and raw JSON display.
• Optimized llx_mbi_calls with indexes for dropdown, third-party tab, reminders and deduplication queries.
• Improved dropdown performance with lazy loading and redesigned the calls dropdown UI.
• Added an active incoming call card with contact/third-party link when available.
• Improved translations consistency across all language files.
• Hardened SQL escaping, input validation and optional configuration handling.

Update 1.4.1 (04/08/2025)

• Dolibarr v21 compatibility.
• Added a tab listing calls for the tier.

Update 1.4.0 (25/06/2025)

• Bug fixes and code readability improvements.
• Added clear comments to make it easier to understand.
• Optimized code structure for better performance.

Update 1.3.4 (04/10/2022)

• Dolibarr v16 compatibility.

Update 1.3.3 (31/03/2022)

• Dolibarr v15 compatibility.

Update 1.3 (07/02/2022)

• Contact's name is displayed instead of thirdparty's when it is possible.

Update 1.2.5 (21/01/2022)

• It is possibleto create an event for each answered call (optional).

Update 1.2 (17/12/2020)

• The dropdown show a country flag for each call.

Update 1.1 (10/11/2020)

• The module allows you to know if calls are incoming or outgoing and allows to link a Dolibarr user to a number and to see only some calls.

1.0

Initial version