---
title: Utiliser la transcription PBX
excerpt: Créer des identifiants API 3CX, les renseigner dans CX-Engine et choisir les extensions qui utilisent les transcriptions générées par votre PBX.
order: 4
---

## 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](https://www.3cx.com/docs/configuration-rest-api/).
- 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**.

> [!NOTE]
> 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.

> [!WARNING]
> 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 :

| Champ CX-Engine | Valeur issue de 3CX |
|---|---|
| **Identifiant client xAPI** | Le Client ID |
| **Secret client xAPI** | L'API key |

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](/fr/docs/insights-ai/introduction#deux-façons-dobtenir-les-transcriptions).

## Dépannage

| Problème | Que vérifier |
|---|---|
| L'API 3CX renvoie une erreur 403 | L'application API doit avoir le rôle **System Owner** : aucun autre rôle ne donne accès aux enregistrements. |
| CX-Engine signale des identifiants xAPI manquants | Les deux champs xAPI doivent être renseignés sur l'hôte utilisé par l'appel. |
| L'enregistrement ne peut pas être transcrit | Vérifiez qu'un fournisseur d'IA est configuré sur votre 3CX. |