MBI Calls est un module Dolibarr de gestion de la téléphonie d'entreprise via l'API OVH (version 2.3). Il connecte Dolibarr aux événements CTI de votre standard OVH afin de centraliser dans votre CRM les appels entrants et sortants, de les rattacher automatiquement à vos tiers, et de piloter l'activité téléphonique de vos équipes commerciales et support.

Fonctionne uniquement avec le service VoIP de OVH (forfait VoIP Entreprise).

🌐 Démo : https://demo.mbicloud.fr 🛒 Découvrez nos autres modules sur Dolistore.

📞 Avantages

• Centralisation des appels téléphoniques OVH directement dans Dolibarr
• Identification automatique de l'appelant (tiers / contact) au moment où le téléphone sonne
• Gain de temps : un clic sur la fiche du client, accès direct au motif et au rappel à effectuer
• Suivi commercial et support facilité grâce à l'historique consolidé et aux statistiques
• Compatible avec le ClickToDial natif de Dolibarr pour passer vos appels sortants en un clic
• Multi-utilisateurs : chaque agent peut être lié à sa propre ligne OVH et ne voir que ses appels

⚙️ Fonctionnalités clés

🔔 Affichage et notifications temps réel

• Menu déroulant en haut à droite (icône de téléphone) listant les derniers appels entrants avec le numéro, le nom du tiers ou contact s'il existe (avec lien vers la fiche), la date, l'icône d'appel répondu/manqué et la durée. Le menu s'ouvre automatiquement à l'arrivée d'un appel et se met à jour en temps réel. Compatible uniquement avec le thème Eldy.
• Carte d'appel actif affichée en bas de page : suit l'état de l'appel en cours et reste visible jusqu'à la fin de la sonnerie ou la prise en charge.
• Drapeau du pays affiché pour chaque appel selon l'indicatif du numéro.
• Bouton "Coller le numéro" sur les appels inconnus lors de la création d'un nouveau tiers : remplit en un clic le champ téléphone du tiers avec le numéro de l'appelant.

🧩 Widgets sur l'accueil

• Historique des appels : reprend l'affichage du menu déroulant directement sur le tableau de bord.
• Numéros à rappeler : liste les notifications de rappel en attente, avec un code couleur représentant l'urgence du rappel.
• Statistiques des files d'appels : KPIs du jour (total, répondus, perdus, taux de réponse, attente moyenne, durée moyenne, répartition par utilisateur).

🏢 Rattachement aux tiers et contacts

• Matching téléphonique unifié et tolérant aux séparateurs : reconnaissance des numéros au format national, +33, 0033 et par chiffres significatifs de fin.
• Recherche élargie sur tous les numéros utiles : téléphone, fax (tiers), mobile, téléphone personnel et professionnel (contacts).
• Affichage du contact plutôt que du tiers lorsque le numéro correspond à un contact rattaché.
• Ré-association manuelle : possibilité de lier un appel inconnu à un tiers depuis le menu déroulant, lorsque la reconnaissance automatique n'a pas suffi.
• Onglet "Appels" ajouté sur la fiche tiers, avec pagination et tri par date.

📝 Motifs et rappels

• Ajout d'un motif sur chaque appel (consultable et modifiable depuis le menu déroulant, le widget et l'onglet tiers).
• Notifications de rappel programmées à la date et l'heure de votre choix.
• Assignation utilisateur : chaque notification peut être attribuée à un utilisateur Dolibarr précis.
• Indépendance motif / rappel : il est possible d'ajouter un motif sans rappel et un rappel sans motif.
• Widget "Numéros à rappeler" avec couleur d'urgence ; après validation, la notification disparaît.
• Envoi optionnel par e-mail d'un récapitulatif des rappels arrivés à échéance, via une tâche cron Dolibarr fournie avec le module.

📊 Statistiques et reporting

• Page dédiée "Statistiques d'appels" (menu Tiers) avec filtres par période, sens, statut, utilisateur et numéro/société.
• KPIs : total des appels, taux de décroché, durée moyenne, attente moyenne.
• Répartition par jour et par utilisateur.
• Détail des appels récents et export CSV complet (sans limite de volume).

📅 Intégration Agenda

• Création automatique d'un évènement d'agenda sur les appels répondus (option), avec liaison au tiers et au contact, sens de l'appel, ligne, durée et attribution à l'utilisateur lié à la ligne.

🔗 ClickToDial

• Compatible avec le ClickToDial natif de Dolibarr (utilisable depuis le menu déroulant, le widget et les listes).
• Démarrage de l'appel sans double composition (un seul appel passé via Dolibarr).
• Notification "Lancement de l'appel en cours" pour confirmer le déclenchement à l'utilisateur.

