Utiliser la transcription PBX

#Présentation

Avec la transcription PBX, CX-Engine récupère les transcriptions d'appels générées par votre système téléphonique 3CX via son API de configuration (xAPI), puis y applique son analyse IA. Pour cela, CX-Engine a besoin d'identifiants API pour votre PBX.

#Prérequis

• Un système téléphonique 3CX V20. La transcription PBX n'est pas disponible pour les autres PBX.
• Une licence 3CX incluant l'API de configuration. Vérifiez les conditions en vigueur dans la documentation 3CX.
• Un fournisseur d'IA configuré sur votre 3CX, afin qu'il puisse transcrire les enregistrements.
• Un abonnement Insights AI Lite actif, avec un siège par extension.

#Créer les identifiants dans 3CX

1. Dans la console d'administration 3CX, allez dans Integrations > API et cliquez sur Add.
2. Saisissez un Client ID et notez-le. 3CX utilise aussi cette valeur comme numéro d'extension (DN) : choisissez-en une qui n'est pas déjà utilisée.
3. Cochez 3CX Configuration API Access.
4. Sélectionnez le Department des extensions à analyser, et le rôle System Owner.
5. Enregistrez l'application, puis copiez l'API key.

L'API 3CX ne donne accès aux enregistrements qu'avec le rôle System Owner. Avec tout autre rôle, même un rôle qui voit les enregistrements dans la console 3CX, CX-Engine reçoit une erreur 403 :

Rôle	Accès aux enregistrements par l'API
User, Receptionist, Supervisor	✗
Department Administrator, Manager, Owner	✗
System Admin	✗
System Owner	✓

CX-Engine se contente de lire les enregistrements et de demander à 3CX de les transcrire. Il ne modifie jamais la configuration de votre 3CX.

3CX n'affiche l'API key qu'une seule fois. Copiez-la avant de quitter la page. Si vous la perdez, vous devrez en générer une nouvelle.

#Renseigner les identifiants dans CX-Engine

1. Dans CX-Engine, ouvrez le menu Hôtes, puis ouvrez votre PBX et cliquez sur Modifier.
2. Dans la section Authentification, renseignez les champs suivants :

3. Enregistrez l'hôte.

Le menu Hôtes est réservé aux comptes administrateurs. Si vous ne le voyez pas, demandez à votre administrateur CX-Engine ou à votre revendeur de renseigner les identifiants.

#Choisir les extensions

1. Allez dans Connecteur CRM > Paramètres et vérifiez que l'option Activer Insights AI est active.
2. Ajoutez les extensions à la liste Extensions activées pour les Insights, transcription via PBX.
3. Enregistrez les paramètres.

Une extension utilise la transcription PBX uniquement si elle figure dans cette liste. Les extensions de la liste CX-Engine continuent d'utiliser la transcription CX-Engine.

#Dépannage