Fehlerbehebung bei Integration

Wenn sich eine Integration nicht verbinden lässt, nicht mehr funktioniert oder eine Aufgabe nicht abschließen kann, verwenden Sie diese Anleitung, um die Verbindung, den Kontozugriff und die ausgewählte Ressource zu überprüfen.

Diese Seite behandelt häufige Verbindungs- und Autorisierungsprobleme in Atoms. Für die dienstspezifische Einrichtung, unterstützte Aktionen oder die Konfiguration in Ihrer App beginnen Sie mit Integrationen verbinden und verwalten und wählen Sie die Anleitung 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 Integrationen verbinden und verwalten.
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, die genaue Datei, das Repository, den Kalender, die Eigenschaft oder die andere betroffene Ressource öffnen kann.
4. Sichern Sie den Fehler, bevor Sie etwas ändern. Notieren Sie die genaue Meldung, Datum und Uhrzeit mit Zeitzone, das betroffene Projekt oder den Chat sowie den letzten erfolgreichen Versuch. Schwärzen Sie private Informationen in Screenshots.

Öffnen Sie die Eingabeoptionen des Chats, wählen Sie Connectors (1) und 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 überprüfen möchten.

Behandeln Sie Anmeldedaten 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 Anmeldedaten nur im Anmeldeablauf des Dienstes oder im dafür vorgesehenen sicheren Konfigurationsfeld ein.

Finden Sie Ihr Problem

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 angibt, 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 Integrationen verbinden und verwalten 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 suchen Sie nach dem 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 aus 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, speichern Sie die Meldung und kontaktieren Sie Ihren Administrator. Umgehen Sie nicht die Richtlinien Ihrer Organisation.
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 Detailbildschirmen von Connectors, die das Standardlayout verwenden, wird Connect durch Disconnect und Try it out ersetzt. Andere Dienste haben ihre eigenen 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 die Ressource 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 ihre 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.“

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 Integrationen verbinden und verwalten 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 diese Änderung an der genauen Ressource vornehmen darf. Bitten Sie den Eigentümer der Ressource oder den Administrator nur um den dafür 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. Verwenden Sie für Zahlungen oder andere Live-Workflows 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, speichern 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 das Konto, die Ressource, den Datumsbereich, Filter und die 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 verä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 die Verbindung angewiesen sind, prüfen Sie das Ergebnis ausstehender externer Schreibvorgänge 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 Integrationen verbinden und verwalten 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 wählen Sie dann Connect. Gehen Sie nicht davon aus, dass vor dem Trennen eine zusätzliche Bestätigung angezeigt wird.
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 unten stehende 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, dass das Problem behoben ist

1. Fordern Sie eine unterstützte schreibgeschützte Aktion für eine Ressource an, 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 überprü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 ohne Änderungen zu prüfen. 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 Integrationen verbinden und verwalten oder Fehlerbehebung für Build und Vorschau. 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 Support erhalten und fügen Sie Folgendes hinzu:

• Den Namen der Integration und die E-Mail-Adresse Ihres Atoms-Kontos.
• Den Link zum betroffenen Projekt oder Chat 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 nur nicht geheime Kennungen verwendet werden, die für die Untersuchung erforderlich sind.
• Den genauen Fehler, das Datum, die Uhrzeit und die Zeitzone; geben Sie, falls bekannt, 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 anzeigt. Entfernen Sie Passwörter, Anmeldecodes, API-Schlüssel, Token und nicht zusammenhängende private Daten aus allen Anhängen.