Konfigurieren von OpenAI für 3CX KI-Agenten

Einführung

In diesem Handbuch wird erläutert, wie Sie OpenAI mit 3CX AI Agents integrieren, um intelligente, KI-gestützte Rezeptions- und Anrufbearbeitungsszenarien zu ermöglichen.

Diese Funktion erfordert eine 3CX AI-Lizenz.

Schritt 1: Einrichten eines OpenAI-Kontos

Wenn Sie noch kein OpenAI-Konto haben, müssen Sie eines erstellen, die Abrechnung einrichten und einen API-Schlüssel generieren.

Erstellen Sie ein Projekt und richten Sie die Abrechnung ein.

• Rufen Sie die OpenAI-Anmeldeseite auf und melden Sie sich bei Ihrem Konto an.
• Erstellen Sie ein neues Projekt und geben Sie ihm einen aussagekräftigen Namen.
• Gehen Sie zu „Einstellungen“ →Schließen Sie unter „Abrechnung“ die Abonnementeinrichtung ab.
• Ensure you have enough credit for your expected usage.

Hinweis: Für die korrekte Funktionalität benötigen Sie ein kostenpflichtiges OpenAI-Konto; Testkonten sind eingeschränkt und können unvorhersehbare Probleme/Fehler aufweisen. OpenAI-Konten, die mindestens 100 US-Dollar zahlen, werden in der Regel direkt in die Stufe 3 hochgestuft.

Konfigurieren des Modellzugriffs und der Modellbeschränkungen

• Navigieren Sie zu Projekt → Limits.
• Legen Sie ein Budget fest, um Ihre Ausgaben zu kontrollieren.
• Unter „Modelle zulassen oder blockieren“, muss die Liste leer bleiben, um alle Modelle zuzulassen.
• Unter „Ratenlimits“ sollten Sie die Grenzwerte für die oben genannten Modelle nach Bedarf erhöhen (bei größeren Installationen sind möglicherweise höhere Grenzwerte erforderlich, um unvorhersehbares Verhalten zu vermeiden).

Hinweis zu Ratenbegrenzungen: Ihre Möglichkeit zur Erhöhung der Limits hängt von Ihrem OpenAI API-Nutzungslevel bzw. Ihrer Kontohistorie ab.

Erstellen Sie einen neuen API-Schlüssel

• Gehen Sie zu Dashboard → API-Schlüssel.
• Klicken Sie auf „Neuen Geheimschlüssel erstellen“.
• Geben Sie einen aussagekräftigen Namen ein und setzen Sie die Berechtigungen auf „Alle“.
• Kopieren und speichern Sie den Schlüssel sicher.

Schritt 2: OpenAI in 3CX konfigurieren

• Gehen Sie in der Admin-Konsole zu „Admin → Integrationen → KI“ und klicken Sie auf die Schaltfläche „OpenAI API“.

• Fügen Sie Ihren OpenAI-Geheimschlüssel ein.
• Wählen Sie die zu verwendenden Modelle aus:

• OpenAI-Modell für Echtzeitanrufe: gpt-realtime (empfohlen)
• OpenAI Model für Text: gpt-4o (empfohlen)

• Geben Sie die folgenden Details an:

• Company Name
• Company Description – wird von KI-Agenten verwendet, um den Kontext Ihrer Organisation zu verstehen.

• Klicken Sie auf Speichern.

Schritt 3: Wissensquellen hinzufügen / RAG (eigene Inhalte einbringen)

Wissensquellen ermöglichen es Agenten, während Anrufen/Chats unternehmensspezifische Inhalte (Richtlinien, FAQs, Routing-Regeln, Produktdokumentationen) abzurufen. Im OpenAI-Ökosystem wird dies üblicherweise durch Dateiimport und anschließende Einbettung/Vektorsuche zum Abruf implementiert.

• Gehen Sie in der Admin-Konsole zu „Admin → Integrationen → KI“.
• Klicken Sie auf die Schaltfläche „Wissensquellen“ und anschließend auf die Schaltfläche „Hinzufügen“.

• Geben Sie Name und Beschreibung ein.
• Laden Sie Dateien (PDFs/Dokumente/Texte) hoch, die alles enthalten, was mit Ihrem Unternehmen zu tun hat, z. B.:

• Öffnungszeiten & Feiertagsregelungen
• Abteilungsanweisungen
• FAQs zu Produkten/Preisen
• „Was wir tun / Wie Sie über uns sprechen“

• TIPPS

• In Punkt 4a: Verfassen Sie eine aussagekräftige Beschreibung des Inhalts der Wissensdquelle. Dies verbessert die Auffindbarkeit.
• Wenn Sie ein medizinisches Dokument und ein internes Reiserichtliniendokument haben, speichern Sie diese nicht in derselben Wissensquelle, da sie nicht zusammengehören. Erstellen Sie für jedes Dokument eine separate Wissensquelle.
• Die openAI-API aktualisiert 3CX nicht bei jeder Änderung. Klicken Sie nach jeder Änderung auf „Aktualisieren“ und haben Sie etwas Geduld.

Hinweis: Wissensquellen werden unter dem von Ihnen konfigurierten OpenAI-Projekt/Schlüssel erstellt und abgerechnet.

Schritt 4: Erstellen und Konfigurieren von KI-Agenten

• Klicken Sie auf die Schaltfläche „Admin → Integrationen → KI → Agent hinzufügen“:

• Wählen Sie den Agententyp:

• Rezeptionist: Firmenorientierter KI-Agent für die grundlegende Anrufbearbeitung und -weiterleitung
• Persönlicher Assistent: Optimiert für die Anrufbearbeitung für einen bestimmten Nutzer (z. B. Vorgesetzten).

