Wenn Sie AI Agents in Ihre Zendesk-Instanz integriert haben, ist es möglich, dass in allen Ihren Kanälen bereits ein AI Agent als Standard-Responder eingesetzt wird. Wenn stattdessen für bestimmte Kanäle ein AI Agent – Essential verwendet werden soll, müssen Sie die Responder-ID des AI Agent ermitteln, damit dieser als Standard-Responder festgelegt werden kann.

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.

Wenn Sie AI Agents in Ihre Zendesk-Instanz integriert haben, ist es möglich, dass in allen Ihren Kanälen bereits ein AI Agent als Standard-Responder eingesetzt wird. Wenn stattdessen für bestimmte Kanäle ein AI Agent – Essential verwendet werden soll, müssen Sie die Responder-ID des AI Agent ermitteln, damit dieser als Standard-Responder festgelegt werden kann.

In diesem Fall können Sie zwei APIs zusammen verwenden, um alle verfügbaren Responder in Ihrer Zendesk-Instanz und deren IDs zu ermitteln.

Hinweis: In den Ausführungen im vorliegenden Beitrag wird Postman verwendet. Wenn Sie Postman noch nicht haben, können Sie sich auf der Postman-Website für ein Konto registrieren und die App herunterladen.

In diesem Beitrag werden folgende Themen behandelt:

  • Ermitteln der Switchboard-ID
  • Ermitteln der Responder-IDs

Verwandte Beiträge:

  • Festlegen von kanalspezifischen Standard-Respondern per API-Aufruf in Sunshine Conversations
  • Abrufen einer Liste von Integrations-IDs aus Messaging, ohne eine Verbindung zu AI Agents herzustellen

Ermitteln der Switchboard-ID

Mit dem API-Aufruf List Switchboards können Sie Ihre Switchboard-ID ermitteln. Das Switchboard wird automatisch erstellt, wenn Sie Messaging in Ihrer Zendesk-Instanz bereitstellen.

Standardmäßig haben Sie nur ein Switchboard. Sie können aber über die API weitere Switchboards erstellen. Die meisten Unternehmen verwenden keine weiteren Switchboards, aber wenn Sie weitere erstellt haben, müssen Sie alle Ihre Switchboards überprüfen, bis Sie ein Switchboard mit AI Agents finden.

So ermitteln Sie die Switchboard-ID

  1. Klicken Sie in der Seitenleiste des Admin Centers auf Apps und Integrationen und dann auf APIs > Konversations-API.
  2. Wählen Sie den API-Schlüssel aus, den Sie beim Integrieren der AI Agents erstellt haben, oder erstellen Sie einen neuen API-Schlüssel für den API-Aufruf, den Sie nach Abschluss des Vorgangs wieder löschen können.

    Weitere Informationen finden Sie unter Verwenden von Conversations API-Schlüsseln.

  3. Kopieren Sie die folgenden Informationen:
    • App-ID
    • Schlüssel-ID
    • Geheimschlüssel
      Hinweis: Aus Sicherheitsgründen wird der Geheimschlüssel für Ihren ursprünglichen API-Schlüssel im Admin Center nicht angezeigt. Wenn Sie den Geheimschlüssel nicht an einem sicheren Ort gespeichert haben, müssen Sie stattdessen einen neuen API-Schlüssel erstellen.

  4. Verwenden Sie in Postman je nach Region eine der folgenden Anfrage-URLs:
    • USA: https://api.smooch.io/v2/apps/{appId}/switchboards
    • EU: https://api.eu-1.smooch.io/v2/apps/{appId}/switchboards

      Ersetzen Sie {appId} durch die oben kopierte App-ID.

  5. Klicken Sie unter Auth Type auf Basic Auth.
  6. Geben Sie unter Username die Schlüssel-ID ein, die Sie oben kopiert haben.
  7. Geben Sie unter Password den Geheimschlüssel ein, den Sie oben kopiert haben.
  8. Klicken Sie auf Send.
  9. Kopieren Sie die Switchboard-ID, die zurückgegeben wird.

Jetzt, wo Sie Ihre Switchboard-ID haben, befolgen Sie die Anweisungen im nächsten Abschnitt, um Ihre Responder-IDs zu ermitteln.

Ermitteln der Responder-IDs

Verwenden Sie den API-Aufruf List Switchboard Integrations, um Ihre Responder-IDs zu ermitteln.

So ermitteln Sie Ihre Responder-IDs

  1. Verwenden Sie in Postman je nach Region eine der folgenden Anfrage-URLs:
    • USA: https://api.smooch.io/v2/apps/{appId}/switchboards/{switchboardId}/switchboardIntegrations
    • EU: https://api.eu-1.smooch.io/v2/apps/{appId}/switchboards/{switchboardId}/switchboardIntegrations

      Ersetzen Sie {appId} durch die oben kopierte App-ID und {switchboardId} durch die oben kopierte Switchboard-ID.

  2. Klicken Sie unter Auth Type auf Basic Auth.
  3. Geben Sie unter Username die Schlüssel-ID ein, die Sie oben kopiert haben.
  4. Geben Sie unter Password den Geheimschlüssel ein, den Sie oben kopiert haben.
  5. Klicken Sie auf Send.
  6. Die Responder-IDs werden zurückgegeben.

Jetzt, wo Sie Ihre Responder-ID haben, können Sie Ihre Integrationen aktualisieren bzw. im Arbeitsbereich für AI Agents hinzufügen oder entfernen.

Powered by Zendesk