Fehlerbehebung bei Integration

Diese Seite behandelt häufige Verbindungs- und Autorisierungsprobleme in Atoms. Für dienstspezifische Einrichtung, unterstützte Aktionen oder Konfigurationen in Ihrer App beginnen Sie mit Connect and Manage Integrations und wählen den Leitfaden für Ihren Dienst.

Beginnen Sie mit diesen Prüfungen

1. Prüfen Sie, wo der Fehler auftritt. Kann der Agent einen Dienst im Chat nicht verwenden, oder schlägt die Funktion nur in Ihrer App fehl? Das Verbinden eines Dienstes für den Chat bestätigt für sich genommen nicht, dass Ihre App korrekt konfiguriert ist. Bei Fehlern nur in der App siehe Connect and Manage Integrations.
2. Öffnen Sie die Integration. Öffnen Sie im Chat Ihres Projekts das Optionsmenü neben der Nachrichteneingabe und wählen Sie dann Connectors → Add connectors. Suchen Sie nach dem Dienst und wählen Sie ihn aus. Prüfen Sie, ob er verbunden ist oder weiterhin Connect anbietet. Einige Dienste öffnen ihren eigenen Verwaltungsbildschirm.
3. Prüfen Sie den Zugriff im Dienst selbst. Bestätigen Sie, dass das Konto, das Sie verbinden wollten, genau die betreffende Datei, das Repository, den Kalender, die Eigenschaft oder eine andere beteiligte Ressource öffnen kann.
4. Sichern Sie den Fehler, bevor Sie etwas ändern. Notieren Sie die genaue Meldung, Datum, Uhrzeit und Zeitzone, das betroffene Projekt oder den betroffenen Chat sowie den letzten erfolgreichen Versuch. Schwärzen Sie private Informationen in Screenshots.

Öffnen Sie die Eingabeoptionen im Chat und wählen Sie Connectors (1), dann Add connectors (2), um verfügbare Integrationen zu durchsuchen.

Sie können verfügbare Verbindungen auch unter Settings → Connectors verwalten. Wählen Sie die Integration aus, die Sie prüfen möchten.

Behandeln Sie Zugangsdaten vertraulich. Fügen Sie niemals Passwörter, Anmeldecodes, API-Schlüssel, Zugriffstoken oder andere Geheimnisse in den Chat oder in eine Supportanfrage ein. Geben Sie Zugangsdaten nur im Anmeldeablauf des Dienstes oder im dafür vorgesehenen sicheren Konfigurationsfeld ein.

Finden Sie Ihr Problem

Was Sie sehen	Wo Sie beginnen
Ein Dienst fehlt oder seine Steuerelemente sind nicht verfügbar	Eine Integration finden oder starten
Die Anmeldung öffnet sich nicht, wird blockiert oder wird nie abgeschlossen	Autorisierung abschließen
Die Verbindung verwendet ein anderes Konto	Das verbundene Konto prüfen
Verbunden, aber der Agent kann eine Ressource nicht finden	Verbindung und Datenzugriff prüfen
Lesen funktioniert, aber Erstellen oder Bearbeiten schlägt fehl	Schreibzugriff und unterstützte Aktionen prüfen
Eine zuvor funktionierende Verbindung schlägt fehl	Prüfen, was sich geändert hat
Ergebnisse sind veraltet, Anfragen laufen in ein Timeout oder Fehler wiederholen sich	Anfrage und Dienstverfügbarkeit prüfen

Sie können eine Integration nicht finden oder starten

1. Verwenden Sie Add connectors, um den Katalog zu durchsuchen. Die kürzere Liste im Chat-Menü ist nicht der vollständige Katalog.
2. Wenn Atoms sagt, dass die Funktion nur innerhalb eines Projekts verfügbar ist, öffnen Sie das vorgesehene Projekt und versuchen Sie es dort.
3. Wenn ein Steuerelement deaktiviert ist, lesen Sie die Erklärung dazu. Wenn eine andere Rolle oder Berechtigung erforderlich ist, bitten Sie den Eigentümer des Projekts oder Arbeitsbereichs um Hilfe. Trennen Sie keinen anderen Dienst, nur um eine Einschränkung zu umgehen.

Prüfen Sie das Ergebnis: Sie können den Verbindungs- oder Verwaltungsbildschirm des Dienstes öffnen. Wenn er weiterhin nicht erscheint, prüfen Sie Connect and Manage Integrations oder kontaktieren Sie den Support, um die Verfügbarkeit zu bestätigen. Gehen Sie nicht davon aus, dass ein fehlender Dienst durch wiederholte Anmeldeversuche aktiviert werden kann.

Die Autorisierung wird nicht abgeschlossen

