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 :
Champ | Description |
|---|---|
Protocole | |
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)
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.
Etape 1 - Créer une application OAuth2 sur l'interface d'administration du PBX
- Allez dans PBX > Integration puis onglet Applications > OAuth 2.0.
- Appuyer sur le bouton "+ Ajouter"
- 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
- Cliquez sur Sauvegarder.
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 :
Après la déclaration de l'application dans votre PBX, retournez dans la page de configuration de votre application WildixApp.
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
Pour que votre WildixApp puisse communiquer avec le serveur PBX, vous devez le rajouter dans votre configuration de sécurité.
- Aller dans PBX > Security
- Dans la section CORS
- 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.
Etape 4 - Vérifier l'état du jeton
Une fois configuré, la section OAuth2 affiche :
- Statut du jeton : valide, expiré ou absent
- Date d'expiration du jeton d'accès courant (durée de vie de 24h)
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
Dans l'interface d'administration de votre instance PBX Wildix, procédez comme suit:
- rendez vous dans PBX > Integrations, onglet Applications > Serveur à serveur
- cliquez sur le bouton + Ajouter
- dans le formulaire qui s'affiche, renseignez les champs comme indiqué dans le bloc jaune de votre application WildixApp et cliquez sur Sauvegarder
- dans la fenêtre qui s'affiche, reporter les valeurs affichées dans votre configuration 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 ( |
Utilisateur | Compte admin Wildix associé au token ( |
App ID | Identifiant technique de l'application ( |
Clé secrète | Secret HMAC ( |
Priorité d'authentification
Si plusieurs méthodes sont configurées simultanément, WildixApp applique l'ordre suivant :
- OAuth2 — si un refresh token est présent
- 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.
Mis à jour le : 23/04/2026
Merci !