3CX v20
| À qui est-ce adressé ? | Permissions et licences requises |
|---|---|
| • Aux administrateurs qui gèrent les intégrations de l'entreprise et disposent d'un accès IT au serveur 3CX. | • Licence requise : selon votre plan, vérifiez la disponibilité dans Paramètres > Intégrations. • Droits administrateur sur votre compte Leexi. • Serveur 3CX auto-hébergé (non hébergé par 3CX) sous OS Debian. • Accès IT à votre serveur 3CX. |
Guide d'utilisation
Durée estimée : 20 minutes.
Activer l'enregistrement des appels
Rendez-vous dans la console d'administration 3CX, sous Users.

Cliquez sur chaque utilisateur, allez dans Options et sélectionnez l'option Call Recording - Record external calls only. Vous pouvez aussi choisir d'enregistrer tous les appels, mais seuls les appels externes seront importés dans Leexi.

Configurer l'archivage distant
Sous Admin → System → Storage, vérifiez si Enable Remote Data Storage & Archive est activé. S'il est désactivé, vous pouvez le laisser tel quel. S'il est activé, vérifiez les points suivants.

- Vous pouvez laisser le Location Type tel quel, ou le configurer selon vos préférences.
- Si le Data Archiving des enregistrements est activé, assurez-vous que « Auto-archiving older than » est réglé sur au moins 1 jour.
- Pour le Temporary recording location, sélectionnez
/var/lib/3cxpbx/Instance1/Data/Recordingsou l'emplacement de votre choix. Si vous choisissez un autre emplacement, copiez la valeur : elle vous servira lors de l'activation de l'intégration.
Cliquez sur Save.
Activer les journaux d'appels (CDR)
Dans la console d'administration 3CX, allez dans Advanced → CDR et sélectionnez Enable CDR, avec l'option Single files for each call (et non Single file for all calls !).

Laissez les champs de sortie CDR tels que configurés par défaut (l'ordre des champs doit être identique à la capture ci-dessus).
Créer un utilisateur avec accès SSH
L'intégration 3CX de Leexi nécessite un accès SSH à votre serveur pour récupérer les enregistrements d'appels et les fichiers CDR. L'utilisateur avec lequel Leexi accédera à votre serveur doit avoir un accès en lecture au dossier de données de votre serveur 3CX et à son contenu (typiquement /var/lib/3cxpbx/Instance1/Data/).
Dans Leexi, allez dans Paramètres > Intégrations > 3CX, cliquez sur Ajouter et copiez la clé publique.

Connectez-vous ensuite à votre serveur PBX, créez un utilisateur (nom suggéré : « leexi ») et ajoutez la clé publique aux clés SSH autorisées. Sur Debian, exécutez :
sudo useradd -m leexi -s /bin/bash
sudo passwd leexi
# set password
# Add leexi to the phonesystem group to ensure it has access to the necessary files
sudo usermod -aG phonesystem leexi
su leexi
# enter password
cd /home/leexi
mkdir ~/.ssh/
vim ~/.ssh/authorized_keys
# paste the public key and save (:wq)
chmod 700 ~/.ssh && chmod 600 ~/.ssh/authorized_keys
Ajuster les règles de pare-feu
Ouvrez un port (22 par défaut) et ajoutez les adresses IP suivantes à la liste blanche : 13.39.26.202, 15.188.160.114 et 15.236.114.242.
Activer l'intégration
Dans Leexi, renseignez l'hôte (IP publique fixe ou DNS), le port et le nom d'utilisateur dans l'intégration 3CX, puis cliquez sur Enregistrer. L'activation échoue si Leexi ne parvient pas à se connecter à votre serveur avec les informations fournies.
Associer les utilisateurs aux extensions
Une fois l'intégration 3CX activée, Leexi récupère toutes les extensions pour lesquelles au moins un appel a été enregistré après l'activation des journaux CDR. Ces extensions doivent être associées à l'utilisateur Leexi correspondant. Une extension n'apparaît dans la liste que si elle a au moins un appel récent.
Allez dans Paramètres > Intégrations > 3CX, cliquez sur Gérer, associez les utilisateurs Leexi à leur extension, puis Enregistrez.

Vos prochains appels 3CX apparaîtront dans Leexi ! Les appels des 6 dernières heures seront également importés, mais pas tout l'historique.
Questions récurrentes
Points de vigilance
- Les appels internes (entre différents utilisateurs 3CX) ne sont pas importés dans Leexi.
- Seuls les appels externes sont importés dans Leexi, même si vous enregistrez tous les appels.
- À l'activation, seuls les appels des 6 dernières heures sont importés, pas tout l'historique.
- Une extension n'apparaît dans la liste d'association que si au moins un appel récent a été enregistré avec elle.