Anleitung zur 3CX Multi-Mandanten-Konfiguration

Einführung

Nachfolgend erfahren Sie, wie Sie eine Multi-Mandanten-Umgebung (Multi-Company-Modus) für 3CX installieren und konfigurieren.

Wechseln in den Multi-Mandanten-Modus

Nach der Installation von 3CX müssen Sie den Multi-Mandanten-Modus aktivieren:

• Navigieren Sie in der Administratorkonsole zu „System →Multi-Mandanten“.
• Einige Konfigurationen sind nicht mit dem Modus „Multi-Mandanten“ kompatibel:

• Wenn Sie Nutzer in mehreren Abteilungen haben, müssen Sie Folgendes tun:

• Überprüfen Sie jede Abteilung und stellen Sie sicher, dass jeder im Warndialog aufgeführte Nutzer nur einer Abteilung zugeordnet ist.
• Überprüfen Sie die Registerkarte „Ansicht“ für jeden im Warndialog aufgeführten Nutzer und entfernen Sie alle Berechtigungen, die sich auf Abteilungen beziehen, denen der Nutzer nicht angehört.

• Wenn Sie Abteilungsinformationen für alle Erweiterungen veröffentlichen, gehen Sie für jede der im Warndialog aufgeführten Abteilungen wie folgt vor:

• Klicken Sie auf den Abteilungslink.
• Klicken Sie auf die Schaltfläche „Optionen“ für die Abteilung.
• Deaktivieren Sie die Option „Abteilungsinformationen für alle Nebenstellen veröffentlichen“.

• Falls diese Option aktiviert ist, müssen Sie die Integrationen „Teams“, „CRM“ und „M365“ deaktivieren.

• Sobald alle Warnungen behoben sind, können Sie den Multi-Mandanten-Modus aktivieren. Klicken Sie dazu auf die Schaltfläche „Weiter“.

Erstellen von Mandanten/Unternehmen

Mandanten/Unternehmen können auf 2 Arten erstellt werden::

• Manuell über einen Systemeigentümer
• Per 3CX Konfigurations-API 

Manuell als Systemeigentümer

Die Erstellung von Unternehmen in einem System mit Multi-Mandanten ist auf die Rollen des Systemeigentümers und des Systemadministrators beschränkt.

Schritt 1: Richten Sie die „Standard“-Abteilung ein

• Navigieren Sie in der Admin-Konsole zu „Admin → Abteilungen“.

• Klicken Sie auf die Default Abteilung.
• Klicken Sie auf die Schaltfläche „Hinzufügen“:

• Fügen Sie die folgenden Systemnebenstellen hinzu:

• *0
• *1
• *777
• *888
• SP0
• SP1

• Klicken Sie auf die Schaltfläche „OK“.

Schritt 2: Erstellen Sie eine neue Abteilung

• Navigieren Sie in der Admin-Konsole zu „Admin → Abteilungen“:
• Klicken Sie auf die Schaltfläche „Hinzufügen“.

• Im Dialogfeld „Abteilung hinzufügen“:

• Geben Sie den Abteilungsnamen für Ihr neues Unternehmen ein.
• Wählen Sie das Abteilungsansagen-Set aus, das Ihr Unternehmen verwenden soll (z. B. für IVR- und Voicemail-Ansagen).
• Wählen Sie die Abteilungssprache aus, die Ihr Unternehmen verwenden soll (für Benachrichtigungen wie Willkommens-E-Mails und Besprechungseinladungen).
• Wählen Sie den Nutzer-Nebenstellenbereich aus; in diesem Beispiel stehen dem Unternehmen 20 Nutzer-Nebenstellennummern im Bereich 200–219 zur Verfügung.
• Wählen Sie den System-Nebenstellenbereich aus; in diesem Beispiel stehen dem Unternehmen 20 System-Nebenstellennummern im Bereich 800–819 zur Verfügung.
• Legen Sie das Leitungslimit fest, um die maximale Anzahl an Leitungen zu definieren, die der Abteilungsinhaber dieses Unternehmens erstellen darf.
• Legen Sie die Transkriptionsoption fest, um zu definieren, ob Voicemails und/oder Aufzeichnungen für Ihr Unternehmen transkribiert werden sollen.

Schritt 3: Geben Sie der Abteilung einige gemeinsam genutzte Anrufparkplätze

So fügen Sie diesem neuen Unternehmen gemeinsam genutzte Parkplätze hinzu:

• Navigieren Sie in der Admin-Konsole zu „Admin → Abteilungen“.
• Wählen Sie Ihr Unternehmen aus.
• Klicken Sie auf die Schaltfläche „Hinzufügen“, um Mitglieder zum Unternehmen hinzuzufügen.

• Wählen Sie im Dialogfeld „Mitglieder hinzufügen“ die gemeinsam genutzten Parkplätze aus, die dem Unternehmen zugewiesen werden sollen.

