🚨 Prérequis : Avant de commencer l'intégration, assurez-vous que vous disposez des éléments suivants :

⏱️ Durée: < 5min en moyenne

1. Étapes d’intégration

A. Accéder à la section Intégrations

Recherchez « Vocalcom » dans la liste des intégrations disponibles.
Cliquez sur la carte ou le bouton correspondant à Vocalcom pour démarrer la configuration.

Lors de la configuration, il est obligatoire de renseigner :

⚠️ 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.

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}

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

Champ	Obligatoire	Rôle
`{YYYY_LT}`	Oui	Année (dossier)
`{MM_LT}`	Oui	Mois (dossier)
`{DD_LT}`	Oui	Jour (dossier)
`{ID_AGENT}` (Dossier)	Oui	Identifiant de l’agent (dossier)
----	----	----
`{INDICE}`	Oui	Identifiant unique de l’appel (fichier)
`{YYYYMMDD}`	Oui	Date de l’appel (fichier)
`{HHMMSS}`	Oui	Heure de l’appel (fichier)
`{ID_AGENT}` (fichier)	Oui	Identifiant de l’agent (fichier)
`{DNIS}`	Recommandé	Permet de déterminer la direction de l’appel (inbound/outbound)
`{TEL_CLIENT}`	Recommandé	Permet de déterminer la direction de l’appel et d’identifier le contact
`{NAME_AGENT}`	Recommandé	Facilite l’association automatique des utilisateurs Modjo/Vocalcom

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.

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.

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.