🚨Pré-requis : Avant de commencer l’intégration, assurez-vous de disposer :
Les identifiants SFTP du serveur contenant les appels Vocalcom
L'accès administrateur à un compte Modjo
⏱️ Durée: < 5min en moyenne
1. Étapes d’intégration
A. Accéder à la section Intégrations
Connectez-vous à votre espace Modjo avec un compte administrateur.
Naviguez vers la page « Intégrations » depuis le menu principal.
B. Ajouter l’intégration Vocalcom
Recherchez « Vocalcom » dans la liste des intégrations disponibles.
Cliquez sur la carte ou le bouton correspondant à Vocalcom pour démarrer la configuration.
C. Saisir les informations SFTP et les chemins d’accès aux enregistrements
Lors de la configuration, il est obligatoire de renseigner :
Les identifiants SFTP (adresse, port, utilisateur, mot de passe)
Le dirPath (chemin des dossiers d’enregistrements)
Le filePath (modèle de nommage des fichiers d’enregistrement)
⚠️ Important :
Les modèles de dirPath
et filePath
doivent être strictement identiques à ceux configurés sur votre interface Hermes.
Si vous avez un doute, vérifiez la configuration Hermes ou demandez à votre administrateur technique.
1. dirPath
Chemin du dossier sur le serveur SFTP Hermes où sont stockés les enregistrements d’appels.
Il doit obligatoirement contenir les variables suivantes, dans cet ordre :
{YYYY_LT}/{MM_LT}/{DD_LT}/{ID_AGENT}
(année, mois, jour, agent)Cette organisation permet à Modjo d’optimiser la recherche et l’import des nouveaux appels, en parcourant uniquement les dossiers correspondant aux dates récentes, ainsi qu'aux agents ayant une license Modjo.
Exemple :
/root-path/{YYYY_LT}/{MM_LT}/{DD_LT}/{ID_AGENT}
2. filePath
Modèle de nommage des fichiers d’enregistrement à l’intérieur de chaque dossier.
Les champs suivants sont obligatoires dans le nom du fichier (l’ordre n’a pas d’importance) :
{INDICE}
: identifiant unique de l’appel (ou incrément){YYYYMMDD}
: date de l’appel{HHMMSS}
: heure de l’appel{ID_AGENT}
: identifiant de l’agent
Les champs suivants sont fortement recommandés :
{DNIS}
et{TEL_CLIENT}
:Permettent à Modjo de déterminer automatiquement la direction de l’appel (entrant ou sortant)
TEL_CLIENT : Permet également d’identifier le contact appelé ou appelant.
Si ce champ n’est pas présent, Modjo créera un contact « Unknown » par défaut pour l’appel importé.
{NAME_AGENT}
:Facilite l’association automatique des utilisateurs, mais n’est pas obligatoire si vous savez à qui correspond chaque
{ID_AGENT}
Exemple de modèle de nommage (à adapter selon votre configuration Hermes) :
{ID_CAMP}#{ID_AGENT}#{NAME_AGENT}#{YYYYMMDD}#{HHMMSS}#{INDICE}#{TEL_CLIENT}#{DNIS}.wav
3. Tableau récapitulatif des champs
Champ | Obligatoire | Rôle |
| Oui | Année (dossier) |
| Oui | Mois (dossier) |
| Oui | Jour (dossier) |
(Dossier) | Oui | Identifiant de l’agent (dossier) |
---- | ---- | ---- |
| Oui | Identifiant unique de l’appel (fichier) |
| Oui | Date de l’appel (fichier) |
| Oui | Heure de l’appel (fichier) |
(fichier) | Oui | Identifiant de l’agent (fichier) |
| Recommandé | Permet de déterminer la direction de l’appel (inbound/outbound) |
| Recommandé | Permet de déterminer la direction de l’appel et d’identifier le contact |
| Recommandé | Facilite l’association automatique des utilisateurs Modjo/Vocalcom |
3. Associer les utilisateurs
Rendez-vous dans l’onglet « Utilisateurs » de l’intégration Vocalcom.
Pour chaque utilisateur Modjo, sélectionnez l'agent Vocalcom correspondant afin d’assurer la bonne attribution des appels importés, au bon utilisateur Modjo.
4. Fonctionnement de l’intégration
Import automatique :
Une fois l’intégration configurée, Modjo se connecte automatiquement au serveur SFTP Vocalcom toutes les 20 minutes environ pour récupérer les nouveaux enregistrements d’appels.Attribution des appels :
Les appels importés sont associés aux bons utilisateurs Modjo selon les correspondances définies à l’étape précédente –{ID_AGENT}
Détermination du sens de l’appel :
Grâce aux champs{DNIS}
et{TEL_CLIENT}
dans le nom du fichier, Modjo peut automatiquement déterminer si l’appel est entrant (inbound) ou sortant (outbound).Dans le cas où ces paramètres sont disponible, un tag "inbound/outbound" sera automatiquement associé à l'appel.
Identification du contact :
Le champ{TEL_CLIENT}
permet d’identifier le contact appelé ou appelant.
Si ce champ est absent, un contact « Unknown » sera créé par défaut pour l’appel importé.Sécurité :
Les identifiants SFTP sont stockés de façon sécurisée et ne sont utilisés que pour l’importation des appels.
5. Conseils & Bonnes pratiques
Si vous modifiez les identifiants SFTP, pensez à mettre à jour la configuration dans Modjo.
Vérifiez régulièrement que l’association des utilisateurs est correcte, surtout en cas d’arrivée ou de départ dans vos équipes.
En cas d’erreur de connexion ou d’import, un message d’alerte s’affichera dans l’interface Modjo.
Assurez-vous que la structure de vos dossiers et le nommage de vos fichiers sont cohérents et conformes à la configuration Hermes.
Si vous préférez ne pas utiliser l’intégration Vocalcom, vous pouvez importer directement les appels via notre API.