Cet article explique comment connecter un système de téléphonie VoIP 3CX auto-hébergé à Aethex AI. À l'issue de cette procédure, les agents vocaux intelligents d'Aethex AI pourront traiter vos flux d'appels entrants et sortants via votre infrastructure 3CX.

Aethex AI : la plateforme d'IA vocale nouvelle génération pour les entreprises africaines

Aethex AI est optimisé pour les marchés émergents et propose des voix localisées adaptées aux entreprises opérant sur l'ensemble du continent africain. Le canal téléphonique reste le vecteur privilégié de la relation client. Au Nigeria, qui compte 192 millions d'abonnements mobiles actifs, l'appel vocal constitue le standard incontournable pour le recouvrement, l'acquisition de prospects ou le support technique.

Avec Aethex AI, déployez des agents conversationnels intelligents capables d'interagir dans la langue locale de vos clients grâce à un catalogue de plus de 100 voix. Nos agents s'intègrent nativement à vos flux de travail existants : infrastructures télécoms, applicatifs métiers et plateformes de helpdesk telles que WhatsApp, Zoho CRM et Freshdesk.

Pour la gestion de leur téléphonie, les entreprises s'appuient généralement sur des architectures PBX et SBC tierces, notamment la solution 3CX. Aethex AI s'interface directement avec ces systèmes afin d'injecter une couche d'intelligence artificielle vocale au cœur de votre réseau télécom.

3CX est une solution de communication d'entreprise de référence, adoptée par plus de 350 000 organisations dans 190 pays. En mode auto-hébergé, 3CX permet à Aethex AI de gérer l'intégralité des interactions vocales (entrantes et sortantes) entre vos clients et nos agents IA.

Options de déploiement de l'infrastructure 3CX

Au-delà du modèle auto-hébergé, 3CX propose des offres SaaS managées : 3CX SMB et Hosted by 3CX. Toutefois, seule la version auto-hébergée permet l'interconnexion via un trunk SIP générique, prérequis indispensable pour l'intégration d'Aethex AI. Ce guide se concentre donc exclusivement sur l'implémentation de la version 3CX auto-hébergée.

Prérequis techniques

Avant de procéder à la configuration, assurez-vous de disposer des éléments suivants :

• Des accès administrateur à votre instance 3CX auto-hébergée.

• Une adresse IP publique statique ou un FQDN public pointant vers votre serveur 3CX. Les adresses IP privées ne sont pas supportées par la plateforme Aethex.

• Un compte Aethex actif avec au moins un agent configuré. Si vous n'avez pas encore de compte, vous pouvez planifier un échange avec nos équipes pour finaliser votre inscription.

• Un raccordement télécom opérationnel (trunk SIP opérateur) et les paramètres d'authentification associés.

• Le numéro de téléphone fourni par votre opérateur qui sera assigné à l'agent IA, de préférence au format international E.164.

Configuration de 3CX : routage des appels entrants

Cette procédure consiste à créer un compte utilisateur (extension) dans 3CX dédié à l'agent IA, puis à y acheminer les appels. Aethex s'enregistrera sur cette extension 3CX à la manière d'un softphone.

Création de l'extension de l'agent

Accédez à l'onglet Utilisateurs et cliquez sur Ajouter un utilisateur. Dans la section Général, conservez le numéro d'Extension proposé par défaut par 3CX, puis renseignez les champs Prénom et Nom pour identifier l'agent (par exemple : Aethex AI Agent). Laissez le champ SDA associée(s) vide pour l'instant.

Dans l'onglet Options, décochez l'option Bloquer les connexions hors tunnel (Non sécurisé !) et cochez Le PBX délivre l'audio. L'agent Aethex devant se connecter à distance, le PBX bloquerait la session sans cette modification. Configurez le Mode SRTP sur Activé. Aethex appliquant un chiffrement des flux médias sur les appels sortants, une désactivation du SRTP sur 3CX entraînerait des appels sans signal audio (silence). Cliquez sur Enregistrer.

Sélectionnez à nouveau l'utilisateur créé dans la liste des Utilisateurs, accédez à l'onglet Téléphone IP, puis cliquez sur Configurer un téléphone. Choisissez l'option Je configurerai le téléphone moi-même et cliquez sur Suivant.

Sélectionnez l'interface réseau correspondante (LAN local / VPN) associée au FQDN de votre 3CX, puis cliquez sur Ajouter un téléphone.

