Probleemoplossing voor Integratie

Als een integratie geen verbinding maakt, stopt met werken of een taak niet kan voltooien, gebruik dan deze gids om de verbinding, accounttoegang en de geselecteerde bron te controleren.

Deze pagina behandelt veelvoorkomende verbindings- en autorisatieproblemen in Atoms. Voor servicespecifieke installatie, ondersteunde acties of configuratie binnen je app, begin met Integraties verbinden en beheren en kies de gids van je service.

Begin met deze controles

1. Controleer waar de fout optreedt. Kan de Agent geen service gebruiken in Chat, of faalt de functie alleen in je app? Een service verbinden voor Chat bevestigt op zichzelf niet dat je app correct is geconfigureerd. Voor fouten die alleen in de app optreden, zie Integraties verbinden en beheren.
2. Open de integratie. Open in de Chat van je project het optiemenu naast het berichtinvoerveld en kies vervolgens Connectors → Add connectors. Zoek naar de service en selecteer deze. Controleer of deze verbonden is of nog steeds Connect aanbiedt. Sommige services openen hun eigen beheerscherm.
3. Controleer de toegang in de service zelf. Bevestig dat het account dat je wilde verbinden het exacte bestand, de repository, agenda, eigenschap of andere betrokken bron kan openen.
4. Sla de fout op voordat je iets wijzigt. Noteer het exacte bericht, de tijd en tijdzone, het getroffen project of de getroffen Chat en de laatste succesvolle poging. Maak privé-informatie onleesbaar in screenshots.

Open de invoeropties van Chat, kies Connectors (1) en vervolgens Add connectors (2) om beschikbare integraties te bekijken.

Je kunt beschikbare verbindingen ook beheren in Settings → Connectors. Selecteer de integratie die je wilt controleren.

Houd inloggegevens privé. Plak nooit wachtwoorden, inlogcodes, API-sleutels, toegangstokens of andere geheimen in Chat of een supportverzoek. Voer inloggegevens alleen in via de aanmeldingsstroom van de service of in het daarvoor bestemde beveiligde configuratieveld.

Vind je probleem

Je kunt een integratie niet vinden of starten

1. Gebruik Add connectors om in de catalogus te zoeken. De kortere lijst in het Chat-menu is niet de volledige catalogus.
2. Als Atoms zegt dat de functie alleen beschikbaar is binnen een project, open dan het bedoelde project en probeer het daar.
3. Als een bedieningselement is uitgeschakeld, lees dan de uitleg. Als er een andere rol of machtiging voor nodig is, vraag dan de eigenaar van het project of de werkruimte om hulp. Koppel geen andere service los alleen om een beperking te omzeilen.

Controleer het resultaat: Je kunt het verbindings- of beheerscherm van de service openen. Als deze nog steeds niet verschijnt, controleer dan Integraties verbinden en beheren of neem contact op met support om de beschikbaarheid te bevestigen. Ga er niet van uit dat een ontbrekende service kan worden ingeschakeld door herhaalde aanmeldpogingen.

Autorisatie wordt niet voltooid

1. Selecteer Connect één keer en zoek naar het aanmeldvenster van de service. Als je browser meldt dat een pop-up is geblokkeerd, sta dan pop-ups toe voor de Atoms-site en probeer het opnieuw. Volg in Chrome de instructies voor het toestaan van pop-ups van een specifieke site; je hoeft ze niet voor elke site in te schakelen.
2. Kies het bedoelde account en controleer de gevraagde toegang. Voltooi de autorisatiestroom van de service voordat je het venster sluit.
3. Als de service expliciet zegt dat je organisatie de app of de gevraagde toegang heeft geblokkeerd, sla het bericht dan op en neem contact op met je beheerder. Omzeil het beleid van je organisatie niet.
4. Ga terug naar Atoms en open de integratie opnieuw om de status te controleren. Het sluiten van een aanmeldvenster is geen bevestiging dat de autorisatie is geslaagd.

Controleer de gevraagde toegang voordat je de autorisatie voltooit. Het autoriseren van een account bevestigt op zichzelf niet dat de bedoelde bron is verbonden.

Als autorisatie een selector voor organisatie of werkruimte bevat, bevestig dan de bedoelde selectie en controleer de gevraagde machtigingen.

Controleer het resultaat: De integratie wordt als verbonden weergegeven. Op detailschermen van connectors die de standaardindeling gebruiken, wordt Connect vervangen door Disconnect en Try it out. Andere services hebben hun eigen indelingen. Als nog steeds Connect wordt aangeboden of een fout wordt weergegeven, leg dat resultaat dan vast en neem contact op met support na één nieuwe poging.

Het verkeerde account is verbonden

