Connectors

• —Ein Konnektor verbindet eine externe App mit dem Assistenten, damit er dort nachschlagen und handeln kann. Slack, Notion, Google Drive, HubSpot und rund tausend weitere lassen sich verbinden. „Such das Angebot in Drive und sag mir, was darin zu den Preisen steht.“ „Poste dieses Update im Vertriebskanal.“ Konnektoren finden Sie in der Seitenleiste unter Konnektoren.
• —Um eine App zu verbinden, wählen Sie sie aus der Liste, legen fest, für wen sie ist und was der Assistent tun darf, und schließen den Vorgang dann auf der eigenen Anmeldeseite der App ab oder fügen dort einen Schlüssel aus der App ein. Das Passwort oder der Schlüssel geht nie durch den Chat von OpenEmail, seine API oder den Assistenten. Der Konnektor ist ausstehend, bis Sie fertig sind, und danach aktiv.
• —Ein Konnektor ist nur für Sie oder für den ganzen Workspace, und der Assistent darf darüber entweder nur nachschlagen oder auch Änderungen vornehmen. Das können Sie später ändern, und Sie können einen Konnektor pausieren und fortsetzen. Beim Trennen wird der Zugriff auch in der externen App aufgegeben. Wenn die App die Verbindung nicht mehr annimmt, verlangt der Konnektor, neu verbunden zu werden, und ein neuer Link bringt ihn als denselben Konnektor zurück.
• —In einem Chat sieht der Assistent, was verbunden ist, findet die passende Aktion in der App und liest sofort. Bei allem, was in der App etwas ändert, etwa eine Nachricht senden, einen Datensatz anlegen oder aktualisieren oder etwas löschen, zeigt er Ihnen zuerst eine Karte zum Bestätigen, auch wenn Sie ihn direkt darum gebeten haben. Ein Konnektor, der nur nachschlägt, lehnt Änderungen ab, und was eine App zurückgibt, wird als Information behandelt, nie als Anweisung.
• —Eine Aufgabe nutzt Konnektoren nur, wenn bei ihr unter Zusätzliche Werkzeuge die Option Konnektoren eingeschaltet ist, und nur die für den Workspace verbundenen, nie einen, der einer einzelnen Person gehört. Sie liest allein. Jede Änderung in einer App wartet unter Wartet auf Sie, ganz gleich, was die Aufgabe sonst allein tun darf, und eine Aufgabe, die Konnektoren nutzt, antwortet nie von selbst auf E-Mails: Jede Antwort wartet auf Ihre Bestätigung.
• —Jeder Aufruf über einen Konnektor wird 90 Tage lang festgehalten: wann, welche App und welche Aktion, ob er etwas gelesen oder geändert hat, ob er funktioniert hat und ob er aus einem Chat, einer Aufgabe, der API oder von einem Agenten kam. Was an die App gesendet wurde und was zurückkam, speichert OpenEmail nie.
• —Drei Berechtigungen entscheiden, wer was tut: eine, mit der man Konnektoren sieht und was darüber getan wurde, eine, mit der man sie vom Assistenten nutzen lässt, und eine, mit der man Apps verbindet, pausiert und trennt und festlegt, was der Assistent tun darf. Inhaber und Admins haben alle drei, Member hat die ersten beiden und Viewer die erste. Wer eine App verbinden darf, darf sie für sich selbst oder für den Workspace verbinden.
• —Ein Tarif umfasst für ein Konto 2 Konnektoren bei Free, 10 bei Starter und 50 bei Business, und noch einmal so viele für einen Workspace. Enterprise setzt kein eigenes Limit, und mehr als 200 sind in keinem Fall möglich. Wechselt ein Workspace in einen kleineren Tarif, werden die neuesten Konnektoren über dem Limit pausiert, nicht entfernt.
• —Die Verbindungen hält ein externer Anbieter, der auch bis zu ein Jahr lang aufzeichnet, was der Assistent an eine App sendet und was die App antwortet. Die Datenschutzerklärung führt ihn auf.
• —Konnektoren gibt es in der REST API unter /connectors, /connector-apps, /connector-categories und /connector-calls, in jedem SDK als connectors, auf der Kommandozeile als openemail connectors und auf dem MCP-Server. Über die API läuft eine Änderung sofort, ohne dass jemand gefragt wird, es entscheidet also der Aufrufer. Drei Webhook-Events melden Ihren Systemen, wenn ein Konnektor des Workspace verbunden wird, getrennt wird oder neu verbunden werden muss.

Das Verbinden dauert eine Minute, und die Anmeldung findet auf der Seite der App selbst statt.

1. 1Öffnen Sie Konnektoren in der Seitenleiste und suchen Sie die App unter Durchsuchen, nach ihrem Namen oder nach einer Kategorie.
2. 2Wählen Sie, für wen der Konnektor ist: nur für Sie oder für den ganzen Workspace.
3. 3Wählen Sie, was der Assistent darüber tun darf: nur nachschlagen oder auch Änderungen vornehmen.
4. 4Schließen Sie den Vorgang auf der Anmeldeseite der App ab oder fügen Sie dort einen Schlüssel aus der App ein. Der Konnektor ist ausstehend, bis Sie fertig sind, und danach aktiv.

• —Ihr Passwort oder Schlüssel für die App geht nie durch den Chat von OpenEmail, seine API oder den Assistenten.
• —Wenn eine App die Verbindung nicht mehr annimmt, meldet der Konnektor, dass er neu verbunden werden muss. Ein neuer Link bringt ihn als denselben Konnektor zurück, die Aufgaben, die ihn nutzen, laufen also weiter.
• —Pausieren Sie einen Konnektor, damit der Assistent ihn nicht mehr nutzt, und setzen Sie ihn fort, wenn Sie ihn wieder haben möchten.
• —Das Trennen entfernt den Konnektor und gibt auch den Zugriff auf, den er in der externen App hatte.
• —Konnektoren können für den ganzen Dienst ausgeschaltet sein. Die Seite ist dann ausgeblendet.

• —Inhaber und Admins haben alle drei. Die eingebaute Rolle Member hat connectors:read und connectors:use, und Viewer hat connectors:read.
• —Dieselbe Berechtigung gilt für beide Arten von Konnektor: Wer eine App verbinden darf, darf sie für sich selbst oder für den Workspace verbinden.

Konnektoren gibt es in der REST API unter /connectors, /connector-apps, /connector-categories und /connector-calls, in jedem SDK und in der CLI unter connectors und in den MCP-Tools, die auch der Assistent nutzt.