Aan de slag
Externe Apps verbinden met uw Agents
Connections let a Kapsule Agents expert work inside apps you already use, with your permission, and they are entirely separate from what an expert can do on your Kapsule account.
Wat een verbinding is
Een verbinding is een aangemelde koppeling tussen een van uw experts en een externe app. Eenmaal verbonden kan die expert de gereedschappen van de app in een gesprek gebruiken: een document lezen, een bericht opstellen, een record controleren. Zonder verbinding heeft de expert helemaal geen toegang.
Er zijn twee dingen waar het goed is voorzichtig mee te zijn:
- Een verbinding geeft toegang tot die app, niet tot uw Kapsule-account. De twee machtigingensets mengen nooit.
- Alles wat iets verandert in de verbonden app gaat nog steeds door dezelfde bevestigingskaart als een wijziging in uw Kapsule-account. Lezen gebeurt onmiddellijk; schrijven vraagt eerst toestemming.
Verbindingen bevinden zich op Agents, vervolgens Verbindingen beheren, of ga rechtstreeks naar /agents/connections. De Agents-startpagina toont ook een Verbindingskaart met enkele voorbeeldapps.
Welke experts kunnen welke apps gebruiken
De lijst is bewust voorzichtig, en elke expert ziet alleen de apps die zijn taak nodig heeft. Sommige zijn beperkt tot alleen-lezen gereedschappen, zelfs wanneer de app zelf meer kan:
| Expert | Externe apps die het kan bereiken |
|---|---|
| Mara, Business Advisor | Stripe (alleen lezen) |
| Thea, Creative Writer | Notion |
| Sef, SEO Consultant | GitHub (alleen lezen) |
| Mila, Marketing Planner | Gmail, Slack, Notion, Google Calendar |
| Cora, Customer Comms | Gmail, Slack |
| Ash, Sales and Outreach | Gmail, Slack, Stripe (alleen lezen) |
| Pip, Policy and Docs | Geen |
Het verbinden van een app geeft deze niet aan het hele team. Het wordt alleen beschikbaar voor de experts in de bovenstaande rij.
Een app verbinden
- Open Agents, vervolgens Verbindingen beheren.
- Blader door het tabblad Populair, schakel over naar Alle apps, of typ in het zoekvak. Elke kaart toont de appnaam en hoeveel gereedschappen deze exposeert.
- Klik op Verbinden op de gewenste app. De knop verandert in Openen... terwijl het aanmeldvenster wordt voorbereid.
- Meld u aan bij de app zelf en keur de gevraagde toegang goed.
- U keert terug naar de pagina Verbindingen met een bevestiging [app] verbonden.
Eenmaal verbonden toont de kaart een Verbonden badge, het accountlabel waarmee u bent aangemeld, en wanneer de verbinding voor het laatst is gebruikt, of Nog niet gebruikt.
Verbindingsstatussen
| Status | Wat het betekent | Wat u moet doen |
|---|---|---|
| Verbonden | Werkt. Uw experts kunnen het gebruiken. | Niets |
| In behandeling | Het aanmelden is gestart maar nooit afgerond. | Klik op Verbinden voltooien |
| Opnieuw verbinden vereist | De toegang is verlopen of ingetrokken aan het einde van de app. | Klik op Opnieuw verbinden |
De status Opnieuw verbinden vereist is normaal in de loop van de tijd: de meeste apps verlopen de toegang die zij verlenen volgens een schema. Opnieuw verbinden herstelt het zonder iets kwijt te raken.
Hoe dit veilig blijft
De pagina Verbindingen geeft het veiligheidsmodel in drie regels weer, en het is de moeite waard om te begrijpen in plaats van vluchtig door te nemen:
- Behandeld door een gecertificeerde partner. Het aanmelden bij een app wordt afgehandeld door onze gecertificeerde integratepartner, die het machtigingsbewijs bezit. Uw appwachtwoord raakt Kapsule nooit aan.
- Bevestiging vóór actie. Agents vragen voordat zij actie ondernemen. Alles wat iets verandert vereist eerst uw instemming.
- Onmiddellijke intrekking. Het verbreken van de verbinding beëindigt de toegang direct, zowel hier als bij de app.
Behandel een verbinding als een sleutel die u voor iemand hebt laten maken. Verbind de accounts waarin u wilt dat uw experts werken, niet elke account die u bezit. Als u niet zeker weet of een expert een app nodig heeft om de taak die u voor ogen hebt uit te voeren, verbind deze dan niet: vraag eerst, verbind dan.
Een app verbreken
- Open Agents, vervolgens Verbindingen beheren.
- Klik op Verbreken op de verbonden app.
- Er verschijnt een bevestiging: Uw team verliest onmiddellijk toegang tot [app]. Alles wat het al heeft gebruikt, blijft in uw eerdere chats.
- Klik op Verbreken om te bevestigen.
De toegang eindigt onmiddellijk. Dit doet niet betekenen dat de inhoud van de app uit gesprekken die u al voerde wordt verwijderd: als een expert vorige week een document in een chat heeft geciteerd, die tekst is nog steeds in het chatverslag. Het verbreken van de verbinding gaat over toekomstige toegang, niet om retroactieve wissing.
Wanneer Verbindingen niet beschikbaar is op uw account
Als de pagina Verbindingen een enkele rustige kaart toont met de tekst Verbindingen zijn nog niet beschikbaar, is het verbinden van externe apps niet ingeschakeld voor uw account. De kaart maakt duidelijk dat er niets is verbonden en niets toegang heeft, wat in die situatie precies de waarheid is. Uw experts werken nog steeds; zij kunnen alleen Kapsule niet bereiken.
De rest van Agents wordt niet beïnvloed. Chats, Skills en accountlezingen werken allemaal normaal.
Wat als het mislukt
"Toestemming werd niet verleend, dus er is niets verbonden." U hebt geannuleerd of geweigerd op het goedkeuringsscherm van de app zelf. Er is niets gemaakt. Klik opnieuw op Verbinden en keur de toegang goed.
"Verbindingen zijn nu niet beschikbaar. Probeer het over een moment opnieuw." De integratieservice kon niet worden bereikt. Dit is opzettelijk beveiligd tegen fouten: in plaats van een half gebouwde lijst weer te geven, toont de pagina niets. Wacht een minuut en laad opnieuw.
"Verbindingen konden niet worden geladen." Uw instellingen zijn veilig. Vernieuw de pagina. Als het aanhoudt, open een ondersteuningsticket.
Een expert zegt dat het een verbonden app niet kan bereiken. Raadpleeg de tabel hierboven. Niet elke expert mag elke app gebruiken, en een app die voor Cora is verbonden, is niet automatisch beschikbaar voor Mara.
Een verbinding staat op In behandeling. Het aanmeldvenster werd gesloten voordat het klaar was. Klik op Verbinden voltooien en voltooi het.
Wat verbindingen kosten
Het gebruik van een verbonden app in een gesprek wordt gemeten zoals elk ander werk. Elke aanroep die een expert aan een externe app doet, wordt in rekening gebracht met het gewicht van de verbindingsaanroep, wat een fractie van wat een lang stuk schrijven kost. Lezingen op uw Kapsule-account blijven gratis. De volledige weging staat in Hoe Agent-credits werken.