• Auf der Registerkarte „Agenteninformationen“:

• Allgemeine Einstellungen festlegen:

• Nebenstellennummer – Weisen Sie dem KI-Agenten eine eindeutige Durchwahlnummer zu.
• Assistent für (nur PA) – welchen Nutzer der PA vertritt
• Abteilungszugehörigkeit – Wählen Sie die Abteilung(en) aus, zu der/denen der Agent gehört.
• Vorname und Nachname – die gesprochene/sichtbare Identität des KI-Agenten
• Zugewiesene DID-Nummern – Direkte eingehende Nummern, die den KI-Agenten erreichen

• Konfigurieren der Sprach- und Anrufeinstellungen für Ihren KI-Agenten:

• Sprachstil – Wählen Sie aus den verfügbaren Optionen die gewünschte KI-Stimme aus.
• Anrufaufzeichnung – Wählen Sie aus, welche Anrufe aufgezeichnet werden sollen:
• Maximale Gesprächsdauer
• Agent Talk Link – ermöglicht die Click-to-Talk-Funktion von einer Website aus.

• Klicken Sie auf die Registerkarte „Agententyp“:

• Wissensquellen festlegen – wählen Sie aus, auf welche Wissensquellen der Agent zugreifen kann.
• Begrüßungssprache festlegen – Standardbegrüßungssprache

• Sie können auch den Sprachwechsel zulassen.

• Willkommensnachricht – Erste Nachricht an den Anrufer.

• Im Tab „Agentenanweisungen“ sind Ihre KI-Verhaltensanweisungen vorkonfiguriert. Bei Bedarf können Sie jedoch über die Schaltfläche „Ansage anpassen“ den Tonfall, die Richtliniengrenzen und die „Erlaubnis/Nicht-Erlaubnis“-Regeln feinabstimmen.
• Auf der Registerkarte „Spam-Anrufe blockieren“:

• Der Spamschutz ist standardmäßig aktiviert.
• Sie können die Definition von Spam anpassen, um festzulegen, was Spam oder Betrug bedeutet und welche Maßnahmen ergriffen werden sollen:

• Anruf beenden
• Weiterleiten an (einen Vorgesetzten/Prüfer)
• Screening-Zusammenfassung senden + Verbindung trennen

• Im Reiter „Anrufweiterleitung“ (nur für Rezeptionisten):

• Fügen Sie Routing-Verhaltensregeln hinzu, damit Ihr KI-Agent Anrufe und Chats anhand Ihrer Beschreibung intelligent an verschiedene Ziele weiterleiten kann.

• Beispiel: Wenn der Anrufer sagt: „Ich erhalte Fehler 404“, kann der KI-Agent dies als Support-Anruf einstufen und an ein Ziel mit einer Beschreibung wie „Bei HTTP-Fehlern hierher weiterleiten“ weiterleiten.
• Sie können mehrere Routing-Einträge erstellen, vermeiden Sie jedoch übermäßige Überschneidungen, um ein korrektes Routing zu gewährleisten.

• Wenn Sie die Weiterleitung nach Namen zulassen, können Anrufer die Weiterleitung anhand ihres Namens anfordern, z. B. „Bitte verbinden Sie mich mit George“.
• Mit aktiviertem Vertraulichkeitsmodus:

• Dies verhindert, dass die KI vertrauliche Informationen wie Nachnamen und Mitarbeiterdaten preisgibt.
• Beachten Sie: Wenn Sie dies mit der Option „Routing nach Namen zulassen“ kombinieren, kann Ihr KI-Agent beispielsweise nicht fragen: „Wir haben zwei Georges, George Takei und George Washington. Mit wem möchten Sie verbunden werden?“, sondern fragt den Anrufer nach dem vollständigen Namen des gewünschten Ziels.

• Im Tab „Anrufprüfung“:

• Sie können die Anrufprüfung für bekannte Kontakte deaktivieren. Dadurch wird die Prüfung bekannter, vertrauenswürdiger Kontakte aus dem Telefonbuch gelockert.
• Sie können das Kontrollkästchen „Besetztprüfung vor Anrufweiterleitung“ aktivieren, um sicherzustellen, dass die Zielnr. vor der Weiterleitung des Anrufs verfügbar ist.

• Im Tab „Optionen“:
• Die Anruferreaktionsaktionen zielen auf zwei spezifische Arten problematischer Anrufer ab:

• Feindselige oder beleidigende Anrufer.
• Nicht kooperative Anrufer, die das Gespräch behindern.

• Es können geeignete Aktionen konfiguriert werden, um diese Situationen automatisch zu handhaben.

Technische Hinweise

• Audio Codec: Nur PCMU wird unterstützt.
• Networking:

• OpenAI Service: api.openai.com
• Stellen Sie sicher, dass der ausgehende Zugriff zulässig ist für:

• TCP 443 (HTTPS)
• UDP 3478 (STUN/TURN für OpenAI Sessions).

• Hinweis zu KI-Modellen:

• OpenAI aktualisiert seine Modelle fortlaufend. Mit der Verfügbarkeit neuer und verbesserter Versionen werden ältere Versionen als veraltet eingestuft. Die Informationen in diesem Dokument werden regelmäßig aktualisiert, um die jeweils empfohlenen Optionen widerzuspiegeln. Sie müssen sicherstellen, dass Ihr OpenAI-Konto so konfiguriert ist, dass 3CX die neueren Modelle verwenden kann.
• Neue Versionen von 3CX aktualisieren die konfigurierten Modelle automatisch auf die moderneren Versionen.

Letztes Update

Dieses Dokument wurde zuletzt am 4. Juni 2026 aktualisiert

https://www.3cx.de/docs/ki-agent-konfiguration/