Integrationen
Verbinden Sie Drittanbieter-Dienste, um deren Aktionen und Ereignisse in Ihren Workflows zu nutzen
Integrationen erweitern Workflows um Aktionen externer Dienste: eine Slack-Nachricht senden, ein Jira-Issue anlegen, einen Salesforce-Datensatz abfragen und vieles mehr. Viele Integrationen bringen außerdem Trigger-Ereignisse mit. Ein Workflow startet dann von selbst, sobald in dem Dienst etwas passiert.
Eine Integration verbinden
- Öffnen Sie Einstellungen → Integrationen. In Workflows führt der Eintrag Externe Integrationen unter Daten & Integrationen in der Seitenleiste auf dieselbe Seite.
- Suchen Sie den Dienst und öffnen Sie ihn. Bei langen Listen hilft das Suchfeld oben.
- Klicken Sie auf Verbindung hinzufügen und melden Sie sich an. Je nach Dienst sehen Sie eine OAuth-Freigabeseite oder ein Formular für einen API-Key.
Sie können mehrere Konten desselben Dienstes verbinden, etwa zwei Slack-Workspaces. Im Knoten wählen Sie das Konto unter Verbindung aus.
Danach erscheinen die Aktionen des Dienstes in der Knotenauswahl unter Integrationen und seine Trigger-Ereignisse unter Integrations-Trigger.
Authentifizierungsarten
| Art | Dienste |
|---|---|
| OAuth 2.0 | Slack, Teams, Outlook E-Mail, Outlook-Kalender, OneDrive, SharePoint, Excel, Microsoft To Do, Jira, Confluence, GitHub, Notion, HubSpot, Salesforce, Calendly, Zoom, Gmail, Google Drive, Docs, Sheets, Slides, Tasks, Calendar, Meet und Analytics |
| API-Key | Discord (Bot-Token), Telegram, Personio, Stripe, Google Maps, OpenAI, OpenRegister |
| Keine | Datentabelle, die fest eingebaut ist |
Wer eine Verbindung nutzen darf
Eine Verbindung gehört der Person, die sie angelegt hat. Die Zugangsdaten werden verschlüsselt gespeichert und erscheinen nie in den Ausgaben eines Workflows.
- Ihre eigenen Workflows können Ihre eigenen Verbindungen nutzen.
- Wenn Sie einen Workflow teilen, werden die darin verwendeten Verbindungen mitgeteilt, allerdings nur für die Ausführung dieses Workflows. Der Teilen-Dialog listet sie auf und zeigt für jede, ob sie auch außerhalb des Workflows Geteilt oder Nicht geteilt ist.
- Sollen Kolleginnen und Kollegen eine Ihrer Verbindungen in eigenen Workflows verwenden, teilen Sie die Verbindung selbst auf der Integrationsseite.
Authentifizierte Anfrage
Bietet ein Dienst einen API-Endpunkt, für den es keinen Knoten gibt, nutzen Sie seinen Knoten Authenticated Request. Er steht im Knotenwähler bei den übrigen Aktionen des Dienstes (Suche nach „Authentifizierte Anfrage" oder „Authenticated Request"). Wählen Sie die Verbindung und dann die Anfrage:
| Eingabe | Pflicht | Beschreibung |
|---|---|---|
| Method | Ja | GET (Standard), POST, PUT, PATCH oder DELETE |
| URL | Ja | Ein Pfad relativ zur API-Adresse der Verbindung (steht unter dem Feld) oder eine vollständige URL der API des Dienstes |
| Headers | Nein | Weitere Header. Keine Zugangsdaten eintragen, die werden automatisch ergänzt |
| Request Body | Nein | Inhalt für POST, PUT und PATCH; wird als JSON gesendet, solange Sie keinen Content-Type setzen |
| Response Type | Nein | Auto (text/JSON) (Standard) oder File (binary) |
| File Name | Nein | Name der heruntergeladenen Datei beim Antworttyp File (binary) |
| Ausgabe | Typ | Beschreibung |
|---|---|---|
response | any | Der Antwortinhalt, als JSON oder Text. null beim Antworttyp File |
statusCode | number | HTTP-Statuscode |
headers | object | Antwort-Header |
file | WorkflowFile | Die heruntergeladene Datei, nur beim Antworttyp File |
- DeutschlandGPT ergänzt die Zugangsdaten so, wie der Dienst sie erwartet. Sie erscheinen nie im Workflow, in seinen Ausgaben oder im Ausführungsverlauf.
- Eine relative URL wird an die API-Adresse der Verbindung angehängt. Bei Jira ist das
https://api.atlassian.com/ex/jira/<Ihre Site>,/rest/api/3/myselfgenügt also. - Die Anfrage geht nur an die API des Dienstes selbst. Jede andere Adresse, auch über eine Weiterleitung, wird abgelehnt. Beim Antworttyp
File (binary)wird eine Weiterleitung auf einen Download-Host verfolgt, ohne die Zugangsdaten. - Bei
Auto (text/JSON)lässt eine binäre Antwort den Knoten mit dem Hinweis fehlschlagen, aufFile (binary)umzustellen. Eine Datei wird bis 100 MB gespeichert, andere Antworten sind auf 10 MB begrenzt. - Eine Antwort mit einem Status außerhalb von 200–299 gilt als Fehler, wie beim Knoten HTTP-Anfrage.
- Schreibende Anfragen richten sich nach den Berechtigungseinstellungen Ihrer Organisation für die Integration: Hat eine Administratorin oder ein Administrator eine Berechtigung abgeschaltet, wird die Anfrage abgelehnt.
Im Knoten Code steht dieselbe Anfrage als fetchAs bereit.
Get Auth Credentials
Der Knoten Get Auth Credentials lässt sich nicht mehr neu hinzufügen. Bestehende Knoten funktionieren für Anfragen an den Dienst selbst weiter und zeigen einen Hinweis; für Neues nutzen Sie Authentifizierte Anfrage oder fetchAs.
Seine Ausgabe authToken ist nicht das Token, sondern ein Verweis der Form dgpt:credential[…]. Ihr Workflow sieht das echte Token nie, der Ausführungsverlauf auch nicht. DeutschlandGPT setzt die echten Zugangsdaten nur dort ein, wo sie hingehören:
- im Header für die Zugangsdaten (bei den meisten Diensten
Authorization: Bearer {{auth.outputs.authToken}}) eines Knotens HTTP-Anfrage oder einesfetch()-Aufrufs im Code-Knoten, - bei einer Anfrage an die eigene API des Dienstes, etwa
graph.microsoft.comoder das<Name>.sharepoint.comIhrer Organisation bei SharePoint,www.googleapis.combei Google Drive.
Eine solche Anfrage läuft wie eine Authentifizierte Anfrage: mit denselben Grenzen (10 MB je Antwort, 30 Sekunden, keine Weiterleitung mit Zugangsdaten auf einen anderen Host) und denselben Berechtigungseinstellungen. Alles andere lässt den Knoten mit einer Meldung fehlschlagen, die sagt, was stattdessen zu tun ist: der Verweis in einer URL, einer Query, einem Request Body oder einem anderen Header, eine Anfrage an einen anderen Host und ein Code-Knoten, der ihn zurückgibt oder protokolliert. outputs.metadata ohne Geheimnisse (etwa die cloudId bei Jira) bleibt lesbar.
So stellen Sie einen Workflow um:
- Ein Knoten HTTP-Anfrage, der das Token genau so mitschickt, wie der Dienst es erwartet, wird von DeutschlandGPT auf einen Knoten Authentifizierte Anfrage mit derselben Verbindung umgestellt, auch bei Datei-Downloads. Anfragen, die ihre Adresse in einem anderen Knoten zusammensetzen, bleiben, wie sie sind; stellen Sie diese selbst um. Ein umgestellter Knoten behält seinen Namen, nachfolgende Knoten, die
response,statusCodeoderfilelesen, sind also nicht betroffen. - Ein Code-Knoten ruft
fetchAsauf, statt das Token zu verwenden. Behalten Sie den Knoten Get Auth Credentials: Über ihn weiß der Code-Knoten, welche Verbindung er nutzen soll.
// funktioniert weiter
const res = await fetch(url, { headers: { Authorization: 'Bearer ' + auth.outputs.authToken } });
// für Neues
const res = await fetchAs('jira', '/rest/api/3/myself');
Verfügbarkeit
Ihre Organisation kann einzelne Integrationen abschalten, und manche Dienste gibt es nicht auf jeder DeutschlandGPT-Instanz. Die Knotenauswahl zeigt nur, was Ihnen zur Verfügung steht. Ein Knoten, dessen Integration abgeschaltet wurde, ist als Nicht verfügbar markiert und wird nicht ausgeführt. Ersetzen oder löschen Sie ihn.
Verfügbare Integrationen
Die folgende Liste wird aus dem Integrationskatalog des Produkts erzeugt. Verlinkte Namen führen zu einer ausführlichen Seite. Für die übrigen Dienste zeigt die Knotenauswahl die verfügbaren Aktionen direkt an.
Microsoft 365
Tabellenkalkulation zur Datenorganisation, Analyse und Visualisierung.
Nachrichten senden, Chats verwalten und auf Team-Kanäle über Microsoft Teams zugreifen.
Aufgabenlisten und Aufgaben in Microsoft To Do verwalten — erstellen, zuweisen und abhaken.
Cloud-Speicher für Dateien und Ordner mit Suche, Download und Verwaltung.
Notizen, Notizbücher und Abschnitte in Microsoft OneNote erstellen, durchsuchen und verwalten, auch in Teamnotizbüchern auf SharePoint.
Termine verwalten, Meeting-Zeiten finden und gemeinsame Kalender überprüfen.
E-Mails über Microsoft Outlook senden, empfangen und verwalten.
Dateien, Sites, Listen und Dokumentbibliotheken in Microsoft SharePoint nutzen.
Google Workspace
E-Mails und Labels in Gmail senden, lesen, suchen und verwalten.
Google-Analytics-Daten abrufen und umfassende Reports zur Website-Nutzung erstellen.
Termine verwalten, Verfügbarkeiten prüfen und gemeinsame Kalender überprüfen.
Google-Docs-Dokumente erstellen, lesen, aktualisieren und durchsuchen.
Cloud-Speicher für Datei-Backups, Freigabe und Zusammenarbeit.
Orte suchen, Adressen geocodieren, Routen berechnen und Distanzmatrizen erstellen.
Google-Meet-Aufzeichnungen, Meeting-Details und Transkriptionen abrufen.
Daten in Google Sheets verwalten und analysieren.
Google-Slides-Präsentationen erstellen, lesen und bearbeiten.
To-do-Listen und Aufgaben geräteübergreifend verwalten. Aufgaben erstellen und abhaken.
Kommunikation
Nachrichten senden, Kanäle verwalten und Workflows mit deinem Discord-Bot ausführen.
Team-Messaging-Plattform, die Unterhaltungen, Dateien und Tools verbindet.
Nachrichten und Fotos senden sowie Workflows mit deinem Telegram-Bot ausführen.
Meetings planen, Aufzeichnungen abrufen und Teilnehmer in Zoom verwalten.
Wissen & Dokumentation
Self-hosted Wissensdatenbank: Seiten, Bücher und Kapitel in BookStack durchsuchen und verwalten.
Confluence-Seiten und -Spaces durchsuchen, lesen und verwalten.
Notion-Seiten und -Datenbanken durchsuchen, lesen, erstellen und verwalten.
E-Akte und Dokumentenmanagement der öffentlichen Verwaltung: Dokumente in regisafe suchen, Akten durchblättern und Schriftstücke ablegen (über CMIS).
CRM & Geschäftsanwendungen
Aufgaben, Projekte und Workspaces in Asana erstellen, verwalten und verfolgen.
Stellen, Kandidaten und Bewerbungen aus dem Recruiting- und Bewerbermanagementsystem (ATS) Ashby abrufen.
Terminplanung, Events und Buchungen mit Calendly verwalten.
Leads qualifizieren, Verkaufschancen abschließen und Datensätze in beliebigen Dataverse-Tabellen in Microsoft Dynamics 365 verwalten.
Debitoren, Kreditoren, Artikel, Verkaufs- und Einkaufsbelege sowie Posten in Microsoft Dynamics 365 Business Central lesen und verwalten, Rechnungen buchen.
Kontakte, Unternehmen, Deals und Aufgaben im HubSpot-CRM verwalten.
Events und deren Gäste aus einem Luma-Kalender (lu.ma) auflisten und lesen.
Boards, Gruppen, Spalten, Items, Subitems und Updates in monday.com erstellen und verwalten.
Immobilien-CRM onOffice enterprise — Objekte, Kontakte, Suchprofile und Aktivitäten lesen, durchsuchen und verwalten.
HR-Management mit Personio — Mitarbeitende, Abwesenheiten, Zeiterfassung und mehr.
Deals, Leads, Kontakte, Aktivitäten und Notizen im Pipedrive-CRM verwalten.
Immobilien-CRM Propstack — Kontakte (Kunden) und Objekte (Einheiten) verwalten.
Agentursoftware ProSonata: Projekte und Projektzeiten lesen, Zeiten erfassen und Rechnungen auswerten.
Support-Tickets und Kundenkonten aus Pylon, der B2B-Kundensupport-Plattform, lesen.
Accounts, Kontakte, Leads, Opportunities, Cases und mehr im Salesforce-CRM steuern.
Incidents auflisten und beliebige Tabellen (ITSM-Datensätze, Nutzer, Changes) einer ServiceNow-Instanz über die Table-API abfragen.
Zahlungsabwicklung mit Stripe — Kunden, Abonnements, Rechnungen und Umsätze.
Ordner, Projekte, Aufgaben, Kommentare, benutzerdefinierte Felder, Kontakte, Gruppen, Workflows und Spaces in Wrike verwalten.
Zendesk-Support-Tickets, -Nutzer und Help-Center-Artikel auflisten, durchsuchen, erstellen, aktualisieren und kommentieren.
Entwicklung
Repositories, Branches, Dateien und Pull Requests in Bitbucket Cloud verwalten und Workflows bei neuen Pull Requests auslösen.
Repositories, Pull Requests, Issues, Branches und Releases auf GitHub verwalten.
Jira-Vorgänge, -Projekte und -Workflows erstellen, aktualisieren und verwalten.
Linear-Issues, -Teams und -Labels durchsuchen, lesen, erstellen, aktualisieren und kommentieren.
Datenbanken & Suche
Airtable-Bases lesen und schreiben: Bases und Tabellen auflisten, Schemas einsehen sowie Datensätze und Kommentare verwalten.
Passagen aus einem AWS-Kendra-Enterprise-Search-Index abfragen und abrufen, dessen Datenquellen auflisten und Indexdetails einsehen.
Dokumente durchsuchen und Indizes in einem Azure-AI-Search-Dienst (Azure Cognitive Search) einsehen.
GoogleSQL-Abfragen ausführen und Datasets, Tabellen und Schemas in Google BigQuery erkunden.
Strukturierte Daten in integrierten Tabellen speichern, abfragen und in Workflows nutzen.
Unity Catalog (Kataloge, Schemas, Tabellen) erkunden und SQL auf Databricks-SQL-Warehouses ausführen.
Direkter Zugriff auf Microsoft-SQL-Server-Datenbanken: Abfragen ausführen und Daten verwalten.
Collections auflisten, Schemas einsehen und Vektorähnlichkeitssuchen in einer Milvus- bzw. Zilliz-Cloud-Vektordatenbank ausführen.
Direkter Zugriff auf MySQL-Datenbanken: Abfragen ausführen und Daten verwalten.
Pinecone-Indizes auflisten und beschreiben sowie Vektorähnlichkeitssuchen gegen eine verwaltete Vektordatenbank ausführen.
Direkter Zugriff auf PostgreSQL-Datenbanken: Abfragen ausführen und Daten verwalten.
Collections auflisten und Vektorähnlichkeitssuchen gegen einen Qdrant-Cluster ausführen.
SQL ausführen sowie Datenbanken, Schemas und Tabellen in einem Snowflake-Data-Warehouse über die SQL-API v2 erkunden.
Nearest-Neighbor-Ähnlichkeitssuche gegen einen bereitgestellten Vector-Search-Index von Google Cloud Vertex AI ausführen.
Weitere
Hochwertige maschinelle Übersetzungen in zahlreiche Sprachen mit DeepL.
Natürlich klingende Sprachsynthese und Text-to-Speech mit ElevenLabs.
Looker-BI erkunden: Dashboards, Looks und LookML-Modelle auflisten, gespeicherte Looks ausführen und Ad-hoc-Abfragen gegen die Looker-Instanz stellen.
Datenbanken und gespeicherte Fragen auflisten sowie gespeicherte Fragen (Cards) in einer Metabase-Instanz ausführen.
Miro-Boards, -Items, -Frames und -Tags aus deinen Workspaces lesen.
OpenAI Responses API — Antworten mit File Search und Code Interpreter.
Zugriff auf das deutsche Handelsregister — Unternehmenssuche, Anteilseigner und Auszüge.
Tableau-Arbeitsmappen, -Ansichten und -Datenquellen durchsuchen und Ansichtsdaten als CSV aus Tableau Cloud oder Tableau Server exportieren.
Dateien und Ordner auf beliebigen WebDAV-Servern (z.B. Nextcloud) lesen und verwalten.