Ajoutez facilement vos appels ou réunions dans Modjo, soit unitairement via l'interface, soit en masse via l'API Modjo.

Introduction

L'import manuel vous permet d'ajouter des appels ou réunions qui n'ont pas été automatiquement importés dans Modjo. Cette fonctionnalité peut être particulièrement utile dans des scénarios comme :

Enregistrer une session de formation
Importer une réunion que vous avez enregistrée mais que vous n'avez pas organisée
Réviser un appel enregistré avant de l'importer dans Modjo
Téléverser des appels passés via un système de téléphonie non intégré à Modjo
Migrer un volume important d'enregistrements historiques

Méthode 1 : Import unitaire via l'interface Modjo

Etape 1 : Uploader votre enregistrement

Règles d'affichage de l'option "Importer un appel"

Administrateur avec ou sans licence :
- L'option "Importer un appel" est toujours affichée. ✅
Manager ou utilisateur avec licence :
- L'option "Importer un appel" est affichée. ✅
Manager ou utilisateur sans licence :
- L'option "Importer un appel" est masquée. ❌

💡 Avant d'importer manuellement un appel, assurez-vous que l'appel respecte le critère de durée minimale défini par votre Account Manager ou l'administrateur de votre organisation.

Exemple : Si la durée minimale est fixée à 2 minutes, les appels plus courts ne peuvent pas être importés manuellement.

(Pour plus de détails ou pour mettre à jour ce paramètre, veuillez contacter votre Account Manager ou administrateur.)

Récupérez l’enregistrement depuis le cloud de votre fournisseur (ex : Zoom, Google Meet).
Assurez-vous que le fichier est au format wav, mp3, m4a, mp4
Accédez à Home > Cliquez sur les trois petits points situés en haut à droite de l'écran < Sélectionnez Import call.

Etape 2 : Importer votre appel ou réunion

🚨 Conditions préalables :

Licence d'enregistrement requise : Vous devez disposer d’une licence d'enregistrement
Hôte obligatoire : Renseignez le nom d’un hôte, par exemple une adresse e-mail ou un numéro de téléphone.
Contact client obligatoire : Veuillez indiquer un contact client, comme une adresse e-mail ou un numéro de téléphone. Si ce contact ne s’affiche pas dans la liste déroulante, vous pourrez tout de même l’ajouter manuellement. Il sera alors associé à l'appel sur Modjo.
Attention, il ne sera pas ajouté à votre CRM si celui-ci n’a pas été créé au préalable, mais vous pourrez l'ajouter à votre CRM ultérieurement.
Ne fermez pas la page : Attendez que le message "Uploading call" disparaisse avant de fermer la page pour garantir un téléchargement complet.

💡 Bon à savoir:

Import : C'est l'étape où Modjo récupère l'appel (audio ou vidéo), génère une transcription, associe les données pertinentes, et rend le tout accessible au client sur Modjo.

Upload : Il s'agit de l'action consistant à ajouter un enregistrement (appel ou visioconférence) sur le serveur de Modjo.

Dépannage

A. Le fichier ne se télécharge pas.
Assurez-vous que le fichier est dans un format compatible (mp3 ou mp4).

B. Le fichier n'apparaît sur Modjo pas après l'import.
Essayez de rafraîchir la page ou vérifiez votre connexion Internet.

C. Si le message d’erreur suivant s’affiche : "contacts contain not a valid id, email, or crmContact".

Cela signifie que vous devez obligatoirement saisir un contact valide (adresse e-mail ou numéro de téléphone) dans le champ prévu à cet effet.

Méthode 2 : Import en masse via l'API Modjo

Pour importer plusieurs appels simultanément ou automatiser vos imports, utilisez l'API Modjo. Cette méthode est idéale pour migrer des enregistrements historiques ou intégrer Modjo dans vos workflows techniques.

⚙️ Important : Cette méthode nécessite des compétences techniques. Nous vous recommandons de réaliser cet import en collaboration avec un membre de votre équipe technique ou votre service IT si besoin.

Prérequis

Accès à vos données : Fichiers d'enregistrement (mp3, wav, mp4) ou URL de l'enregistrement + métadonnées associées (date, email de l'utilisateur + email/numéro de téléphone du/des contacts)
Accès à votre espace Modjo
Connaissance basique des API REST

Comment fonctionne l'upload via l'API ?

L'upload d'un appel sur Modjo se fait en 2 étapes, avec deux cas d'usage possibles :

Cas d'usage 1 : Fournir une URL d'enregistrement

Envoyez une requête POST à l'endpoint avec les métadonnées de l'appel, incluant l'URL de l'enregistrement (paramètre recordingUrl)
Vous recevrez une réponse de confirmation avec {success: true}
Modjo téléchargera l'enregistrement depuis l'URL fournie dans les 30 minutes (généralement en moins de 5 minutes)

Cas d'usage 2 : Recevoir une URL signée pour l'upload

Envoyez une requête POST à l'endpoint avec les métadonnées de l'appel (sans recordingUrl)
Vous recevrez une URL signée pour uploader le fichier d'enregistrement
Utilisez cette URL pour uploader votre fichier avec une requête PUT

💡 Dans les deux cas, les métadonnées envoyées dans la première requête seront automatiquement associées à l'enregistrement dans Modjo.

Étapes à suivre

Créer une clé API : Générez une clé API depuis votre espace Modjo (Paramètres > Intégrations > API)
Rédiger un script d'envoi : Développez un script qui envoie les enregistrements (fichier ou URL) et les métadonnées à l'API de Modjo

🔗 Pour les détails complets (structure de la requête, exemples de code, gestion des erreurs), merci de consulter notre documentation technique : Documentation API Modjo - Upload Call

Paramètres clés de l'API

Endpoint : POST https://api.modjo.ai/v1/calls/upload

Headers requis :

Authorization: Bearer YOUR_API_KEY
Content-Type: multipart/form-data (si envoi de fichier)
Content-Type: application/json (si envoi d'URL)

Paramètres obligatoires

users : Liste des identifiants utilisateurs Modjo (array, un seul utilisateur pour le moment)
contacts : Liste des identifiants contacts à associer à l'appel (integer, string ou objet CRM)
date : Date et heure de l'appel au format ISO 8601
fileExtension : Extension du fichier (wav, mp3, mpeg, m4a, mp4, webm)
tags : Array de tags associés à l'appel (non vide)

Paramètres facultatifs

name : Titre de l'appel
duration : Durée en secondes (minimum 120s par défaut)
recordingUrl : URL du fichier d'enregistrement (alternative à l'upload direct)
account : Identifiant du compte CRM à associer
deal : Identifiant de l'opportunité CRM à associer
direction : Direction de l'appel (inbound ou outbound, par défaut inbound)
provider : Nom du fournisseur d'appel (par défaut manual)

Complexité et temps estimé

Complexité : Faible

Temps estimé : 1-2 jours (expérimentation + tests + migration des données)

💡 Recommandation : Testez d'abord avec 2-3 appels avant de migrer l'ensemble de vos enregistrements.

Importer un appel/ réunion manuellement