1. Wählen Sie Connect einmal aus und achten Sie auf das Anmeldefenster des Dienstes. Wenn Ihr Browser ein blockiertes Pop-up meldet, erlauben Sie Pop-ups für die Atoms-Website und versuchen Sie es erneut. In Chrome folgen Sie den Anweisungen zum Zulassen von Pop-ups von einer bestimmten Website; Sie müssen sie nicht für jede Website aktivieren.
2. Wählen Sie das vorgesehene Konto und prüfen Sie den angeforderten Zugriff. Schließen Sie den Autorisierungsablauf des Dienstes ab, bevor Sie sein Fenster schließen.
3. Wenn der Dienst ausdrücklich angibt, dass Ihre Organisation die App oder den angeforderten Zugriff blockiert hat, sichern Sie die Meldung und kontaktieren Sie Ihren Administrator. Umgehen Sie die Richtlinien Ihrer Organisation nicht.
4. Kehren Sie zu Atoms zurück und öffnen Sie die Integration erneut, um ihren Status zu prüfen. Das Schließen eines Anmeldefensters ist keine Bestätigung dafür, dass die Autorisierung erfolgreich war.

Prüfen Sie den angeforderten Zugriff, bevor Sie die Autorisierung abschließen. Die Autorisierung eines Kontos bestätigt für sich genommen nicht, dass die vorgesehene Ressource verbunden ist.

Wenn die Autorisierung eine Auswahl für Organisation oder Arbeitsbereich enthält, bestätigen Sie die vorgesehene Auswahl und prüfen Sie die angeforderten Berechtigungen.

Prüfen Sie das Ergebnis: Die Integration wird als verbunden angezeigt. Auf Connector-Detailseiten mit dem Standardlayout wird Connect durch Disconnect und Try it out ersetzt. Andere Dienste haben eigene Layouts. Wenn weiterhin Connect angeboten wird oder ein Fehler angezeigt wird, erfassen Sie dieses Ergebnis und kontaktieren Sie den Support nach einem neuen Versuch.

Das falsche Konto ist verbunden

Wenn der Verwaltungsbildschirm der Integration ein Konto anzeigt, vergleichen Sie es mit dem Konto, dem die Ressource gehört oder das auf sie zugreifen kann. Nicht jeder Connector zeigt das verbundene Konto an, verwenden Sie daher nicht allein die aktuelle Anmeldung im Browser als Nachweis dafür, welches Konto Atoms verwendet.

Öffnen Sie die Ressource direkt im Dienst mit dem vorgesehenen Konto. Wenn dieses Konto nicht darauf zugreifen kann, bitten Sie zuerst den Eigentümer der Ressource um Zugriff. Wenn die Verbindung das falsche Konto verwendet, folgen Sie den Anweisungen des Dienstes zum Kontowechsel oder verbinden Sie sicher erneut und wählen Sie während der Autorisierung ausdrücklich das richtige Konto aus.

Prüfen Sie das Ergebnis: Eine kleine, unterstützte Leseanfrage gibt die vorgesehene Ressource zurück. Wenn Sie weiterhin nicht feststellen können, welches Konto verbunden ist, kontaktieren Sie den Support, anstatt die Verbindung wiederholt zu trennen.

Die Integration ist verbunden, aber der Agent kann Ihre Daten nicht finden

1. Prüfen Sie die Verbindung. Öffnen Sie die Details der Integration in Connectors und bestätigen Sie, dass sie verbunden ist. Prüfen Sie das ausgewählte Konto oder die Ressource, sofern angezeigt.
2. Prüfen Sie die genaue Ressource. Öffnen Sie sie direkt im Dienst mit dem vorgesehenen Konto. Bestätigen Sie ihren Speicherort und die Zugriffsberechtigungen, einschließlich der richtigen Organisation, des richtigen Arbeitsbereichs, Ordners oder der richtigen Eigenschaft, falls relevant.
3. Formulieren Sie die Anfrage konkret. Nennen Sie den Dienst und geben Sie den genauen Ressourcennamen oder Link an, wenn der Connector dies unterstützt. Fordern Sie zuerst eine unterstützte Leseaktion an, anstatt mehrere Ressourcen gleichzeitig zu durchsuchen und zu ändern.

Zum Beispiel, wenn der Connector das Lesen von Dokumenten unterstützt: „Verwende [service], um [document name or link] zu lesen, und nenne mir den Titel. Ändere nichts daran.“

Prüfen Sie das Ergebnis: Der Agent gibt die vorgesehene Ressource zurück. Wenn der direkte Zugriff funktioniert, der Agent sie aber weiterhin nicht lesen kann, prüfen Sie die unterstützten Fähigkeiten des Connectors und den gewährten Zugriff. Verbinden Sie nur dann erneut, wenn es Hinweise auf ein Autorisierungsproblem gibt.

Der Agent kann Daten lesen, aber nicht ändern

