Welchen Plan habe ich
Suite, alle Versionen Team, Growth, Professional, Enterprise oder Enterprise Plus
Support Team, Professional oder Enterprise
Die in diesem Beitrag beschriebenen Funktionen werden vom 11. Mai bis zum 12. Juni 2026 schrittweise für alle Suite- und Support-Pläne eingeführt. Unter Umständen sind sie in Ihrem Konto noch nicht verfügbar. Weitere Informationen finden Sie in dieser Ankündigung.

Der Integration Builder unterstützt gängige Autorisierungstypen wie API-Schlüssel, Inhaber-Token, Benutzername und Kennwort oder OAuth 2.0. Allerdings reicht die Standardautorisierung möglicherweise nicht für alle Anforderungen und Workflows Ihrer Organisation aus. Deshalb unterstützt der Integration Builder auch einen angepassten Integrationstyp speziell für die Authentifizierung, der mit den Authentifizierungs- und Autorisierungslösungen Ihrer Organisation zusammenarbeitet.

In diesem Beitrag werden folgende Themen behandelt:

  • Überblick über die angepasste Autorisierung
  • Konfigurieren der angepassten Autorisierung
  • Erstellen der Datenintegration
  • Testen der angepassten Autorisierung

Überblick über die angepasste Autorisierung

Die angepasste Auth-only-Integration fordert ein Token samt Ablaufdatum an und übergibt es an die Daten- oder Hauptintegration, die die Autorisierung durchführt und anschließend die Daten selbst anfordert.

Insgesamt läuft die angepasste Autorisierung folgendermaßen ab:

  1. Autorisierungsanforderung. Die konfigurierte Auth-only-Integration sendet eine Anfrage an den Server und bittet um die Erlaubnis, ein Zugriffstoken abzurufen. Wenn der Server die (von AI Agents stammende) Anfrage authentifiziert, autorisiert er den Abruf des Zugriffstokens und, falls verfügbar, des Ablaufdatums.
  2. Verarbeitung des Tokens. Nachdem der Server mit dem Zugriffstoken geantwortet hat, speichert die Integration zwei wichtige Informationen: erstens den token-Parameter selbst und zweitens den expiresIn-Parameter, der angibt, wie lange das Token gültig ist.
  3. Übergabe des Tokens an die Datenintegration. Die beiden Parameter (token und expiresIn) werden an den nächsten Schritt – die Datenintegration – übergeben. Das Token wird zur Authentifizierung nachfolgender Anfragen der Datenintegration verwendet. Das Token wird intern gesetzt und verarbeitet und niemals in den Sitzungs- oder Konversationsdaten angezeigt.
  4. Angepasste Autorisierungsanforderung für Daten. Mit dem Zugriffstoken ist die Datenintegration nun berechtigt, die erforderlichen Daten für die Anreicherung der Konversation abzurufen.

Die folgende Abbildung veranschaulicht den Ablauf der angepassten Autorisierung.

Konfigurieren der angepassten Autorisierung

Die angepasste Autorisierung wird beim Erstellen einer Integration im Integration Builder konfiguriert.

Hinweis: Verwenden Sie für die angepasste Autorisierung jeweils nur eine Umgebung. Wenn Sie die mehrere Umgebungen verwenden möchten, zum Beispiel eine Produktions- und eine Sandbox-Umgebung, verteilen Sie sie auf separate Autorisierungsintegrationen.