Als het beheerscherm van de integratie een account toont, vergelijk dit dan met het account dat eigenaar is van de bron of er toegang toe heeft. Niet elke connector toont het verbonden account, dus gebruik de huidige aanmelding van de browser niet als enig bewijs van welk account Atoms gebruikt.

Open de bron direct in de service met het bedoelde account. Als dat account er geen toegang toe heeft, vraag dan eerst de eigenaar van de bron om toegang. Als de verbinding het verkeerde account gebruikt, volg dan de instructies van de service voor het wisselen van account of maak veilig opnieuw verbinding en kies tijdens de autorisatie expliciet het juiste account.

Controleer het resultaat: Een klein, ondersteund leesverzoek retourneert de bedoelde bron. Als je nog steeds niet kunt vaststellen welk account is verbonden, neem dan contact op met support in plaats van herhaaldelijk de verbinding te verbreken.

De integratie is verbonden, maar de Agent kan je gegevens niet vinden

1. Controleer de verbinding. Open de details van de integratie in Connectors en bevestig dat deze verbonden is. Controleer het geselecteerde account of de geselecteerde bron waar dat wordt weergegeven.
2. Controleer de exacte bron. Open deze direct in de service met het bedoelde account. Bevestig de locatie en toegangsrechten, inclusief de juiste organisatie, werkruimte, map of eigenschap waar relevant.
3. Maak het verzoek specifiek. Noem de service en geef de exacte naam of link van de bron wanneer de connector dat ondersteunt. Vraag eerst om één ondersteunde leesactie, in plaats van meerdere bronnen tegelijk te zoeken en te wijzigen.

Bijvoorbeeld, als de connector het lezen van documenten ondersteunt: “Gebruik [service] om [documentnaam of link] te lezen en vertel me de titel ervan. Wijzig het niet.”

Controleer het resultaat: De Agent retourneert de bedoelde bron. Als directe toegang werkt maar de Agent deze nog steeds niet kan lezen, controleer dan de ondersteunde mogelijkheden en verleende toegang van de connector. Maak alleen opnieuw verbinding als er bewijs is van een autorisatieprobleem.

De Agent kan gegevens lezen, maar niet wijzigen

Succesvol lezen bevestigt niet dat de connector de gevraagde wijziging ondersteunt of toestemming heeft om deze uit te voeren.

1. Zie Integraties verbinden en beheren of de lijst What you can do van de connector, indien weergegeven. Bevestig dat de gevraagde actie wordt ondersteund.
2. Controleer of het verbonden account die wijziging mag aanbrengen in de exacte bron. Vraag de eigenaar van de bron of de beheerder alleen om de toegang die nodig is.
3. Lees eventuele fout- of bevestigingsverzoeken. Als aanvullende autorisatie vereist is, volg dan de gedocumenteerde stroom van de service. Opnieuw verbinden kan geen actie toevoegen die de connector niet ondersteunt.

Voordat je een schrijfactie opnieuw probeert: Controleer de bestemming om te zien of de eerste poging al iets heeft aangemaakt of gewijzigd. Een mislukte reactie is niet voldoende bewijs dat er geen wijziging heeft plaatsgevonden. Herhaal geen betaling, bericht, uitnodiging of het aanmaken van een record totdat je het vorige resultaat kent.

Controleer het resultaat: Een ondersteunde wijziging slaagt op een geschikte testbron en je bevestigt dit direct in de service. Gebruik voor betalingen of andere live workflows de servicespecifieke testinstructies in plaats van een echte transactie.

Een verbinding die eerder werkte, is gestopt

Controleer wat er is veranderd sinds het laatste succesvolle verzoek: het account, de toegang ervan tot de bron, het app-beleid van de organisatie of de autorisatie van de verbinding.

1. Open de integratie opnieuw in Atoms en controleer of deze nog steeds verbonden is.
2. Probeer de bron direct in de service te openen. Als de toegang is verwijderd, los dat dan op met de eigenaar van de bron of de beheerder.
3. Als de fout zegt dat de autorisatie is verlopen, is ingetrokken of ongeldig is, volg dan Veilig opnieuw verbinden. Als de fout betrekking heeft op een storing van de service, een limiet of een niet-ondersteunde actie, pak dan eerst die oorzaak aan.

Controleer het resultaat: Een klein leesverzoek werkt weer. Als dezelfde fout blijft bestaan, sla deze dan samen met de laatste succesvolle tijd op en neem contact op met support.

Resultaten zijn verouderd of een verzoek blijft mislukken