Erfolgreiches Lesen bestätigt nicht, dass der Connector die angeforderte Änderung unterstützt oder die Berechtigung hat, sie vorzunehmen.

1. Siehe Connect and Manage Integrations oder die Liste What you can do des Connectors, falls angezeigt. Bestätigen Sie, dass die angeforderte Aktion unterstützt wird.
2. Prüfen Sie, ob das verbundene Konto berechtigt ist, genau diese Änderung an der genauen Ressource vorzunehmen. Bitten Sie den Eigentümer der Ressource oder den Administrator nur um den erforderlichen Zugriff.
3. Lesen Sie jede Fehlermeldung oder Bestätigungsanfrage. Wenn eine zusätzliche Autorisierung erforderlich ist, folgen Sie dem dokumentierten Ablauf des Dienstes. Durch erneutes Verbinden kann keine Aktion hinzugefügt werden, die der Connector nicht unterstützt.

Bevor Sie einen Schreibvorgang erneut versuchen: Prüfen Sie das Ziel, um festzustellen, ob der erste Versuch bereits etwas erstellt oder geändert hat. Eine fehlgeschlagene Antwort reicht nicht aus, um zu beweisen, dass keine Änderung erfolgt ist. Wiederholen Sie keine Zahlung, Nachricht, Einladung oder Datensatzerstellung, bis Sie das vorherige Ergebnis kennen.

Prüfen Sie das Ergebnis: Eine unterstützte Änderung gelingt bei einer geeigneten Testressource, und Sie bestätigen sie direkt im Dienst. Für Zahlungen oder andere Live-Workflows verwenden Sie die dienstspezifischen Testanweisungen anstelle einer echten Transaktion.

Eine Verbindung, die zuvor funktioniert hat, funktioniert nicht mehr

Prüfen Sie, was sich seit der letzten erfolgreichen Anfrage geändert hat: das Konto, sein Zugriff auf die Ressource, die App-Richtlinie der Organisation oder die Autorisierung der Verbindung.

1. Öffnen Sie die Integration in Atoms erneut und prüfen Sie, ob sie noch verbunden ist.
2. Versuchen Sie, die Ressource direkt im Dienst zu öffnen. Wenn der Zugriff entfernt wurde, klären Sie das mit dem Eigentümer der Ressource oder dem Administrator.
3. Wenn der Fehler besagt, dass die Autorisierung abgelaufen ist, widerrufen wurde oder ungültig ist, folgen Sie Sicher erneut verbinden. Wenn der Fehler einen Dienstausfall, ein Limit oder eine nicht unterstützte Aktion betrifft, beheben Sie zuerst diese Ursache.

Prüfen Sie das Ergebnis: Eine kleine Leseanfrage funktioniert wieder. Wenn derselbe Fehler bestehen bleibt, sichern Sie ihn zusammen mit dem Zeitpunkt des letzten erfolgreichen Versuchs und kontaktieren Sie den Support.

Ergebnisse sind veraltet oder eine Anfrage schlägt immer wieder fehl

1. Vergleichen Sie das Ergebnis mit dem Dienst selbst. Bestätigen Sie gegebenenfalls Konto, Ressource, Datumsbereich, Filter und Zeitzone. Bitten Sie den Agent, den aktuellen Wert abzurufen, anstatt sich auf eine frühere Antwort in der Unterhaltung zu verlassen.
2. Bei einem ausdrücklichen Timeout- oder Dienst-nicht-verfügbar-Fehler prüfen Sie die offizielle Status- oder Hilfeseite des Dienstes. Wenn der Fehler einen Zeitpunkt für einen erneuten Versuch angibt, warten Sie bis dahin; senden Sie keine wiederholten Anfragen, solange das Limit oder der Ausfall besteht.
3. Speichern Sie nicht gesendeten Text, aktualisieren Sie Atoms und prüfen Sie den Status des Connectors erneut. Das Aktualisieren der Seite ist nicht dasselbe wie die erneute Autorisierung des Kontos.
4. Versuchen Sie erneut eine kleine Leseanfrage. Bevor Sie etwas erneut versuchen, das externe Daten ändert, prüfen Sie das Ziel auf das frühere Ergebnis.

Prüfen Sie das Ergebnis: Das neue Ergebnis stimmt mit der vorgesehenen Ressource im Dienst überein. Wenn es weiterhin falsch ist, senden Sie dem Support die erwarteten und tatsächlichen Werte mit Zeitstempeln. Gehen Sie nicht davon aus, dass jede Integration nach demselben Zeitplan aktualisiert wird.

Sicher erneut verbinden

Verbinden Sie erneut, wenn die Autorisierung ungültig ist oder das falsche Konto verknüpft ist — nicht als ersten Schritt bei jeder fehlgeschlagenen Anfrage.