🛡️ Sécurité et architecture

• Proxy Dolibarr disponible pour OVH : un endpoint serveur (request/ovh/events.php) permet d'écouter les événements OVH côté Dolibarr et de pousser les appels reçus dans la base, en complément du listener navigateur. La clé API n'est utilisée que par des sessions authentifiées disposant des droits du module.
• Endpoints AJAX protégés par les droits Dolibarr ou par clé sécurisée.
• Stockage des événements OVH bruts dans une table dédiée (llx_mbi_calls_ovh_events) pour le debug et l'analyse.
• Page de debug OVH CTI : flux d'événements décodés en direct + JSON brut, purge de l'historique stocké.
• Multi-entité : tous les appels et événements OVH sont taggés avec l'entité Dolibarr, et toutes les lectures sont filtrées par entité.

🏷️ Lignes et utilisateurs

• Liaison utilisateurs ↔ lignes OVH : chaque utilisateur Dolibarr peut être associé à son propre numéro d'agent ; l'affichage et les permissions peuvent être restreints à ses propres appels.
• Numéros d'appels sortants configurables pour identifier le sens des appels.
• Permissions dédiées : accès complet à tous les appels, ou accès limité aux appels propres et aux appels manqués.

🛠️ Configuration et maintenance

• Page de configuration : clé API OVH, nombre d'appels affichés, numéros sortants, lignes par utilisateur, durée de la file d'appels, création d'événements d'agenda, e-mails de rappel.
• Purge de l'historique (llx_mbi_calls) en un clic depuis la configuration. Attention : action irréversible.
• Page de script externe (request/ovh/events.php) permettant d'enregistrer les appels même quand Dolibarr n'est ouvert dans aucun onglet, à condition de garder cette page ouverte.
• Listener côté navigateur (mode JavaScript) robuste : continue d'écouter même quand l'onglet est en arrière-plan, renouvelle son bail de leader à chaque cycle pour résister au throttling des timers, et se reconnecte immédiatement à OVH sans attendre l'écriture Dolibarr.

🆕 Nouveautés récentes (2.3 / 2.2 / 2.1 / 2.0)

• Alignement du traitement des événements OVH sur le flux officiel : durée d'appel calculée uniquement à partir de start_calling / bridge-agent-start, statut répondu/manqué fiabilisé.
• Carte d'appel actif redessinée (Dolibarr 23 / Eldy), gestion fine du timezone OVH (plus de décalage de 2 heures).
• Listener navigateur résilient (arrière-plan, throttling), recherche élargie sur le mobile du tiers, ClickToDial unifié depuis les fiches tiers / contacts.
• Matching téléphonique unifié et tolérant aux séparateurs, ré-association manuelle des appels inconnus, page de statistiques avec export CSV, multi-entité, tâche cron d'e-mails de rappel.
• Compatibilité Dolibarr v23, sécurisation des endpoints publics/AJAX, proxy OVH CTI, stockage des événements OVH bruts, page de debug, index optimisés sur llx_mbi_calls.

✅ Compatibilité

• Dolibarr : 12+ (recommandé Dolibarr 21+ / 23)
• PHP : 8.0+
• Thème : menu déroulant fonctionnel uniquement avec le thème Eldy.
• Téléphonie : OVH VoIP Entreprise (API OVH CTI / easyHunting eventToken).

Module version: auto
Editeur/Licence: MB Informatique / AGPL
Langage interface: Anglais, Français
Assistance: MB Informatique
Prérequis:

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

🔧 Installation

1. Déposer le dossier mbicalls dans /htdocs/custom/, ou utiliser l'option Déployer / Installer un module externe depuis la liste des modules Dolibarr.
2. Aller dans Accueil > Configuration > Modules/Applications.
3. Activer MBI Calls dans la liste des modules.
4. Activer les permissions du module pour les utilisateurs concernés (un utilisateur sans permission ne verra aucune donnée).
5. Renseigner la clé d'API OVH dans la configuration du module (instructions détaillées sur la page de configuration, à partir de la console https://eu.api.ovh.com/console/).
6. Activer les widgets sur la page d'accueil (Historique des appels, Numéros à rappeler, Statistiques des files d'appels).
7. (Optionnel) Activer la tâche cron MBI Calls dans Accueil > Outils d'administration > Travaux planifiés pour envoyer les rappels par e-mail.

ℹ️ Remarques d'utilisation