L'onglet Téléphone IP affiche désormais les paramètres d'authentification de l'extension. Dans le champ ID d'authentification, remplacez la chaîne générée par le numéro d'extension de l'utilisateur (par exemple 101) et conservez le Mot de passe généré. Aethex nécessitant un identifiant unique, le serveur 3CX refusera l'enregistrement SIP si ce champ ne correspond pas strictement au numéro d'extension.

Conservez précieusement ces données techniques ; elles devront être renseignées dans la console Aethex :

Cliquez sur Enregistrer. L'utilisateur apparaît désormais dans la liste des Utilisateurs avec un statut de type Téléphone IP générique.

Autorisation des adresses IP d'Aethex (Whitelist)

La sécurité intégrée de 3CX bloque automatiquement pour une durée de 24 heures toute adresse IP initiant des tentatives d'authentification infructueuses. Il est indispensable d'autoriser explicitement les adresses de nos serveurs SIP Edge afin d'éviter tout blocage intempestif.

Accédez à la section Avancé, puis Liste noire IP, et cliquez sur Ajouter. Saisissez l'adresse 13.63.135.167, configurez l'action sur Autoriser et validez. Répétez l'opération pour l'adresse 51.21.123.34.

Configuration du Trunk SIP Opérateur

Le trunk opérateur permet d'acheminer vos numéros de téléphone vers votre instance 3CX. Cette étape décrit l'association du trunk à l'extension de l'agent IA.

Allez dans Voix et chat et cliquez sur Ajouter un Trunk. Sélectionnez le pays d'enregistrement ou choisissez Worldwide si votre opérateur n'est pas référencé. Dans le menu déroulant Fournisseur, sélectionnez votre opérateur de télécoms. Si celui-ci n'apparaît pas, optez pour Generic VoIP Provider (Registration) (authentification par identifiant/mot de passe) ou Generic SIP Trunk (IP Based) (authentification par appairage d'adresses IP). Cliquez sur OK.

Le formulaire de configuration s'ouvre sur l'onglet Général. Renseignez les paramètres réseau, d'authentification et d'adressage fournis par votre opérateur. Configurez la Route par défaut sur Utilisateur et sélectionnez l'extension de l'agent Aethex. Ce paramètre garantit que tout appel entrant ne correspondant à aucune règle SDA spécifique sera directement routé vers l'agent IA.

Cliquez sur Enregistrer. Revenez sur la fiche de l'utilisateur de l'agent, et dans l'onglet Général, associez le numéro principal du trunk dans le champ SDA associée(s). Validez en cliquant sur Enregistrer.

Note : Certains opérateurs télécoms transmettent les numéros d'appel au format national. Dans ce cas, 3CX peut ne pas faire correspondre la SDA et appliquera la route par défaut. La redirection systématique de la route par défaut vers l'agent sécurise l'acheminement des flux.

Configuration sur la console Aethex AI

Ces étapes permettent d'activer le raccordement SIP sur la plateforme Aethex en utilisant les identifiants de l'extension 3CX.

Connectez-vous à la console d'administration Aethex, puis accédez à l'onglet Telephony. Sélectionnez SIP Trunks, puis cliquez sur Connect a phone line.

Dans le champ Trunk name, attribuez un nom explicite à cette interconnexion. Dans Phone numbers (DIDs), indiquez le numéro de téléphone associé à l'agent dans votre 3CX. Les trunks basés sur enregistrement n'acceptent qu'un seul numéro d'appel. Dans Answered by, sélectionnez l'agent IA qui prendra en charge les appels sur cette ligne.

Pour le mode d'Authentication, choisissez Registered login (softphone-style). Ce protocole bi-directionnel autorise l'émission et la réception d'appels. Dans le champ Carrier registrar address, indiquez le FQDN et le port SIP de votre serveur 3CX (par exemple : centi-test.3cx.ng:5060).

Renseignez l'adresse IP publique de votre serveur 3CX dans le champ Allowed source addresses. Dans les champs SIP username et SIP password, reportez les valeurs d'authentification de l'extension 3CX générées précédemment (Auth ID et Password).

Configurez le protocole de Transport sur UDP ou TCP. Pour le paramètre Outbound dial format, sélectionnez Digits (no +) (ex : 12025550143). En effet, 3CX applique des règles de réécriture sur les préfixes en + qui peuvent entraîner des rejets d'appels de la part de votre opérateur télécom. Utilisez l'option National (ex : 02025550143) uniquement si votre opérateur impose ce format de numérotation.

