Add-on Einrichtung

Schritt-fuer-Schritt-Anleitung fuer jedes verfuegbare Add-on deines Assistenten: woher du den Zugang bekommst und was du eintragen musst.

28 Add-ons, fuer Desktop
Kalender & OfficeKommunikationProduktivitaetEntwicklungCRMFinanzenMarketingSupportE-CommerceAnalyticsDaten

Zugangsdaten der zentralen Apps (OAuth)

Für Microsoft und Dropbox legst du einmalig eine App beim Anbieter an und bekommst zwei Schlüssel. Diese trägst du danach direkt in der App ein: Add-ons → (Dienst) → Zugangsdaten → Zugangsdaten speichern. Kein Bearbeiten von Dateien nötig.

Microsoft 365 (Outlook, Kalender, OneDrive, Teams)

  1. entra.microsoft.com öffnen, anmelden (Geschäftskonto des Postfachs).
  2. Identität → Anwendungen → App-Registrierungen → Neue Registrierung; Name z. B. „Hermes Assistent".
  3. Unterstützte Kontotypen: „Nur Konten in diesem Organisationsverzeichnis" (Single-Tenant) genügt.
  4. Umleitungs-URI (Typ Web) exakt: https://chat.modutech-solutions.at/api/addons/microsoft_365/callback
  5. Registrieren → Anwendungs-(Client-)ID kopieren.
  6. Zertifikate & Geheimnisse → Neuer geheimer Clientschlüssel → den Wert sofort kopieren (= Client-Secret, nur einmal sichtbar).
  7. API-Berechtigungen → Microsoft Graph → Delegiert: User.Read, Mail.ReadWrite, Mail.Send, Calendars.ReadWrite, Files.ReadWrite.All sowie (für Teams) Team.ReadBasic.All, Channel.ReadBasic.All, ChannelMessage.Send. Danach „Administratorzustimmung erteilen".
  8. In der App: Add-ons → Microsoft 365 → Zugangsdaten: Client-ID + Client-Secret eintragen, speichern, dann „Mit Microsoft anmelden".

Teams nur mit Firmen-/Work-Konten. Client-Secret läuft ab — vor Ablauf neu erstellen und in der App neu speichern.