• Si tous les appels ne déclenchent pas l'ouverture du menu déroulant et que certaines données d'appel ne sont pas enregistrées, installez une extension CORS pour votre navigateur (par exemple Allow CORS: Access-Control-Allow-Origin ou CORS Everywhere).
• La page de script externe (request/ovh/events.php) n'est utile que pour enregistrer les appels en dehors des heures d'ouverture de Dolibarr ; elle n'est pas nécessaire tant que Dolibarr est ouvert dans le navigateur.
• Si un module ClickToDial OVH est déjà actif, MBI Calls réutilise son flux : les clics sur un numéro depuis le menu déroulant ou les widgets fonctionnent sans déclencher de double appel.
• Le récapitulatif "Dernières 24h" en page d'accueil n'est disponible qu'à partir de Dolibarr 11.0.0.

🎓 Services

• Formation sur le module disponible au tarif de 80 € HT.
• Support et mises à jour inclus pendant la durée de votre licence.

📄 Conditions générales d'Utilisation

L'édition du module MBI Calls est assurée par la société MB Informatique SARL (SIRET : 83434236200029), dont le siège social est localisé au 120 rue de l'île Napoléon 68170 Rixheim FRANCE, et dont le numéro de téléphone est le 03 67 262 242. Les présentes Conditions Générales d'Utilisation encadrent juridiquement l'utilisation des services du module MBI Calls.

MB Informatique SARL décline toute responsabilité concernant les éventuels virus pouvant infecter le matériel informatique de l'Utilisateur après l'utilisation ou l'accès à ce module.

La garantie totale de la sécurité, de l'intégrité et de la confidentialité des données, quelles qu'elles soient, n'est pas assurée par MB Informatique SARL.

MB Informatique SARL ne peut être tenue pour responsable de son utilisation en dehors du cadre légal, ni des éventuelles indisponibilités du service VoIP OVH ou de son API.

Le présent contrat est valable pour une durée indéterminée. Le début de l'utilisation des services du module marque l'application du contrat à l'égard de l'Utilisateur.

👨 💻 Éditeur

MBI Calls est un module custom Dolibarr développé par MB Informatique.

Il a été conçu pour les structures équipées d'un standard VoIP OVH qui souhaitent centraliser leur téléphonie dans leur CRM Dolibarr, gagner du temps sur l'identification des appelants et piloter leur activité commerciale et support à partir d'un historique d'appels enrichi.

Éditeur : MB Informatique
Contact : info@mb-informatique.fr
Site web : https://www.mb-informatique.fr

🔧Journal des changements

Version 2.3.1 (16/06/2026)

• Refonte visuelle de la popup motif d'appel / rappel : carte d'appelant, sections, textarea et champs modernisés, identique depuis le menu déroulant, l'onglet « Appels » du tiers et le widget d'accueil.
• Correction de la date de rappel qui basculait silencieusement à l'année suivante à cause d'un décalage de format entre le calendrier jQuery et le serveur (le calendrier utilise désormais le format de la locale et le serveur rejette les dates en dépassement).
• Correction des nouveaux rappels qui s'assignaient au premier utilisateur de la liste : ils sont désormais affectés par défaut à l'utilisateur connecté et apparaissent immédiatement dans son widget « Numéros à rappeler ».
• Correction de la popup motif qui ne s'ouvrait pas depuis l'onglet « Appels » du tiers (erreur de quoting JS en ligne).

Version 2.3.0 (09/06/2026)

• Alignement du traitement des événements OVH CTI sur le flux officiel : les événements de sonnerie créent/affichent l'appel entrant actif, et la durée d'appel ne démarre qu'à start_calling ou bridge-agent-start.
• Correction des statuts répondu/manqué et du calcul de durée dans le menu déroulant, l'onglet d'appels du tiers, le widget d'accueil et la page de statistiques : les appels sans décrochage réel ne sont plus comptés comme répondus.
• Amélioration du rendu et du rafraîchissement de la popup d'appel actif : la carte d'appel en bas suit l'état réel de l'appel, respecte le scoping utilisateur/ligne lié et résiste aux rafraîchissements précoces inter-onglets.
• Correction de la conversion des dates d'événements OVH vers le fuseau Dolibarr/serveur (plus de décalage de deux heures sur les dates affichées).
• Affinage du style de la carte d'appel actif pour Dolibarr 23 / Eldy et ajustement de la largeur des icônes compactes.
• Suppression d'une règle globale temporaire de marge sur les boutons (qui avait des effets de bord sur la mise en page).

Version 2.2.0 (08/06/2026)