Cliquez sur Connect trunk. Le trunk s'affiche désormais dans votre liste avec le statut Active et basculera sur Registered sous un délai d'une minute. Côté 3CX, l'extension de l'agent doit apparaître avec un indicateur vert dans la liste des Utilisateurs.

Attention : Les paramètres de registrar, de protocole de transport, de mode d'authentification et de chiffrement des flux médias ne sont plus modifiables une fois l'enregistrement initial effectué. Pour toute modification de cette nature, il conviendra de créer une nouvelle connexion de ligne.

Spécifications techniques du SIP Edge d'Aethex AI

Si votre infrastructure 3CX est protégée par un pare-feu (Firewall), vous devez autoriser les flux en provenance du SIP Edge d'Aethex AI. Ces paramètres s'appliquent également dans le cas d'une interconnexion par Trunk SIP direct.

Les requêtes de signalisation pouvant être initiées depuis l'une ou l'autre de nos adresses IP, l'autorisation des deux hôtes est requise. Vous pouvez interroger la zone DNS de l'hôte sip.aethexai.com pour obtenir la liste à jour de nos adresses IP publiques.

La plage de ports UDP de 9000 à 10999 correspond à la configuration par défaut de 3CX pour les flux médias. Vous pouvez valider vos ports de média spécifiques sur l'interface d'administration 3CX dans la section Ports, à la ligne Média.

Configuration de 3CX : routage des appels sortants

Pour permettre à l'agent IA d'initier des appels externes vers vos clients via votre opérateur, vous devez définir une règle de sortie sur 3CX.

Allez dans la section Règles sortantes et cliquez sur Ajouter. Nommez la règle (ex. : Aethex Agent). Dans le champ Appels depuis l'extension / les extensions, renseignez le numéro de l'extension de l'agent. Laissez les champs de préfixes et de longueur vides afin de ne pas restreindre les numéros appelables. Dans la section Passer des appels sortants via, associez la Route 1 à votre trunk opérateur actif, puis cliquez sur Enregistrer.

Si des règles sortantes globales sont déjà actives pour votre opérateur, vous pouvez simplement ajouter l'extension de l'agent à la liste des extensions autorisées. 3CX applique les règles séquentiellement selon leur ordre d'apparition dans la table.

Notez que l'affichage du numéro d'appelant (CLI) présenté à vos clients reste régi par les paramètres de votre trunk opérateur sur 3CX.

Veillez également à ce que les destinations géographiques de vos clients soient activées dans la section Avancé > Codes pays autorisés du PBX 3CX.

Validation et Tests d'appels

Validation des flux entrants : Composez votre numéro d'accueil depuis un terminal externe. L'agent IA doit décrocher et engager la conversation. Dans l'interface 3CX, l'appel doit apparaître dans les Rapports au niveau de l'extension de l'agent. Le tableau de bord d'Aethex affichera l'historique de l'appel ainsi que l'enregistrement et la transcription textuelle.

Validation des flux sortants : Depuis la console Aethex, lancez une campagne ou un appel de test vers votre numéro mobile. Votre terminal doit sonner et l'agent IA doit interagir dès le décroché. Sur 3CX, l'appel est tracé dans les Rapports comme appel Sortant, passant par la règle sortante et le trunk opérateur configurés.

Si ces scénarios de test fonctionnent nominalement, votre interconnexion est pleinement opérationnelle. En cas d'anomalie, référez-vous à la section de diagnostic ci-dessous.

Résolution des incidents (Troubleshooting)

Pour faciliter l'analyse, consultez le menu Rapports de 3CX pour visualiser le routage de chaque appel, ou le Journal d'événements de 3CX pour détecter les éventuels rejets d'appels ou déconnexions de trunks.

Conclusion

Votre infrastructure VoIP 3CX est désormais interconnectée avec la plateforme Aethex AI. Vos agents vocaux intelligents gèrent désormais en toute autonomie vos interactions clients entrantes et sortantes, en s'appuyant sur vos ressources télécoms existantes.

L'intégration de l'IA vocale lève les contraintes de scalabilité liées aux ressources humaines. Vous pouvez adapter votre capacité de traitement d'appels instantanément en augmentant le nombre de canaux SIP et d'agents selon vos besoins.

Ressources complémentaires :

• API SIP d'Aethex

• Documentation sur les Trunks SIP

• Gestion des extensions utilisateurs