đš PrĂ©requis : Avant de commencer l'intĂ©gration, assurez-vous que vous disposez des Ă©lĂ©ments suivants :
les identifiants SFTP du serveur contenant les appels Vocalcom
un accĂšs administrateur Ă un compte Modjo
âčïž Cette intĂ©gration est en Alpha. Contactez votre interlocuteur Modjo pour l'activer.
â±ïž 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 (v2) dans la liste des intégrations disponibles.
Cliquez sur la carte pour démarrer la configuration.
C. Saisir les informations SFTP, puis transmettre les chemins dâaccĂšs aux enregistrements
Dans Modjo, saisissez vos identifiants SFTP : serveur, port, utilisateur et mot de passe.
Transmettez ensuite votre dirPath (chemin des dossiers dâenregistrements) et votre filePath (modĂšle de nommage des fichiers) Ă votre interlocuteur Modjo, qui les configure pour vous. Ils ne se saisissent pas dans l'interface Modjo.
â ïž 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.
