API & Integrationen

Ihre Telefonie verbunden mit Ihren Business-Tools

Eine moderne PBX darf nicht isoliert sein. MaxiPBX stellt dokumentierte APIs zur Verfügung, die bereits für Mandanten und Master-Administration verfügbar sind, verbindet CRM-Systeme, integriert sich mit Microsoft Teams und eröffnet erweiterte CTI-Anwendungen durch ein sicheres, mandantengebundenes ARI-Gateway.

01

Dokumentierte und nutzbare PBX-API

Integratoren haben Zugang zu einer klaren OpenAPI/Swagger-Dokumentation mit Standardauthentifizierung und strikter Bereichstrennung.

  • OpenAPI/Swagger-Dokumentation für schnelles Verständnis der API-Routen
  • Standard-Authentifizierung Authorization: Bearer für moderne Integrationen
  • Mandanten-API zum Verwalten des eigenen Bereichs ohne Zugriff auf andere Kunden
  • Master-API für globale Administration und Integrationen mit vollständigem Bereich
  • Öffentliche Routen, geschützte Routen und Hotel-/PMS-Zugriffe sauber getrennt
02

CRM, Kundendatensätze und Click-to-Call

MaxiPBX verbindet Telefonanrufe mit dem Kundenkontext: Anruferidentifikation, Öffnung des CRM-Datensatzes und automatische Protokollierung.

  • Verbindungen zu HubSpot, Salesforce, Zoho, Odoo, ConnectWise, Vtiger und Jetpack CRM
  • Kontaktsuche bei eingehenden Anrufen: Name, Unternehmen und Schaltfläche »Im CRM öffnen«
  • Protokollierung von ein-, ausgehenden und verpassten Anrufen im CRM des Mandanten
  • Browser-Erweiterung Click-to-Call für Chrome, Edge und Firefox
03

Microsoft Teams, SSO und Identität

Microsoft 365 und Google Workspace Umgebungen werden ohne proprietäres Authentifizierungsmodell unterstützt.

  • Synchronisierung des Teams-Präsenzstatus zum Telefon
  • MaxiPBX-Softphone integrierbar in Microsoft Teams
  • SAML SSO mit Microsoft Entra ID, Google Workspace, Okta oder generischem IdP
  • Konfiguration pro Mandant mit administrativer Genehmigung falls erforderlich
04

Sicheres ARI und erweiterte CTI-Projekte

Für Low-Level-Telefonintegrationen kann MaxiPBX Asterisk REST Interface über ein kontrolliertes Gateway bereitstellen.

  • ARI-Zugriff global oder pro Mandant je nach Integrationsbedarf
  • Dedizierte Anmeldedaten, verschlüsselte Passwörter und obligatorische IP-Whitelist
  • HTTPS-Exposure auf Port 443, REST und WebSocket für Events
  • Ein Mandanten-Zugriff sieht nur Anrufe des eigenen Mandanten
05

Webhooks und Hotel-/PMS-Integrationen

Das Rooms-Modul ist für die Kommunikation mit Business-Tools ausgelegt: Check-in, Check-out, Weckrufe, Status, Abrechnung und Events.

  • REST-API für Check-in/out, Gast, Sprache, Telefon-Profil und Weckrufe
  • Webhooks für Status, DND, Anrufe, Abrechnung und Notfälle
  • Architektur vorbereitet für OPERA/FIAS und PMS-Konnektoren
  • Schlüssel und Geheimnisse geschützt, nach Speicherung nicht wieder angezeigt

Häufig gestellte Fragen

Kann ein Kunde die API in seinem eigenen Mandanten verwenden?

Ja. Das Zugriffsmodell unterscheidet klar zwischen Mandanten- und Master-Rechten: Ein Mandanten-Administrator kann seinen Bereich automatisieren, ohne andere Kunden zu sehen. Globale Zugriffe bleiben den General-Administratoren vorbehalten.

Kann MaxiPBX mit einem selbst gehosteten CRM verbunden werden?

Ja. Die Standard-Konnektoren unterstützen mehrere bekannte CRM-Systeme, und die Engine akzeptiert auch benutzerdefinierte URL-Muster, API-Schlüssel und projektspezifische Integrationen.

Ist der ARI-Zugriff gefährlich?

Er ist deaktiviert, bis eine Konfiguration erstellt wird. Bei Verwendung läuft der Zugriff über HTTPS mit dedizierten Anmeldedaten, obligatorischer IP-Beschränkung und Mandanten-Cloistering, falls der Zugriff nicht global ist.

Sie haben ein CRM, PMS oder CTI-Integration zum Anschließen?

Wir analysieren Ihren Fall, die erforderlichen Rechte und das passende Öffnungsniveau, bevor wir irgendwelche APIs freigeben.