Passer au contenu principal

Vocalcom

Importer automatique vos appels Vocalcom sur Modjo

Mis à jour aujourd’hui

🚨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

  1. Connectez-vous à votre espace Modjo avec un compte administrateur.

  2. Naviguez vers la page « Intégrations » depuis le menu principal.

B. Ajouter l’intégration Vocalcom

  1. Recherchez « Vocalcom » dans la liste des intégrations disponibles.

  2. 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

{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


3. Associer les utilisateurs

  1. Rendez-vous dans l’onglet « Utilisateurs » de l’intégration Vocalcom.

  2. 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.


Avez-vous trouvé la réponse à votre question ?