• Beachten Sie, dass jeder gemeinsam genutzte Parkplatz für jedes neu erstellte Unternehmen eindeutig sein muss.
• In diesem Beispiel werden SP2 und SP3 dem Unternehmen zugewiesen; diese gemeinsam genutzten Parkplätze dürfen keinem anderen Unternehmen zugewiesen werden. Klicken
• Sie zur Bestätigung auf „OK“.

Schritt 4: Nutzer als Mitglieder des Unternehmens anlegen

Erstellen Sie Ihre Nutzer in der Administratorkonsole, indem Sie zu „Admin → Nutzer“ navigieren und auf die Schaltfläche „Nutzer hinzufügen“ klicken. Weitere Informationen zu Nutzernebenstellen finden Sie hier.

Sie können auch mehrere Erweiterungen aus einer CSV-Datei/Tabelle importieren:

• Laden Sie hier eine Beispiel-Importdatei herunter.
• Die vollständige Liste der importierbaren Felder finden Sie im Dokument „Nebenstellen massenimportieren“.
• Hier ist ein vereinfachtes Beispiel mit einer Auswahl der verfügbaren Felder:

Number,FirstName,LastName,EmailAddress,MobileNumber,OutboundCallerID,DID,Role,Department

200,Jules,Verne,[email protected],12223334444,12224446667,12224446666,"<role name=""group_owners"" />",Company01 - ACME Ltd

201,John,Smith,[email protected],12223334445,12224446668,12224446667,"<role name=""group_admins"" />",Company01 - ACME Ltd

202,Johannes,Brahms,[email protected],12223334446,12224446669,12224446668,"<role name=""users"" />",Company01 - ACME Ltd



Das Beispiel zeigt auch die Syntax für die Rollenzuweisung; weitere Informationen zu Zugriffsrollen erhalten Sie hier.

Nach dem Import werden die neuen Firmenmitglieder dem System hinzugefügt.

Sobald diese Schritte abgeschlossen sind, erhält der Inhaber eine E-Mail mit einer Anleitung zur Anmeldung im System. Über die Administratorkonsole kann der Inhaber die Firma konfigurieren und verwalten, Bürozeiten und Feiertage festlegen, Nutzer, Anrufgruppen und Warteschlangen verwalten sowie Nummern zuweisen.

Bitte beachten Sie, dass Inhaber und Abteilungsadministratoren nur die Elemente (Nutzer, Warteschlangen usw.) ihrer Abteilung sehen und/oder konfigurieren können.

Schritt 5: Einrichten eines Trunks für eine Abteilung mit Nummern

Erstellen Sie einen SIP-Trunk für dieses Unternehmen und wählen Sie auf der Registerkarte „Optionen“ das Unternehmen aus, auf das Sie „Beschränken auf“ festlegen möchten, damit dieser Trunk ausschließlich diesem Unternehmen zugeordnet werden kann.

Ebenso können Sie dies auch für die Anrufbearbeitung tun, indem Sie Anrufgruppen, Warteschlangen und IVRs erstellen und diese direkt dem Unternehmen zuweisen.

Schritt 6: Firmentelefonbuch

Ab Update 8 von Version 20 kann jedes Unternehmen ein eigenes Firmen-Telefonbuch führen. Dieses ist direkt und ohne spezielle Konfiguration verfügbar. Wie im Haupt-Telefonbuch können Kontakte per CSV-Datei hochgeladen oder einzeln hinzugefügt werden. Weitere Informationen zu Firmen- und Abteilungs-Telefonbüchern finden Sie hier.

3CX Configuration API

Eine weitere Möglichkeit besteht darin, unsere 3CX Rest API zu nutzen, um Ihr System programmatisch zu verwalten und zu konfigurieren. Dies ist besonders nützlich, wenn Sie eine Automatisierung für die unternehmensweite Bereitstellung benötigen.

Befolgen Sie die Schritte zum Erstellen einer Anwendung:

• Navigieren Sie in der Admin-Konsole zu „Integrationen → API“.
• Klicken Sie auf der Seite „Dienstprinzipale“ auf die Schaltfläche „Hinzufügen“ und gehen Sie wie folgt vor:

• Legen Sie die Client-ID fest.
• Aktivieren Sie das Kontrollkästchen „Zugriff auf die 3CX-Konfigurations-API (XAPI) für diese Anwendung aktivieren“.
• Legen Sie die Abteilung auf „Default“ fest.
• Legen Sie die Rolle auf „Systemeigentümer“ fest.
• Klicken Sie auf die Schaltfläche „Speichern“.

• Kopieren Sie im Dialogfeld „API-Schlüssel“ den API-Schlüssel und speichern Sie ihn:

• Sie benötigen die Client-ID und den API-Schlüssel zur Authentifizierung.

Sie können nun alle folgenden Elemente programmatisch verwalten, hinzufügen und löschen:

• Abteilungen
• Nutzer
• Anrufverwaltung
• 3CX Live Chat
• Konfiguration

Hier erhalten Sie weiterführende Informationen zu diesem Thema.

Letztes Update

Dieses Dokument wurde zuletzt am 4. Juni 2026 aktualisiert.

https://www.3cx.de/docs/multi-mandanten-konfiguration/