🚨Prerequisites: Before starting the integration, ensure you have:
SFTP credentials of the Vocalcom calls repository.
Administrator access to a Modjo account.
⏱️ Estimated Setup Time: Under 5 minutes
Configuring Modjo
A. Access Integrations in Modjo
Log in to your Modjo account
Navigate to the integrations page.
B. Add the Vocalcom Integration
Search for “Vocalcom” in the list of available integrations.
Click on the Vocalcom card or button to start the configuration.
C. Enter SFTP Information and Recording Paths
During configuration, you must provide:
SFTP credentials (host, port, username, password)
The dirPath (directory path for call recordings)
The filePath (file naming pattern for call recordings)
⚠️ Important:
The dirPath and filePath patterns must be strictly identical to those configured in your Hermes interface.
If in doubt, check your Hermes configuration or ask your technical administrator.
1. dirPath
The directory path on the SFTP server where call recordings are stored.
It must contain the following variables, in this order:
{YYYY_LT}/{MM_LT}/{DD_LT}/{ID_AGENT}(year, month, day, agent)This organization allows Modjo to optimize the search and import of new calls by only scanning folders for recent dates and agents with a Modjo license.
Example:
/root-path/{YYYY_LT}/{MM_LT}/{DD_LT}/{ID_AGENT}2. filePath
The naming pattern for call recording files inside each directory.
The following fields are mandatory in the file name (order does not matter):
{INDICE}: unique call identifier (or increment){YYYYMMDD}: call date{HHMMSS}: call time{ID_AGENT}: agent identifier
The following fields are strongly recommended:
{DNIS}and{TEL_CLIENT}:Allow Modjo to automatically determine the call direction (inbound or outbound)
TEL_CLIENT: Also allows Modjo to identify the called or calling contact.
If this field is missing, Modjo will create an “Unknown” contact by default for the imported call.
{NAME_AGENT}:Makes it easier to automatically match users, but is not required if you know which agent each
{ID_AGENT}refers to.
Example naming pattern (adapt to your Hermes configuration):
{ID_CAMP}#{ID_AGENT}#{NAME_AGENT}#{YYYYMMDD}#{HHMMSS}#{INDICE}#{TEL_CLIENT}#{DNIS}.wav3. Field Summary Table
Field | Required | Purpose |
| Yes | Year (directory) |
| Yes | Month (directory) |
| Yes | Day (directory) |
| (Directory) Yes | Agent identifier (directory) |
— | — | — |
| Yes | Unique call identifier (file) |
| Yes | Call date (file) |
| Yes | Call time (file) |
| (File) Yes | Agent identifier (file) |
| Recommended | Determines call direction (inbound/outbound) |
| Recommended | Determines call direction and identifies the contact |
| Recommended | Eases automatic user matching between Modjo and Vocalcom |
3. Associate Users
Go to the “Users” tab of the Vocalcom integration.
For each Modjo user, select the corresponding Vocalcom agent to ensure correct assignment of imported calls.
4. How the Integration Works
Automatic import:
Once configured, Modjo will automatically connect to the Vocalcom SFTP server approximately every 20 minutes to retrieve new call recordings.Call assignment:
Imported calls are assigned to the correct Modjo users based on the mappings defined in the previous step –{ID_AGENT}.Call direction detection:
Thanks to the{DNIS}and{TEL_CLIENT}fields in the file name, Modjo can automatically determine if the call is inbound or outbound.
If these parameters are available, an “inbound/outbound” tag will be automatically associated with the call.Contact identification:
The{TEL_CLIENT}field allows Modjo to identify the called or calling contact.
If this field is missing, an “Unknown” contact will be created by default for the imported call.Security:
SFTP credentials are stored securely and are only used for importing calls.
5. Tips & Best Practices
If you change your SFTP credentials, remember to update the configuration in Modjo.
Regularly check that user associations are correct, especially when team members join or leave.
In case of connection or import errors, an alert message will appear in the Modjo interface.
Make sure your folder structure and file naming are consistent and match your Hermes configuration.
If you prefer not to use the Vocalcom integration, you can directly import calls through our API.