1. Vergelijk het resultaat met de service zelf. Bevestig waar relevant het account, de bron, het datumbereik, filters en de tijdzone. Vraag de Agent om de huidige waarde op te halen in plaats van te vertrouwen op een eerder antwoord in het gesprek.
2. Controleer bij een expliciete time-out of service-unavailable-fout de officiële status- of helppagina van de service. Als de fout een tijd voor opnieuw proberen geeft, wacht dan tot dat moment; stuur geen herhaalde verzoeken terwijl de limiet of storing aanhoudt.
3. Sla niet-verzonden tekst op, vernieuw Atoms en controleer de status van de connector opnieuw. De pagina vernieuwen is niet hetzelfde als het account opnieuw autoriseren.
4. Probeer één klein leesverzoek opnieuw. Controleer voordat je iets opnieuw probeert dat externe gegevens wijzigt de bestemming op het eerdere resultaat.

Controleer het resultaat: Het nieuwe resultaat komt overeen met de bedoelde bron in de service. Als het onjuist blijft, stuur support dan de verwachte en werkelijke waarden met tijdstempels. Ga er niet van uit dat elke integratie volgens hetzelfde schema wordt bijgewerkt.

Veilig opnieuw verbinden

Maak opnieuw verbinding wanneer de autorisatie ongeldig is of het verkeerde account is gekoppeld — niet als eerste stap bij elk mislukt verzoek.

Voordat je de verbinding verbreekt: Rond taken af of pauzeer taken die afhankelijk zijn van de verbinding, controleer het resultaat van eventuele wachtende externe schrijfacties en zorg ervoor dat je opnieuw kunt inloggen met de vereiste toegang. Door de verbinding te verbreken is deze niet beschikbaar totdat deze opnieuw is verbonden. Controleer Integraties verbinden en beheren op eventuele aanvullende effecten; ga er niet van uit dat het verbreken van de verbinding eerdere wijzigingen ongedaan maakt of al verzonden werk annuleert.

1. Open de verbindingsdetails van de service. Als deze een eigen scherm voor accountbeheer heeft, volg dan de instructies van die integratie.
2. Selecteer op het standaard detailscherm van de connector Disconnect wanneer je klaar bent en selecteer vervolgens Connect. Ga er niet van uit dat er een extra bevestiging komt voordat de verbinding wordt verbroken.
3. Kies het bedoelde account en voltooi de autorisatie. Controleer de gevraagde machtigingen.
4. Ga terug naar Atoms en bevestig de verbonden status.
5. Voer de onderstaande herstelcontrole uit voordat je de oorspronkelijke taak hervat.

Als dezelfde fout terugkomt, stop dan met opnieuw verbinden en neem contact op met support met de fout en de controles die al zijn uitgevoerd.

Controleer of het probleem is opgelost

1. Vraag om één ondersteunde, alleen-lezen actie op een bron die je direct kunt verifiëren. Als je Try it out gebruikt, controleer dan de voorgestelde prompt voordat je deze verzendt.
2. Vergelijk het antwoord met de service zelf. Bevestig de juiste bron, accountcontext en het gevraagde resultaat — niet alleen de verbonden-indicator.
3. Als je taak wijzigingen vereist, gebruik dan een geschikte testbron of de gedocumenteerde testworkflow van de service en verifieer het resultaat op de bestemming.

Controleer de verbindingsstatus en de geselecteerde bron. Alleen een verbonden-indicator bevestigt niet dat de verwachte gegevens beschikbaar of actueel zijn.

Bevestig de organisatie en het project en open vervolgens Dashboard om de bron te inspecteren zonder wijzigingen aan te brengen. Het verbreken van de verbinding maakt geen deel uit van deze controle.

Als de controle slaagt, hervat dan je taak. Als Chat werkt maar de functie nog steeds faalt binnen je app, zie dan Integraties verbinden en beheren of probleemoplossing voor build en preview. Controleer de omgeving waarin de fout optreedt; een succesvol Chat-verzoek is geen bewijs dat de app correct is geconfigureerd.

Hulp krijgen

Als het probleem aanhoudt, gebruik dan Support krijgen en voeg het volgende toe:

• De naam van de integratie en het e-mailadres van je Atoms-account.
• Het getroffen project of de link naar Chat, en of de fout optreedt in Chat of in je app. Geef voor een app de getroffen omgeving aan.
• Het bedoelde serviceaccount en de bedoelde bron, met alleen niet-geheime identificatoren die nodig zijn voor onderzoek.
• De exacte fout, datum, tijd en tijdzone; voeg de laatste succesvolle tijd toe als die bekend is.
• De stappen om het probleem te reproduceren, het verwachte resultaat, het werkelijke resultaat en controles die al zijn geprobeerd.
• Je browser en apparaat, plus onleesbaar gemaakte screenshots of een korte opname indien nuttig.

Geef bij een mislukte schrijfactie aan of de bestemming een voltooide wijziging, geen wijziging of een onbekend resultaat toont. Verwijder wachtwoorden, inlogcodes, API-sleutels, tokens en niet-gerelateerde privégegevens uit alle bijlagen.