Integratie-probleemoplossing

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

Begin met deze controles

1. Controleer waar de fout optreedt. Kan de Agent een service niet 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 Connect and Manage Integrations.
2. Open de Integratie. Open in de Chat van je project het optiemenu naast het berichtinvoerveld en kies vervolgens Connectors → Add connectors. Zoek 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, property of andere betrokken resource 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 schermafbeeldingen.

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 in een supportverzoek. Voer inloggegevens alleen in via de aanmeldingsflow van de service of in het daarvoor bestemde beveiligde configuratieveld.

Vind je probleem

Wat je ziet	Waar je moet beginnen
Een service ontbreekt, of de bedieningselementen ervan zijn niet beschikbaar	Een Integratie vinden of starten
Aanmelden wordt niet geopend, wordt geblokkeerd of wordt nooit voltooid	Autorisatie voltooien
De verbinding gebruikt een ander account	Het verbonden account controleren
Verbonden, maar de Agent kan een resource niet vinden	De verbinding en gegevenstoegang controleren
Lezen werkt, maar maken of bewerken mislukt	Schrijftoegang en ondersteunde acties controleren
Een eerder werkende verbinding faalt	Controleren wat er is veranderd
Resultaten zijn verouderd, aanvragen verlopen door een time-out of fouten herhalen zich	De aanvraag en beschikbaarheid van de service controleren

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 erbij. Als er een andere rol of machtiging voor nodig is, vraag dan de eigenaar van het project of de Werkruimte om hulp. Verbreek niet de verbinding met een andere service 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 Connect and Manage Integrations 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 autorisatieflow van de service voordat je het venster sluit.
3. Als de service expliciet aangeeft 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 resource 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 standaardlay-out gebruiken, wordt Connect vervangen door Disconnect en Try it out. Andere services hebben hun eigen lay-outs. Als nog steeds Connect wordt aangeboden of een fout wordt weergegeven, leg dat resultaat dan vast en neem na één nieuwe poging contact op met support.

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 resource of er toegang toe heeft. Niet elke connector toont het verbonden account, dus gebruik niet alleen de huidige aanmelding van de Browser als bewijs van welk account Atoms gebruikt.

Open de resource rechtstreeks in de service met het bedoelde account. Als dat account er geen toegang toe heeft, vraag dan eerst de eigenaar van de resource 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 kleine, ondersteunde leesaanvraag retourneert de bedoelde resource. 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 resource waar dat wordt weergegeven.
2. Controleer de exacte resource. Open deze rechtstreeks in de service met het bedoelde account. Bevestig de locatie en toegangsrechten, inclusief de juiste organisatie, Werkruimte, map of property waar relevant.
3. Maak de aanvraag specifiek. Noem de service en geef de exacte naam of link van de resource op wanneer de connector dat ondersteunt. Vraag eerst om één ondersteunde leesactie, in plaats van meerdere resources 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. Wijzig niets.”

Controleer het resultaat: De Agent retourneert de bedoelde resource. 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 Connect and Manage Integrations 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 resource. Vraag de eigenaar van de resource 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 flow 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 gemaakt of gewijzigd. Een mislukte reactie is niet voldoende bewijs dat er geen wijziging heeft plaatsgevonden. Herhaal geen betaling, bericht, uitnodiging of het maken van een record totdat je het vorige resultaat kent.

Controleer het resultaat: Een ondersteunde wijziging slaagt op een geschikte testresource, en je bevestigt dit rechtstreeks 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 de laatste succesvolle aanvraag: het account, de toegang ervan tot de resource, 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 resource rechtstreeks in de service te openen. Als de toegang is verwijderd, los dit dan op met de eigenaar van de resource of de beheerder.
3. Als de fout aangeeft dat de autorisatie is verlopen, is ingetrokken of ongeldig is, volg dan Maak veilig opnieuw verbinding. Als de fout betrekking heeft op een storing, limiet of niet-ondersteunde actie van een service, pak die oorzaak dan eerst aan.

Controleer het resultaat: Een kleine leesaanvraag werkt weer. Als dezelfde fout blijft bestaan, sla deze dan samen met het tijdstip van de laatste succesvolle poging op en neem contact op met support.

Resultaten zijn verouderd of een aanvraag blijft mislukken

1. Vergelijk het resultaat met de service zelf. Bevestig waar relevant het account, de resource, 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 aanvragen 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 kleine leesaanvraag 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 resource 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.

Maak veilig opnieuw verbinding

Maak opnieuw verbinding wanneer de autorisatie ongeldig is of het verkeerde account is gekoppeld — niet als eerste stap bij elke mislukte aanvraag.

Voordat je de verbinding verbreekt: Rond taken af of pauzeer taken die afhankelijk zijn van de verbinding, controleer het resultaat van een eventuele externe schrijfactie die nog in behandeling is en zorg ervoor dat je opnieuw kunt aanmelden met de vereiste toegang. Door de verbinding te verbreken is de verbinding niet beschikbaar totdat deze opnieuw is verbonden. Controleer Connect and Manage Integrations 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 terugkeert, 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 resource die je rechtstreeks kunt verifiëren. Als je Try it out gebruikt, controleer dan de voorgestelde prompt voordat je deze verzendt.
2. Vergelijk de reactie met de service zelf. Bevestig de juiste resource, accountcontext en het gevraagde resultaat — niet alleen de indicator dat er verbinding is.
3. Als je taak wijzigingen vereist, gebruik dan een geschikte testresource of de gedocumenteerde testworkflow van de service en verifieer het resultaat op de bestemming.

Controleer de verbindingsstatus en de geselecteerde resource. Alleen een indicator dat er verbinding is, bevestigt niet dat de verwachte gegevens beschikbaar of actueel zijn.

Bevestig de organisatie en het project en open vervolgens Dashboard om de resource 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 Connect and Manage Integrations of probleemoplossing voor build en preview. Controleer de omgeving waarin de fout optreedt; een succesvolle Chat-aanvraag is geen bewijs dat de app correct is geconfigureerd.

Hulp krijgen

Als het probleem aanhoudt, gebruik dan Get support en voeg het volgende toe:

• De naam van de Integratie en het e-mailadres van je Atoms-account.
• De link naar het getroffen project of de getroffen 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 resource, met alleen niet-geheime identificatoren die nodig zijn voor onderzoek.
• De exacte fout, datum, tijd en tijdzone; voeg het tijdstip van de laatste succesvolle poging toe als dat 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 schermafbeeldingen 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.