Bevor Sie die Verbindung trennen: Schließen Sie Aufgaben ab oder pausieren Sie sie, die auf der Verbindung beruhen, prüfen Sie das Ergebnis jedes ausstehenden externen Schreibvorgangs und stellen Sie sicher, dass Sie sich mit dem erforderlichen Zugriff erneut anmelden können. Durch das Trennen wird die Verbindung nicht verfügbar, bis sie erneut verbunden wird. Prüfen Sie Connect and Manage Integrations auf zusätzliche Auswirkungen; gehen Sie nicht davon aus, dass das Trennen frühere Änderungen rückgängig macht oder bereits gesendete Arbeit abbricht.

1. Öffnen Sie die Verbindungsdetails des Dienstes. Wenn er einen eigenen Bildschirm zur Kontoverwaltung hat, folgen Sie den Anweisungen dieser Integration.
2. Wählen Sie auf dem Standard-Detailbildschirm des Connectors Disconnect, wenn Sie bereit sind, und dann Connect. Gehen Sie nicht davon aus, dass es vor dem Trennen eine zusätzliche Bestätigung gibt.
3. Wählen Sie das vorgesehene Konto und schließen Sie die Autorisierung ab. Prüfen Sie die angeforderten Berechtigungen.
4. Kehren Sie zu Atoms zurück und bestätigen Sie den verbundenen Status.
5. Führen Sie die untenstehende Wiederherstellungsprüfung durch, bevor Sie die ursprüngliche Aufgabe fortsetzen.

Wenn derselbe Fehler erneut auftritt, hören Sie auf, die Verbindung erneut herzustellen, und kontaktieren Sie den Support mit dem Fehler und den bereits abgeschlossenen Prüfungen.

Prüfen Sie, ob das Problem behoben ist

1. Bitten Sie um eine unterstützte schreibgeschützte Aktion für eine Ressource, die Sie direkt überprüfen können. Wenn Sie Try it out verwenden, prüfen Sie den vorgeschlagenen Prompt, bevor Sie ihn senden.
2. Vergleichen Sie die Antwort mit dem Dienst selbst. Bestätigen Sie die richtige Ressource, den Kontokontext und das angeforderte Ergebnis — nicht nur die Verbindungsanzeige.
3. Wenn Ihre Aufgabe Änderungen erfordert, verwenden Sie eine geeignete Testressource oder den dokumentierten Test-Workflow des Dienstes und prüfen Sie das Ergebnis am Ziel.

Prüfen Sie den Verbindungsstatus und die ausgewählte Ressource. Eine Verbindungsanzeige allein bestätigt nicht, dass die erwarteten Daten verfügbar oder aktuell sind.

Bestätigen Sie die Organisation und das Projekt und öffnen Sie dann Dashboard, um die Ressource zu prüfen, ohne Änderungen vorzunehmen. Das Trennen der Verbindung ist nicht Teil dieser Prüfung.

Wenn die Prüfung erfolgreich ist, setzen Sie Ihre Aufgabe fort. Wenn der Chat funktioniert, die Funktion aber weiterhin in Ihrer App fehlschlägt, siehe Connect and Manage Integrations oder build and preview troubleshooting. Prüfen Sie die Umgebung, in der der Fehler auftritt; eine erfolgreiche Chat-Anfrage ist kein Beweis dafür, dass die App korrekt konfiguriert ist.

Hilfe erhalten

Wenn das Problem weiterhin besteht, verwenden Sie Get support und fügen Sie Folgendes hinzu:

• Den Namen der Integration und die E-Mail-Adresse Ihres Atoms-Kontos.
• Das betroffene Projekt oder den betroffenen Chat-Link und ob der Fehler im Chat oder in Ihrer App auftritt. Geben Sie bei einer App die betroffene Umgebung an.
• Das vorgesehene Dienstkonto und die Ressource, wobei Sie nur nicht geheime Kennungen verwenden, die für die Untersuchung erforderlich sind.
• Den genauen Fehler, Datum, Uhrzeit und Zeitzone; geben Sie, falls bekannt, auch den letzten erfolgreichen Zeitpunkt an.
• Die Schritte zur Reproduktion, das erwartete Ergebnis, das tatsächliche Ergebnis und die bereits versuchten Prüfungen.
• Ihren Browser und Ihr Gerät sowie geschwärzte Screenshots oder eine kurze Aufzeichnung, falls hilfreich.

Geben Sie bei einem fehlgeschlagenen Schreibvorgang an, ob das Ziel eine abgeschlossene Änderung, keine Änderung oder ein unbekanntes Ergebnis zeigt. Entfernen Sie Passwörter, Anmeldecodes, API-Schlüssel, Token und nicht zusammenhängende private Daten aus allen Anhängen.