So konfigurieren Sie die angepasste Autorisierung im Integration Builder

  1. Klicken Sie im Hauptmenü auf API-Integrationen.
  2. Klicken Sie oben rechts auf Integration hinzufügen.
  3. Führen Sie im Fenster Integration hinzufügen die folgenden Schritte aus:
    1. Geben Sie in das Feld Integrationsname einen aussagekräftigen Namen für Ihre Integration ein.
    2. (Optional) Geben Sie in das Feld Beschreibung eine Beschreibung ein, die die Funktion der Integration angibt.
    3. Wählen Sie Als „Nur Authentifizierung“-Integration einrichten.
    4. Klicken Sie auf Speichern.
  4. Setzen Sie den Mauszeiger in der linken Seitenleiste unter Szenarien auf Fehler und klicken Sie im Optionsmenü () auf Löschen. Für die angepasste Autorisierung werden nur Szenarien des Typs „Erfolg“ benötigt. Szenarien des Typs „Fallback“ können nicht gelöscht werden.
  5. Klicken Sie auf der Seite der Szenarien des Typs Erfolg auf die Schaltfläche + und erstellen Sie zwei Sitzungsparameter mit den folgenden Details:
    • token
      • Schlüssel: token (in exakt dieser Schreibweise)
      • Query: Geben Sie einen Wert ein, der das Token definiert. Beispiel: data.access_token
    • expiresIn
      • Schlüssel: expiresIn (in exakt dieser Schreibweise)
      • Query: Geben Sie einen Wert ein, der das Ablaufdatum des Tokens definiert. Beispiel: data.expires_in
        Das Ablaufdatum des Tokens darf nicht in Ihrer Datenantwort enthalten sein. In diesem Fall können Sie einen Wert Ihrer Wahl (in Sekunden) fest einprogrammieren. Beispiel: 3600
        Wir empfehlen dringend, ein Ablaufdatum für das Token festzulegen. Wenn beim Testen ein Fehler auftritt, bestimmt diese Einstellung, wie lange Sie warten müssen, bis ein neues Token ausgegeben wird. Ohne Ablaufdatum bleibt das Token dauerhaft gültig, sodass Sie während der Fehlerbehebung kein neues Token ausstellen können.
  6. Klicken Sie auf Speichern.

Erstellen der Datenintegration

Als Nächstes erstellen Sie die Datenintegration mit der angepasste Auth-only-Integration, die Sie oben eingerichtet haben. Gehen Sie dabei genauso vor wie beim Erstellen einer normalen Integration. Weitere Informationen hierzu finden Sie im Beitrag Überblick über den Integration Builder.

So erstellen Sie die Datenintegration

  1. Wählen Sie in der linken Seitenleiste unter Umgebungen eine Umgebung aus (z. B. Produktion).
  2. Klicken Sie in der Registerkarte Autorisierung im Dropdownfeld Autorisierungstyp auf Angepasst.
  3. Wählen Sie im Dropdownfeld API-Autorisierungsintegration die angepasste Auth-only-Integration aus, die Sie oben erstellt haben.
  4. Klicken Sie in der Registerkarte Kopfzeilen auf Kopfzeile hinzufügen.
  5. Füllen Sie die folgenden Felder aus:
    • Schlüssel: Authorization
    • Wert: Bearer {{apiToken}} (in exakt dieser Schreibweise)
  6. Klicken Sie auf Speichern.

Testen der angepassten Autorisierung

Nachdem Sie Ihre angepasste Auth-only-Integration konfiguriert haben, sollten Sie sie testen. Weitere Informationen finden Sie unter Testfunktion.

Fehlerbehebung statusCode: null

Beim Testen Ihrer Integration kann es vorkommen, dass Sie die in der unten stehenden Abbildung dargestellte Meldung mit dem „statusCode: null“ erhalten:

Vergewissern Sie sich in diesem Fall zunächst, dass Ihre angepasste Auth-only-Integration korrekt wie oben beschrieben konfiguriert wurde.

Notieren Sie sich anschließend, wo der Fehler aufgetreten ist. Wenn er in der Authentifizierungsintegration aufgetreten ist, haben Sie wahrscheinlich etwas falsch konfiguriert oder bei der Anfrage eine falsche URL angegeben. In diesem Fall sollten Sie einen Ihrer Techniker hinzuziehen, da diese möglicherweise weitere Informationen beitragen können.

Wenn Sie die oben beschriebenen Schritte ausgeführt haben und der Fehler weiterhin auftritt, warten Sie, bis das Token abläuft, und versuchen Sie es erneut.

Wenn Sie alle diese Schritte zur Fehlerbehebung ausprobiert haben und die Integration immer noch nicht funktioniert, bitten Sie Ihren CSM um Hilfe.

 

Powered by Zendesk