API & intégrations

Votre téléphonie reliée à vos outils métier

Un PBX moderne ne doit pas rester isolé. MaxiPBX expose des API documentées déjà disponibles pour les tenants et pour l'administration master, connecte les CRM, s'intègre à Microsoft Teams et ouvre les usages CTI avancés grâce à une passerelle ARI sécurisée et cloisonnée par tenant.

01

API PBX documentée et exploitable

Les intégrateurs disposent d'une documentation OpenAPI / Swagger claire, avec authentification standard et séparation stricte des périmètres.

  • Documentation OpenAPI / Swagger disponible pour comprendre rapidement les routes
  • Authentification standard Authorization: Bearer pour les intégrations modernes
  • API tenant disponible pour gérer son propre périmètre, sans accès aux autres clients
  • API master disponible pour l'administration globale et les intégrations à périmètre complet
  • Routes publiques, routes protégées et accès hôtellerie/PMS séparés proprement
02

CRM, fiche client et click-to-call

MaxiPBX rapproche l'appel téléphonique du contexte client : identification de l'appelant, ouverture de la fiche CRM et journalisation automatique.

  • Connexions HubSpot, Salesforce, Zoho, Odoo, ConnectWise, Vtiger et Jetpack CRM
  • Recherche du contact sur appel entrant : nom, société et bouton « Ouvrir dans le CRM »
  • Journalisation des appels entrants, sortants et manqués dans le CRM du tenant
  • Extension navigateur click-to-call pour Chrome, Edge et Firefox
03

Microsoft Teams, SSO et identité

Les environnements Microsoft 365 et Google Workspace sont pris en charge sans imposer un modèle d'authentification propriétaire.

  • Synchronisation de présence Teams vers le poste téléphonique
  • Softphone MaxiPBX intégrable dans Microsoft Teams
  • SSO SAML avec Microsoft Entra ID, Google Workspace, Okta ou IdP générique
  • Configuration par tenant, avec consentement administrateur quand nécessaire
04

ARI sécurisé et projets CTI avancés

Pour les intégrations téléphoniques de bas niveau, MaxiPBX peut exposer Asterisk REST Interface via une passerelle maîtrisée.

  • Accès ARI global ou par tenant selon le besoin d'intégration
  • Identifiants dédiés, mots de passe chiffrés et liste blanche IP obligatoire
  • Exposition HTTPS sur le port 443, REST et WebSocket d'événements
  • Un accès tenant ne voit que les appels de son tenant
05

Webhooks et intégrations hôtellerie / PMS

Le module Chambres est conçu pour dialoguer avec les outils métier : check-in, check-out, réveils, statuts, taxation et événements.

  • API REST pour check-in/out, occupant, langue, profil téléphonique et réveils
  • Webhooks pour remonter statuts, DND, appels, taxation et urgences
  • Architecture préparée pour OPERA / FIAS et connecteurs PMS
  • Clés et secrets protégés, jamais réaffichés après enregistrement

Questions fréquentes

L'API est-elle utilisable par un client dans son propre tenant ?

Oui. Le modèle d'accès distingue clairement les droits tenant et master : un administrateur de tenant peut automatiser son périmètre, sans voir les autres clients. Les accès globaux restent réservés aux administrateurs généraux.

Peut-on connecter MaxiPBX à un CRM auto-hébergé ?

Oui. Les connecteurs standards couvrent plusieurs CRM connus, et le moteur accepte aussi des modèles d'URL, clés API et intégrations plus spécifiques selon le projet.

L'accès ARI est-il dangereux ?

Il est désactivé tant qu'aucune configuration n'est créée. Quand il est utilisé, l'accès passe par HTTPS, avec identifiants dédiés, restriction IP obligatoire et cloisonnement par tenant lorsque l'accès n'est pas global.

Vous avez un CRM, un PMS ou une intégration CTI à raccorder ?

On analyse votre cas, les droits nécessaires et le niveau d'ouverture adapté avant d'exposer la moindre API.