• Fiabilisation du listener navigateur des événements OVH (mode JavaScript) : il continue d'écouter quand l'onglet est en arrière-plan, prolonge son bail de leader à chaque cycle de poll pour résister au throttling, se reconnecte à OVH immédiatement après chaque réponse au lieu d'attendre l'écriture Dolibarr, et n'envoie plus de réponses keep-alive vides.
• La reconnaissance téléphonique côté tiers prend désormais aussi en compte le mobile du tiers, et ne se base plus sur le fax (les contacts couvraient déjà le fixe, le personnel et le mobile).
• Le clicktodial depuis une fiche tiers / contact (et depuis les listes) ouvre désormais la popup d'appel et affiche la notification « Lancement de l'appel en cours », comme depuis le menu déroulant ; l'appel est toujours passé via le clicktodial natif de Dolibarr, donc sans double composition.

Version 2.1.0 (03/06/2026)

• Reconnaissance téléphonique unifiée et tolérante aux séparateurs pour lier les appels aux contacts/tiers (formats national, +33, 0033 et chiffres de fin), incluant aussi le fax du tiers.
• Ré-association manuelle : les appels non identifiés du menu déroulant peuvent désormais être rattachés à un tiers.
• Consolidation de la création d'événement d'agenda sur les appels répondus (lie tiers + contact, enregistre le sens, la ligne et la durée, attribue l'événement à l'utilisateur affecté).
• Ajout d'une tâche planifiée optionnelle qui envoie aux utilisateurs un e-mail récapitulatif de leurs rappels arrivés à échéance.
• Ajout d'une page de statistiques / reporting des appels (filtres par date, sens, statut, utilisateur et numéro) avec KPIs, répartition par jour et par utilisateur, export CSV.
• Support multi-entité : les appels et les événements OVH sont taggés avec l'entité Dolibarr, et toutes les lectures côté interface sont scopées par entité.

Version 2.0.1 (17/05/2026)

• Correction de la persistance et de la continuité des sessions d'événements OVH (lecture/écriture/purge avec TTL et détection des sessions invalides).
• Correction d'une erreur d'exécution sur affected_rows() dans events.php et alignement de la gestion du timeout des requêtes avec les contraintes FastCGI.
• Ajout de diagnostics détaillés sur les sessions OVH en mode debug (session demandée/retournée, source, continuité, base avant/après, compteurs).
• Stabilité accrue du menu déroulant des appels (id DOM uniques, id de sélecteurs cohérents, persistance du filtre, affinages d'affichage des appels manquants).
• Mise à jour des instructions de configuration de la clé API OVH et traduction de la nouvelle aide dans tous les fichiers de langue du module.

Version 2.0.0 (08/05/2026)

• Compatibilité Dolibarr v23 et réduction des warnings PHP sur les versions récentes.
• Sécurisation des endpoints publics/AJAX par les droits de lecture ou la clé sécurisée.
• Ajout d'un proxy OVH CTI pour éviter d'exposer la clé API dans le navigateur.
• Prise en charge des événements de file d'attente OVH tels que agent-offering.
• Stockage des événements OVH bruts dans llx_mbi_calls_ovh_events pour le debug et l'analyse.
• Ajout d'une page de debug OVH CTI avec les événements décodés en direct et le JSON brut.
• Optimisation de llx_mbi_calls avec des index dédiés au menu déroulant, à l'onglet tiers, aux rappels et à la déduplication.
• Performance du menu déroulant améliorée par chargement progressif, et refonte de l'interface du menu déroulant des appels.
• Ajout d'une carte d'appel entrant actif avec lien vers le contact / tiers lorsque disponible.
• Cohérence des traductions améliorée dans tous les fichiers de langue.
• Durcissement de l'échappement SQL, de la validation des entrées et de la gestion des configurations optionnelles.

Version 1.4.1 (04/08/2025)

• Compatibilité Dolibarr v21.
• Ajout d'un onglet listant les appels du tiers.

Version 1.4.0 (25/06/2025)

• Corrections de bugs et amélioration de la lisibilité du code.
• Ajout de commentaires clairs pour faciliter la compréhension.
• Structure du code optimisée pour de meilleures performances.

Version 1.3.4 (04/10/2022)

• Compatibilité Dolibarr v16.

Version 1.3.3 (31/03/2022)

• Compatibilité Dolibarr v15.

Version 1.3 (07/02/2022)

• Le nom du contact est affiché à la place de celui du tiers lorsque c'est possible.

Version 1.2.5 (21/01/2022)

• Possibilité de créer un événement pour chaque appel répondu (optionnel).

Version 1.2 (17/12/2020)

• Le menu déroulant affiche un drapeau de pays pour chaque appel.

Version 1.1 (10/11/2020)

• Le module permet de savoir si les appels sont entrants ou sortants et permet de lier un utilisateur Dolibarr à un numéro afin de ne voir que certains appels.

1.0

Version initiale.