Dropbox

  1. dropbox.com/developers/apps → Create app.
  2. Choose an API: „Scoped access". Access type: „Full Dropbox" (oder „App folder" für nur einen Ordner). Name vergeben → Create app.
  3. Tab Permissions (ZUERST!): account_info.read, files.metadata.read, files.content.read, files.content.write ankreuzen → Submit.
  4. Tab Settings → OAuth 2 → Redirect URIs exakt eintragen und Add: https://chat.modutech-solutions.at/api/addons/dropbox/callback
  5. Auf Settings stehen oben App key und App secret (Secret nach „Show").
  6. In der App: Add-ons → Dropbox → Zugangsdaten: App key + App secret eintragen, speichern, dann „Mit Dropbox anmelden".

Reihenfolge bei Dropbox wichtig: erst Permissions setzen, dann anmelden — sonst sieht der Assistent keine Dateien. Bei nachträglicher Scope-Änderung in der App einmal „Trennen" und neu anmelden.

So funktioniert es: Jedes Add-on wird in der App im Tab Add-ons verbunden. Hier findest du fuer jedes, wo du den noetigen Schluessel/Token bekommst und welche Schritte dafuer noetig sind. Trage die Werte anschliessend im jeweiligen Add-on ein und klicke Verbinden, die Verbindung wird sofort geprueft. Danach kann der Assistent die genannten Funktionen direkt im Chat nutzen.

Kalender & Office

Google Kalender

Kalender & Office

Termine lesen, erstellen und loeschen.

Benoetigt
  • Dienstkonto-JSON-Schluessel (Google Cloud) ODER zentraler Google-Login
  • Kalender-ID (meist die Gmail-Adresse)
Einrichtung Schritt fuer Schritt
  1. Variante A, Dienstkonto (empfohlen): In der Google Cloud Console (console.cloud.google.com) ein Projekt anlegen.
  2. APIs & Dienste, Bibliothek, Google Calendar API aktivieren.
  3. APIs & Dienste, Anmeldedaten, Dienstkonto erstellen. Danach beim Dienstkonto unter Schluessel, Schluessel hinzufuegen, JSON herunterladen.
  4. In Google Kalender den Kalender fuer die E-Mail-Adresse des Dienstkontos freigeben (Berechtigung Aenderungen an Terminen vornehmen).
  5. Im Add-on Methode Dienstkonto (JSON) waehlen, JSON einfuegen, Kalender-ID eintragen, verbinden.
  6. Variante B, Mit Google anmelden: nur verfuegbar, wenn der Betreiber einen zentralen Google-OAuth-Client hinterlegt hat.
Funktionen fuer den Assistenten
Termine ansehenTermine erstellenTermine loeschen

Gmail

Kalender & Office

E-Mails lesen, durchsuchen und senden (per Google-Login).

Benoetigt
  • Zentraler Google-Login (OAuth-Client) eingerichtet
  • Gmail im Google-Zustimmungsbildschirm freigegeben
Einrichtung Schritt fuer Schritt
  1. Voraussetzung: derselbe zentrale Google-OAuth-Client wie beim Kalender muss hinterlegt sein (config.json: google_oauth_client_id / google_oauth_client_secret).
  2. Im Google-Zustimmungsbildschirm die Gmail-Bereiche (gmail.modify und gmail.send) hinzufuegen.
  3. Im OAuth-Client als Weiterleitungs-URI zusaetzlich https://chat.modutech-solutions.at/api/addons/gmail/callback eintragen.
  4. Im Add-on auf Mit Google anmelden klicken und den Google-Login durchlaufen.
  5. Alternative ohne zentralen Login: das Add-on E-Mail (IMAP) mit imap.gmail.com und einem App-Passwort verwenden.
  6. Hinweis: Gmail ist bei Google ein eingeschraenkter Bereich. Im Testmodus laeuft die Anmeldung nach ~7 Tagen ab; fuer Dauerbetrieb App verifizieren lassen oder bei Google Workspace den Zustimmungsbildschirm auf Intern stellen.
Funktionen fuer den Assistenten
Posteingang lesenE-Mails durchsuchenE-Mail oeffnenE-Mail senden

Microsoft 365 (Outlook, Kalender, OneDrive, Teams)

Kalender & Office

Ein Microsoft-Login fuer Mail, Kalender, OneDrive und Teams.

Benoetigt
  • Zentrale Microsoft-Entra-App (Multi-Tenant) eingerichtet
  • Microsoft-Konto (Firma oder privat)
Einrichtung Schritt fuer Schritt
  1. Im Azure-/Entra-Portal (entra.microsoft.com) unter App-Registrierungen eine neue App anlegen.
  2. Bei Unterstuetzte Kontotypen 'Konten in jedem Organisationsverzeichnis UND persoenliche Microsoft-Konten' waehlen (Multi-Tenant).
  3. Als Weiterleitungs-URI (Typ Web) eintragen: https://chat.modutech-solutions.at/api/addons/microsoft_365/callback
  4. Unter Zertifikate & Geheimnisse ein Client-Secret erstellen.
  5. Unter API-Berechtigungen (Microsoft Graph, delegiert): User.Read, Mail.ReadWrite, Mail.Send, Calendars.ReadWrite, Files.ReadWrite.All und fuer Teams Team.ReadBasic.All, Channel.ReadBasic.All, ChannelMessage.Send.
  6. Client-ID und Secret in der config.json hinterlegen: microsoft_oauth_client_id / microsoft_oauth_client_secret.
  7. Im Add-on auf Mit Microsoft anmelden klicken. Beim ersten Login einer Firma muss ggf. deren IT-Admin einmal zustimmen.
  8. Hinweis: Teams funktioniert nur mit Firmen-/Work-Konten. Privat-Konten nutzen Mail, Kalender und OneDrive.
Funktionen fuer den Assistenten
Mail lesen/suchen/sendenKalender lesen/erstellenOneDrive suchen/auflistenTeams auflisten/posten

E-Mail (IMAP)

Kalender & Office

Posteingang lesen, durchsuchen und E-Mails senden.

Benoetigt
  • E-Mail-Adresse
  • Passwort oder App-Passwort
  • IMAP-Server (zum Senden zusaetzlich SMTP-Server)
Einrichtung Schritt fuer Schritt
  1. IMAP-Serverdaten des Anbieters bereitlegen (GMX: imap.gmx.net / Senden mail.gmx.net; Web.de: imap.web.de; iCloud: imap.mail.me.com).
  2. Bei Gmail oder iCloud (oder aktiver 2-Faktor-Anmeldung) ein App-Passwort erstellen, das normale Passwort funktioniert dort nicht.
  3. Im Add-on E-Mail-Adresse, Passwort/App-Passwort und IMAP-Server eintragen.
  4. Zum Versenden zusaetzlich SMTP-Server und -Port (587 oder 465) eintragen.
  5. Verbinden, die Anmeldung wird sofort geprueft.
Funktionen fuer den Assistenten
Posteingang lesenE-Mails durchsuchenE-Mail oeffnenE-Mail senden

Kommunikation

Slack

Kommunikation

Nachrichten in Kanaele posten, Kanaele auflisten und mitlesen.

Benoetigt
  • Bot-Token (xoxb-...)
Einrichtung Schritt fuer Schritt
  1. Oeffne api.slack.com/apps und klicke Create New App, dann From scratch.
  2. Waehle deinen Workspace und einen App-Namen.
  3. Links unter OAuth & Permissions, Scopes, Bot Token Scopes hinzufuegen: chat:write, channels:read, channels:history, groups:read.
  4. Oben auf Install to Workspace und bestaetigen.
  5. Kopiere das Bot User OAuth Token (beginnt mit xoxb-) und fuege es hier ein.
  6. Wichtig: Lade den Bot im gewuenschten Kanal ein (/invite @DeinBot), sonst kann er dort nicht posten.
Funktionen fuer den Assistenten
Post a message to a Slack channel.List the Slack channels the bot can see.Read recent messages from a Slack channel by id.

WhatsApp Business

Kommunikation

Nachrichten ueber die offizielle WhatsApp Cloud API senden.

Benoetigt
  • Zugriffstoken (permanent)
  • Phone Number ID
  • Standard-Empfaenger (optional)
Einrichtung Schritt fuer Schritt
  1. Oeffne developers.facebook.com, erstelle eine App (Typ Business) und fuege das Produkt WhatsApp hinzu.
  2. Unter WhatsApp, API Setup findest du die Phone Number ID und eine Test-Telefonnummer.
  3. Fuer Dauerbetrieb in den Meta-Business-Einstellungen (business.facebook.com) einen System-User anlegen und ein permanentes Token mit der Berechtigung whatsapp_business_messaging erzeugen.
  4. Token und Phone Number ID hier eintragen.
  5. Wichtig: freie Textnachrichten gehen nur innerhalb von 24 Stunden, nachdem dir der Kontakt geschrieben hat. Ausserhalb davon nur mit einer vorab genehmigten Vorlage (Template).
  6. Empfaenger immer im Format Landesvorwahl+Nummer ohne + oder 00, z. B. 4915112345678.
Funktionen fuer den Assistenten
Send a free-text WhatsApp message (only valid within the 24h customer-service window).Send a pre-approved WhatsApp template message (works outside the 24h window). language e.g. de or en_US.

Discord

Kommunikation

Nachrichten in einen Discord-Kanal posten (per Webhook).

Benoetigt
  • Webhook-URL
Einrichtung Schritt fuer Schritt
  1. Oeffne in Discord die Kanal-Einstellungen (Zahnrad neben dem Kanal).
  2. Integrationen, Webhooks, Neuer Webhook.
  3. Webhook-URL kopieren und hier einfuegen.
Funktionen fuer den Assistenten
Post a message to the connected Discord channel.

Produktivitaet

Notion

Produktivitaet

Seiten und Datenbanken durchsuchen und Inhalte lesen.

Benoetigt
  • Integrations-Token (secret_.../ntn_...)
Einrichtung Schritt fuer Schritt
  1. Oeffne notion.so/my-integrations und klicke New integration.
  2. Vergib einen Namen, waehle den Workspace, Typ Internal. Speichern.
  3. Kopiere das Internal Integration Secret und fuege es hier ein.
  4. Wichtig: Oeffne in Notion jede Seite/Datenbank fuer den Assistenten, oben rechts auf das Menue, Connections, deine Integration hinzufuegen.
  5. Ohne diese Freigabe sieht die Integration die Seite nicht.
Funktionen fuer den Assistenten
Search Notion pages and databases.Read the text content of a Notion page by id.

Todoist

Produktivitaet

Aufgaben ansehen, anlegen und abhaken.

Benoetigt
  • API-Token
Einrichtung Schritt fuer Schritt
  1. Oeffne Todoist (App oder todoist.com), Einstellungen.
  2. Gehe zu Integrationen, Reiter Entwickler.
  3. Kopiere den API-Token und fuege ihn hier ein.
Funktionen fuer den Assistenten
List active Todoist tasks. Optional Todoist filter string.Create a Todoist task. due_string accepts natural language.Complete/close a Todoist task by id.

Trello

Produktivitaet

Boards und Karten ansehen, Karten anlegen.

Benoetigt
  • API-Key
  • Token
Einrichtung Schritt fuer Schritt
  1. Oeffne trello.com/power-ups/admin und lege eine Integration an (oder nutze trello.com/app-key).
  2. Kopiere den API Key.
  3. Klicke auf den Token-Link daneben, erlaube den Zugriff und kopiere den erzeugten Token.
  4. Beide Werte hier einfuegen.
Funktionen fuer den Assistenten
List your Trello boards.List cards on a Trello board by board id.Create a Trello card in a list (list_id).

Asana

Produktivitaet

Projekte und Aufgaben ansehen, Aufgaben anlegen.

Benoetigt
  • Personal Access Token
Einrichtung Schritt fuer Schritt
  1. Oeffne app.asana.com/0/my-apps (Profilbild, Settings, Apps, Manage Developer Apps).
  2. Erzeuge ein Personal Access Token.
  3. Token kopieren und hier einfuegen.
Funktionen fuer den Assistenten
List Asana projects.List tasks of an Asana project by id.Create a task in an Asana project.

Calendly

Produktivitaet

Gebuchte Termine und Terminarten ansehen.

Benoetigt
  • Personal Access Token
Einrichtung Schritt fuer Schritt
  1. Oeffne Calendly, Integrations, API & Webhooks.
  2. Unter Personal Access Tokens einen neuen Token erstellen.
  3. Token kopieren und hier einfuegen.
Funktionen fuer den Assistenten
List upcoming/scheduled Calendly events.List your Calendly event types (booking links).

monday.com

Produktivitaet

Boards ansehen und Elemente anlegen.

Benoetigt
  • API-Token
Einrichtung Schritt fuer Schritt
  1. Oeffne monday.com, klicke auf dein Profilbild, Developers (oder Administration, API).
  2. Kopiere dein personal API token (v2).
  3. Token hier einfuegen.
Funktionen fuer den Assistenten
List monday.com boards.Create an item on a monday.com board (board_id).

Entwicklung

GitHub

Entwicklung

Issues ansehen und anlegen, Repos durchsuchen.

Benoetigt
  • Personal Access Token
Einrichtung Schritt fuer Schritt
  1. Oeffne github.com/settings/tokens.
  2. Generate new token (fine-grained empfohlen).
  3. Waehle die Repositories und Berechtigungen (mindestens Issues: Read and write, Contents: Read).
  4. Token erzeugen und hier einfuegen (er wird nur einmal angezeigt).
Funktionen fuer den Assistenten
List issues of a repo (owner/name). state: open|closed|all.Create an issue in a repo (owner/name).Search GitHub issues/PRs with a query.

Linear

Entwicklung

Issues ansehen und anlegen.

Benoetigt
  • API-Key (lin_api_...)
Einrichtung Schritt fuer Schritt
  1. Oeffne Linear, Settings (oben links auf den Workspace), Security & access bzw. API.
  2. Unter Personal API keys einen neuen Schluessel erstellen.
  3. Schluessel (beginnt mit lin_api_) kopieren und hier einfuegen.
Funktionen fuer den Assistenten
List recent Linear issues.List Linear teams (for team_id).Create a Linear issue in a team (team_id from linear_list_teams).

GitLab

Entwicklung

Issues ansehen und anlegen.

Benoetigt
  • Personal Access Token
  • GitLab-URL (optional)
Einrichtung Schritt fuer Schritt
  1. Oeffne GitLab, oben rechts Profil, Edit profile, Access Tokens.
  2. Neuen Token mit Scope api erstellen, kopieren.
  3. Token hier einfuegen. Bei self-hosted GitLab zusaetzlich die Basis-URL eintragen.
Funktionen fuer den Assistenten
List open issues of a GitLab project (group/project).Create an issue in a GitLab project (group/project).

CRM

HubSpot

CRM

Kontakte und Deals ansehen, Kontakte anlegen.

Benoetigt
  • Private-App-Token (pat-...)
Einrichtung Schritt fuer Schritt
  1. Oeffne HubSpot, Einstellungen (Zahnrad), Integrationen, Private Apps.
  2. Create a private app, Name vergeben.
  3. Unter Scopes mindestens crm.objects.contacts (read/write) und crm.objects.deals (read) aktivieren.
  4. App erstellen, Access token anzeigen und kopieren, hier einfuegen.
Funktionen fuer den Assistenten
List recent HubSpot contacts.Create a HubSpot contact.List recent HubSpot deals.

Pipedrive

CRM

Deals ansehen und anlegen, Personen suchen.

Benoetigt
  • API-Token
Einrichtung Schritt fuer Schritt
  1. Oeffne Pipedrive, Profilbild oben rechts, Persoenliche Einstellungen.
  2. Waehle API im Menue.
  3. Kopiere dein API token und fuege es hier ein.
Funktionen fuer den Assistenten
List Pipedrive deals. status: open|won|lost|all_not_deleted.Create a Pipedrive deal.Search Pipedrive persons by term.

Finanzen

Stripe

Finanzen

Kontostand, letzte Zahlungen und Kunden abrufen.

Benoetigt
  • Restricted Key (rk_live_... oder rk_test_...)
Einrichtung Schritt fuer Schritt
  1. Oeffne dashboard.stripe.com, Entwickler (Developers), API-Schluessel.
  2. Scrolle zu Eingeschraenkte Schluessel (Restricted keys), klicke Eingeschraenkten Schluessel erstellen.
  3. Namen vergeben (z. B. Hermes) und Lese-Rechte setzen: Balance Read, Charges/Payments Read, Customers Read, sonst alles auf None.
  4. Schluessel erstellen, dann den Token anzeigen (beginnt mit rk_) und hier einfuegen.
  5. Wichtig: NICHT den geheimen Hauptschluessel (sk_) des Shops kopieren, der wird beim Anzeigen/Rollen ersetzt und der Shop verliert dann seinen Schluessel.
  6. Tipp: rk_test_ fuer den Testmodus, rk_live_ fuer echte Daten.
Funktionen fuer den Assistenten
Get the current Stripe account balance.List recent Stripe charges.List Stripe customers (optional email filter).

lexoffice

Finanzen

Kontakte ansehen und anlegen (DACH-Buchhaltung).

Benoetigt
  • API-Key
Einrichtung Schritt fuer Schritt
  1. Oeffne lexoffice, Einstellungen (Zahnrad).
  2. Suche Oeffentliche API (app.lexoffice.de/addons/public-api).
  3. Erzeuge einen API-Schluessel und fuege ihn hier ein.
Funktionen fuer den Assistenten
List lexoffice contacts.Create a lexoffice contact (company).

sevDesk

Finanzen

Kontakte und Rechnungen ansehen (DACH-Buchhaltung).

Benoetigt
  • API-Token
Einrichtung Schritt fuer Schritt
  1. Oeffne sevDesk, Einstellungen, Benutzer.
  2. Waehle deinen Benutzer; unten findest du den API-Token.
  3. Token kopieren und hier einfuegen.
Funktionen fuer den Assistenten
List sevDesk contacts.List sevDesk invoices.

Marketing

Brevo

Marketing

Transaktions-E-Mails senden und Kontakte ansehen.

Benoetigt
  • API-Key (xkeysib-...)
  • Absender-Adresse (optional)
Einrichtung Schritt fuer Schritt
  1. Oeffne Brevo (brevo.com), oben rechts auf deinen Namen, SMTP & API.
  2. Reiter API Keys, Generate a new API key. Kopieren, hier einfuegen.
  3. Unter Senders, Domains & Dedicated IPs eine Absenderadresse verifizieren.
  4. Diese Adresse als Absender-Adresse hier eintragen.
Funktionen fuer den Assistenten
Send a transactional email via Brevo.List Brevo contacts.

Support

Zendesk

Support

Support-Tickets ansehen und anlegen.

Benoetigt
  • Subdomain
  • Agenten-E-Mail
  • API-Token
Einrichtung Schritt fuer Schritt
  1. Oeffne das Zendesk Admin Center, Apps and integrations, APIs, Zendesk API.
  2. Token-Zugriff aktivieren und ein neues API-Token hinzufuegen, kopieren.
  3. Subdomain (Teil vor .zendesk.com), deine Agenten-E-Mail und das Token hier eintragen.
Funktionen fuer den Assistenten
List recent Zendesk tickets.Create a Zendesk ticket.

Intercom

Support

Konversationen ansehen und Kontakte suchen.

Benoetigt
  • Access Token
Einrichtung Schritt fuer Schritt
  1. Oeffne app.intercom.com/a/developer-signup bzw. den Developer Hub.
  2. Erstelle eine App (oder nutze eine bestehende), oeffne Authentication.
  3. Kopiere den Access Token und fuege ihn hier ein.
Funktionen fuer den Assistenten
List recent Intercom conversations.Find an Intercom contact by email.

Freshdesk

Support

Helpdesk-Tickets ansehen und anlegen.

Benoetigt
  • Domain
  • API-Key
Einrichtung Schritt fuer Schritt
  1. Oeffne Freshdesk, klicke oben rechts auf dein Profil, Profile settings.
  2. Rechts findest du Your API Key, kopieren.
  3. Domain (firma.freshdesk.com) und API-Key hier eintragen.
Funktionen fuer den Assistenten
List recent Freshdesk tickets.Create a Freshdesk ticket.

E-Commerce

Shopify

E-Commerce

Bestellungen und Produkte ansehen.

Benoetigt
  • Shop-Domain
  • Admin API Access Token (shpat_...)
Einrichtung Schritt fuer Schritt
  1. Oeffne Shopify-Admin, Settings, Apps and sales channels, Develop apps.
  2. Allow custom app development, dann Create an app.
  3. Unter Configuration die Admin API Scopes read_orders und read_products aktivieren.
  4. App installieren, unter API credentials den Admin API access token (shpat_) anzeigen und kopieren.
  5. Shop-Domain und Token hier eintragen.
Funktionen fuer den Assistenten
List recent Shopify orders.List Shopify products.

Analytics

Matomo

Analytics

Website-Statistiken (Besuche) abrufen.

Benoetigt
  • Matomo-URL
  • Auth-Token (token_auth)
  • Site-ID (optional)
Einrichtung Schritt fuer Schritt
  1. Oeffne Matomo, Zahnrad (Administration), Persoenlich, Sicherheit.
  2. Unter Auth-Tokens ein neues Token erstellen, kopieren.
  3. Matomo-URL, Token und ggf. die Site-ID hier eintragen.
Funktionen fuer den Assistenten
Get Matomo visits summary. period: day|week|month|year, date: e.g. today.

Daten

OpenWeather

Daten

Aktuelles Wetter fuer einen Ort abrufen.

Benoetigt
  • API-Key
Einrichtung Schritt fuer Schritt
  1. Registriere dich auf openweathermap.org.
  2. Oeffne dein Konto, Reiter API keys.
  3. Kopiere den Default-Key (oder erstelle einen) und fuege ihn hier ein.
  4. Hinweis: ein neuer Key wird erst nach einigen Stunden aktiv.
Funktionen fuer den Assistenten
Get current weather for a location (city name).