> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://support.wildixapp.com/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # Configuration - Connexion PBX # Connexion au PBX Wildix WildixApp communique avec votre PBX Wildix pour récupérer les données d'appels en temps réel et historiques. Deux méthodes d'authentification sont disponibles selon votre version de votre instance PBX Wildix. --- ## Prérequis communs Avant de configurer la méthode d'authentification, renseignez les informations d'accès au PBX dans la section **Serveur PBX** : ![](https://storage.crisp.chat/users/helpdesk/website/-/3/f/4/b/3f4b7f96c6365c00/capture-decran-2026-04-23-a-11_a2wfmm.png) | Champ | Description | | ---- | | Protocole | `http://` ou `https://` | | Hôte | Nom de sous domaine de votre instance PBX Cloud | | Port | Port d'écoute de l'API (443 par défaut) | --- ## Méthode 1 — OAuth2 (recommandée) ![](https://storage.crisp.chat/users/helpdesk/website/-/3/f/4/b/3f4b7f96c6365c00/image_6mr2g2.png) OAuth2 est la méthode recommandée pour les PBX à partir des versions **6.10.20250609.6** et **7.02.20250609.3**. Elle repose sur un jeton d'accès à durée de vie limitée, à renouveler manuellement par l'administrateur du PBX. | L'activation de l'OAuth2 permet notamment à vos utilisateurs d'utiliser le mécanisme d'authentification configuré sur serveur PBX plutôt que de saisir un mot de passe. ### Etape 1 - Créer une application OAuth2 sur l'interface d'administration du PBX 1. Allez dans **PBX > Integration** puis onglet **Applications > OAuth 2.0**. 2. Appuyer sur le bouton "+ Ajouter" 3. Renseignez les champs avec les informations affichées dans l'encart jaune : * **Nom d'application** : `wildixapp` * **URI de Redirection** : `https://VOTREAPP.yourapp.fr/wildix/callback` * **Date d'expiration** : `365 days` 4. Cliquez sur **Sauvegarder**. ![](https://storage.crisp.chat/users/helpdesk/website/-/3/f/4/b/3f4b7f96c6365c00/image_f6l6f.png) Dans la fenêtre qui s'affiche après la soumission du formulaire, récupérez l'**ID d'application** et la **Clé Secrète** : ![](https://storage.crisp.chat/users/helpdesk/website/-/3/f/4/b/3f4b7f96c6365c00/image_1y5a63o.png) Après la déclaration de l'application dans votre PBX, retournez dans la page de configuration de votre application WildixApp. ![](https://storage.crisp.chat/users/helpdesk/website/-/3/f/4/b/3f4b7f96c6365c00/image_1wa8338.png) Reportez les informations dans les champs du formulaire de configuration puis cliquez sur le bouton **Passer à l'étape suivante**. ### Etape 2 - Autoriser l'application sur le PBX ![](https://storage.crisp.chat/users/helpdesk/website/-/3/f/4/b/3f4b7f96c6365c00/image_wwgr4w.png) Pour que votre WildixApp puisse communiquer avec le serveur PBX, vous devez le rajouter dans votre configuration de sécurité. 1. Aller dans **PBX > Security** 2. Dans la section **CORS** 3. Ajouter un **allow origin (domain whitelist)** : `https://VOTREAPP.yourapp.fr` (la valeur est rappelée dans le bloc jaune informatif) ### Etape 3 - Autoriser l'accès Cliquez sur le bouton **Autoriser l’accès**, puis authentifiez‑vous sur le PBX avec le compte `admin` dans la fenêtre contextuelle qui s’ouvre. ||| Attention, n’utilisez pas un compte utilisateur nominatif. ### Etape 4 - Vérifier l'état du jeton Une fois configuré, la section OAuth2 affiche : ![](https://storage.crisp.chat/users/helpdesk/website/-/3/f/4/b/3f4b7f96c6365c00/image_3nsfsw.png) * **Statut du jeton** : valide, expiré ou absent * **Date d'expiration** du jeton d'accès courant (durée de vie de 24h) || WildixApp renouvelle automatiquement le jeton OAuth2 tant que l’intégration est valide, c’est‑à‑dire pendant sa durée de vie de 365 jours. || Aucune action manuelle n’est requise durant cette période. || En revanche, avant l’expiration des 365 jours, l’administrateur devra renouveler la procédure de déclaration de l’intégration afin de maintenir l’accès à l’API. --- ## Méthode 2 - Token S2S (legacy) Le token S2S (Server-to-Server) est destiné aux PBX sous firmware plus ancien. Il repose sur un système d'authentification que Wildix a marqué comme déprécié en Janvier 2026. ### Configuration ![](https://storage.crisp.chat/users/helpdesk/website/-/3/f/4/b/3f4b7f96c6365c00/image_1a4eh0l.png) Dans l'interface d'administration de votre instance PBX Wildix, procédez comme suit: 1. rendez vous dans **PBX > Integrations**, onglet **Applications > Serveur à serveur** 2. cliquez sur le bouton **+ Ajouter** 3. dans le formulaire qui s'affiche, renseignez les champs comme indiqué dans le bloc jaune de votre application WildixApp et cliquez sur **Sauvegarder** 4. dans la fenêtre qui s'affiche, reporter les valeurs affichées dans votre configuration WildixApp ||| Le token doit impérativement être émis avec l'utilisateur admin du PBX pour assurer le bon fonctionnement de l'application WildixApp Dans **le panneau de configuration Générale > Connexion PBX de WildixApp**, renseignez les quatre champs fournis lors de la création du token sur votre PBX : | Champ | Description | | ---- | | Nom d'application | Identifiant lisible de l'application déclarée sur le PBX (`wildixapp`) | | Utilisateur | Compte admin Wildix associé au token (`admin` impérativement) | | App ID | Identifiant technique de l'application (`ID d'application/X-APP-ID`) | | Clé secrète | Secret HMAC (`Clé secrète`) | --- ## Priorité d'authentification Si plusieurs méthodes sont configurées simultanément, WildixApp applique l'ordre suivant : 1. **OAuth2** — si un refresh token est présent 2. **Token S2S** — si une clé secrète HMAC est configurée --- ## Sécurité Les secrets (client secret OAuth2, clé HMAC S2S) sont stockés chiffrés en base de données.