Skip to main content

​
Überblick

Eine Verbindung ist eine gespeicherte Anbindung zwischen nuwacom und einem externen Tool. Beim Verbinden eines Tools wie Google Calendar, HubSpot oder Slack entsteht eine Verbindung, die den für die Zusammenarbeit mit diesem Dienst nötigen Zugriff speichert. Jede Verbindung gehört der Person, die sie erstellt hat. Standardmäßig ist sie privat: Nur der Eigentümer sieht und nutzt sie, und Aktionen laufen mit den Zugriffsrechten des Eigentümers im externen Dienst.

​
Authentifizierungstypen

Die Art der Verbindung hängt vom jeweiligen Konnektor ab.

​
OAuth

Die meisten gängigen Konnektoren nutzen OAuth, das branchenübliche Protokoll für sichere Autorisierung:
  1. nuwacom leitet zur Anmeldeseite des Dienstes weiter, etwa Google oder Microsoft.
  2. Mit dem eigenen Konto anmelden.
  3. Die angeforderten Berechtigungen bestätigen.
  4. nuwacom speichert den Zugriff sicher.
Die Verbindung handelt in deinem Namen. Lässt sich ein Kalender in Google nicht öffnen, kann auch ein Agent über deine Verbindung ihn nicht öffnen.

​
API-Schlüssel / Token

Manche Konnektoren, besonders eigene, werden mit einem API-Schlüssel oder Token eingerichtet. Dieser wird aus den Einstellungen des Dienstes kopiert und beim Verbinden in nuwacom eingefügt.

​
Verbindung erneuern

Ist eine Verbindung abgelaufen oder widerrufen, zeigt das zugehörige Konto ein Warnsymbol mit dem Hinweis Verbindungsproblem. Durch erneutes Verbinden des Kontos wird der Zugriff wiederhergestellt.

​
Wer eine Verbindung nutzen kann

​
Standardmäßig privat

Eine neue Verbindung wird als Privates Konto angezeigt:
  1. Nur der Eigentümer sieht und nutzt sie.
  2. Aktionen laufen mit den Zugriffsrechten des Eigentümers.
  3. Zugangsdaten werden anderen Nutzern nie angezeigt.

​
Konto teilen

Der Eigentümer kann ein Konto über Einstellungen → Konnektoren teilen:
  1. Das Konto in der Liste suchen.
  2. Das Teilen-Symbol daneben auswählen ({Kontoname} teilen).
  3. Den Zugriff festlegen: bestimmte Nutzer, Nutzergruppen oder alle Workspace-Nutzer.
Geteilte Konten sind als Geteiltes Konto gekennzeichnet. Das Teilen mit dem gesamten Workspace steht zur Verfügung, sofern die eigene Rolle das Teilen mit dem Workspace erlaubt. Ein Konto sollte nur mit Personen geteilt werden, denen das Handeln über dieses Konto anvertraut werden kann. Alle mit Zugriff arbeiten mit den Berechtigungen des Eigentümers im externen Dienst.

​
Standardkonto in einem Agent nutzen

Über ein Standardkonto führen andere Personen eine Konnektor-Aktion mit einem bestimmten Konto aus, ohne dass das Konto selbst geteilt wird. Die Nutzung ist ausschließlich über den Agent möglich, die Zugangsdaten bleiben dabei verborgen.

​
Einrichten

  1. In der Seitenleiste Agenten öffnen und einen Agent öffnen oder erstellen.
  2. Unter Aktionen die Option Aktion hinzufügen wählen und die Konnektor-Aktion auswählen.
  3. Standardkonto auswählen wählen.
  4. Das Konto auswählen und Aktion hinzufügen wählen.
  5. Den Agent veröffentlichen und mit den vorgesehenen Personen teilen.

​
Die zwei Modi

  1. Standardkonto auswählen: Ein Konto wird für alle verwendet, die die Aktion ausführen. Unabhängig von den eigenen Konten der Nutzer läuft die Aktion mit dem Zugriff dieses Kontos.
  2. Jeder Benutzer muss seinen eigenen Account verwenden (Erweitert): Jede Person nutzt ihr eigenes Konto. Wer noch nicht verbunden ist, wird zur Verbindung aufgefordert.

​
Beispiele

  1. Standardkonto: Ein „Team Kalendar Agent” nutzt einen gemeinsamen Teamkalender. Nutzt ihn ein Kollege, landet der Termin im Teamkalender.
  2. Eigenen Account: Ein „Persönlicher E-Mail-Agent” versendet Mails aus dem Postfach des jeweiligen Nutzers über dessen eigene Verbindung.
Ist für eine Aktion kein Konto ausgewählt, verbindet jeder Nutzer bei der Verwendung des Agenten sein eigenes Konto.

​
Apps

Apps werden immer mit den verbundenen Konten der Person ausgeführt, die sie öffnet. Die eigenen verbundenen Konten bleiben privat und werden nie von Personen genutzt, mit denen eine App geteilt wird.

​
Den richtigen Ansatz wählen

​
FAQ

Die Verbindung gehört der Person, die sie erstellt hat. Sie bleibt privat, bis sie mit anderen Nutzern oder dem Workspace geteilt wird.
Prüfe, ob das verbundene Konto mit dem Kollegen geteilt wurde oder ob im Agent ein Standardkonto ausgewählt ist.Trifft beides nicht zu, muss der Kollege sein eigenes Konto verbinden.
Die Verbindung ist möglicherweise abgelaufen oder wurde widerrufen.Das Konto kann unter Einstellungen → Konnektoren erneut verbunden werden.