Odoo

Le raccordement à votre Odoo : le nom du contact présenté à la sonnerie, une fiche d'appel dans Odoo, la transcription et l'analyse sur le contact.

En bref

Comment ça marche

Vous déclarez un compte Odoo et sa clé d'API. À partir de là, le raccordement fait trois choses distinctes, que vous activez séparément : il cherche le contact qui correspond au numéro, il écrit une fiche d'appel dans Odoo, et il publie la transcription et l'enregistrement sur le contact.

Le journal d'appel s'écrit dans le modèle voip.call, celui de l'application Phone d'Odoo. Cette application n'existe que dans l'édition Entreprise. En Community, c'est le module Axivox qui apporte le journal, sous son propre modèle mais avec les mêmes noms de champs, pour que rien ne change dans vos habitudes le jour où vous passeriez en Entreprise. Le sondage décrit plus bas vous dit lequel des deux votre instance utilise.

Le sondage de l'instance

Le bouton Tester la connexion ne se contente pas de vérifier vos identifiants. Il interroge votre instance et affiche ce qu'elle sait faire, plutôt que de le déduire de son numéro de version. Une version est un indice, jamais une preuve : deux instances de la même série n'acceptent pas forcément les mêmes champs, et une instance Entreprise peut très bien ne pas avoir l'application installée.

Le sondage affiche :

• l'Édition, Entreprise ou Community, et la série ;
• le Journal d'appel, c'est-à-dire le modèle qui le portera ;
• une pastille par champ, verte ou orange.

Une pastille verte signifie « Poussé dans le journal d'appel d'Odoo ». Une pastille orange signifie « Non disponible ici : poussé dans le fil du contact ». L'écran l'explique sous les pastilles : « Les champs en orange n'existent pas sur cette version d'Odoo. Ils continuent d'être écrits dans le fil de discussion du contact. » Rien n'est donc perdu : l'information change d'endroit.

Les dix champs sondés sont phone_number, direction, state, start_date, end_date, partner_id, user_id, summary, transcript et transcription_status. Cinq autres, que nous ajoutons et qu'Odoo n'a pas, n'apparaissent que là où ils existent : did, talk_duration_s, sentiment, escalation et themes.

Quand le journal d'appel est impossible

Deux cas, deux réponses différentes.

Si l'application Phone existe mais n'est pas installée, l'écran affiche : « L'application Phone d'Odoo n'est pas installée sur cette instance. Sans elle, aucun journal d'appel n'est possible. » Elle s'installe depuis le menu Applications de votre Odoo, avec cet avertissement, affiché tel quel : « Sur Odoo en ligne, installer une application peut modifier votre abonnement. Cette installation vous appartient, nous ne la faisons pas à votre place. »

Si l'instance est en Community, l'application n'existe pas et aucune manipulation dans Odoo ne l'installera. L'écran affiche alors : « Cette instance est en Community : l'application Phone d'Odoo n'y existe pas. Le module Axivox apportera le journal d'appel. » Et il propose la marche à suivre en trois étapes, avec le bouton de téléchargement pour votre série :

1. « Téléchargez le module pour votre version d'Odoo. »
2. « Déposez le dossier dans le répertoire des modules de votre serveur Odoo, puis redémarrez Odoo. Un module qui apporte du code n'est pris en compte qu'au démarrage. »
3. « Dans Odoo, menu Applications, mettez la liste à jour, cherchez Axivox et installez. Revenez ensuite ici et testez la connexion. »

Ce qu'il faut saisir

Le bloc Connexion :

Le bouton Lister les bases interroge le serveur à partir de l'URL saisie, avant toute authentification. Trois réponses possibles : une liste à choisir, « Aucune base retournée par le serveur (listage peut-être désactivé) », ou « Impossible de lister les bases (serveur injoignable ou listage désactivé). Saisissez le nom manuellement. » Dans les deux derniers cas, le nom se tape à la main : le listage est souvent coupé sur une instance de production, ce n'est pas une panne.

En modification, le champ Clé API affiche « •••••••• (laisser vide pour conserver) ». Laissé vide, il ne touche pas à la clé déjà enregistrée.

Le bloc Fonctionnalités contient six bascules, dans cet ordre. Le texte de la colonne de droite est celui qu'affiche l'écran sous chacune.

La liste des instances, elle, affiche le Nom, l'URL, le Statut (Active ou Inactive) et une colonne Instance par défaut, qui est un bouton radio : une seule instance à la fois. Le lien Retirer l'instance par défaut, sous le tableau, annule ce choix.

La marche à suivre

1. Dans Odoo, générez une clé d'API : Préférences, Sécurité du compte, Clés API.
2. Ouvrez Intégrations, Odoo, puis Ajouter une instance.
3. Nommez l'instance, saisissez son URL complète et l'identifiant du compte, puis collez la clé d'API.
4. Cliquez sur Lister les bases et choisissez la vôtre. Si le listage est désactivé, tapez le nom technique de la base.
5. Cliquez sur Tester la connexion. Lisez le sondage qui apparaît : l'édition, la série, le journal d'appel et la couleur des pastilles.
6. Si le sondage annonce qu'aucun journal d'appel n'est possible, réglez d'abord ce point dans votre Odoo, puis testez à nouveau.
7. Activez les bascules dont vous avez besoin, en commençant par Instance active.
8. Sauvegardez.
9. De retour sur la liste, cochez Instance par défaut sur celle que vos plans d'appel doivent interroger par défaut.
10. Appelez un de vos numéros depuis un téléphone dont le numéro existe dans Odoo, et vérifiez le nom présenté.

Si ça ne marche pas

« Échec de la connexion » après le test. Quatre valeurs peuvent être en cause, dans cet ordre de fréquence : le nom de la base, qui n'est pas le sous-domaine ; la clé d'API, qui doit être une clé et non un mot de passe ; l'identifiant ; l'URL, qui doit être complète, protocole compris. Corrigez une valeur à la fois et retestez : le test est gratuit et immédiat.

Des pastilles sont orange après le test. Rien n'est perdu. « Les champs en orange n'existent pas sur cette version d'Odoo. Ils continuent d'être écrits dans le fil de discussion du contact. » Vous les retrouverez sur la fiche du correspondant, dans son fil de discussion, au lieu de la fiche d'appel.

Le nom du contact ne s'affiche pas au premier appel d'un numéro inconnu. C'est le comportement annoncé sous la bascule Identifier les appelants : la recherche dispose d'une demi-seconde avant que l'appel continue. Passé ce délai, l'appel part sans attendre, pour ne jamais retarder une sonnerie. Le nom trouvé est ensuite conservé : dès le deuxième appel du même numéro, il s'affiche immédiatement.

Rien n'est publié sur le contact. Trois conditions se cumulent. Il faut un contact identifié dans Odoo : « Sans contact identifié dans Odoo, rien n'est publié. » Il faut que Publier la transcription et l'analyse soit activée. Et pour l'audio, il faut en plus que la transcription soit publiée : « Il ne s'affiche que si la transcription est publiée elle aussi. »

Aucune fiche d'appel n'apparaît dans Odoo. Testez la connexion et lisez la ligne Journal d'appel du sondage. Si elle est vide, l'instance n'a pas encore de modèle pour recevoir le journal : suivez la marche à suivre que l'écran affiche, celle de l'application Phone en Entreprise, celle du module Axivox en Community.