Kanaele

Was sind Kanaele?

Kanaele sind die Kommunikationsplattformen, die Ihre Neotask Agenten zum Senden und Empfangen von Nachrichten nutzen. Durch das Verbinden eines Kanals geben Sie einem Agenten die Faehigkeit, auf dieser Plattform eingehende Nachrichten abzuhoeren und in Echtzeit zu antworten.

Wichtige Konzepte:

Pro-Agent-Konfiguration -- Jede Kanalverbindung wird auf Agentenebene konfiguriert. Ein Agent kann mit Slack verbunden sein, waehrend ein anderer Discord bedient, oder ein einzelner Agent kann gleichzeitig mit mehreren Kanaelen verbunden sein.
Bidirektional -- Kanaele unterstuetzen sowohl das Senden als auch das Empfangen von Nachrichten. Agenten koennen auf eingehende Nachrichten antworten, ausgehende Nachrichten initiieren oder beides.
Multi-Konto -- Sie koennen mehrere Konten fuer denselben Kanaltyp verbinden (z.B. zwei verschiedene Slack-Workspaces oder mehrere E-Mail-Adressen).

Unterstuetzte Kanaele

Kanal	Auth-Methode	Funktionen
Slack	OAuth	Vollstaendiges Messaging, Kanaele, Threads, Reaktionen, Datei-Uploads
Discord	Bot-Token	Server-Messaging, Kanaele, DMs, Embeds, Reaktionen
WhatsApp	QR-Code	Textnachrichten, Mediennachrichten, Gruppenchats
Telegram	Bot-Token	Textnachrichten, Gruppen, Kanaele, Inline-Tastaturen, Dateifreigabe
Signal	Lokale App	Ende-zu-Ende-verschluesseltes Messaging, Gruppenchats
Microsoft Teams	OAuth	Teams, Kanaele, Chats, Adaptive Cards, Dateifreigabe
Google Chat	OAuth	Spaces, Direktnachrichten, Cards, Thread-Konversationen
SMS	API Key	Ausgehende und eingehende Textnachrichten ueber unterstuetzte Anbieter
E-Mail / Gmail	OAuth	Senden, Empfangen, Entwerfen, Antworten, Anhaenge, Label-Verwaltung
Matrix	Token	Foederiertes Messaging, Raeume, Ende-zu-Ende-Verschluesselung
Line	Token	Textnachrichten, Sticker, Gruppenchats, Rich Menus
Zalo	Token	Textnachrichten, Medienfreigabe
IRC	Konfiguration	Serververbindungen, Kanaele, private Nachrichten
iMessage	Lokal	macOS-natives Messaging (erfordert macOS-Host)

Einen Kanal verbinden

Der Verbindungsprozess variiert je nach Authentifizierungsmethode des Kanals.

OAuth-Flow

Verwendet von: Slack, Microsoft Teams, Google Chat, E-Mail / Gmail

Oeffnen Sie den Kanaele-Tab des Agenten.
Klicken Sie auf Verbinden neben dem gewuenschten Kanal.
Sie werden zur Autorisierungsseite des Dienstes weitergeleitet.
Melden Sie sich mit Ihrem Konto an und erteilen Sie Neotask die angeforderten Berechtigungen.
Nach der Autorisierung werden Sie zurueck zum Dashboard geleitet und der Kanal erscheint als verbunden.

Fuer mobile Plattformen ist eine QR-Code-Option verfuegbar. Scannen Sie den QR-Code von Ihrem Telefon, um die Autorisierung abzuschliessen, ohne sich in Ihrem Desktop-Browser anmelden zu muessen.

Bot-Token

Verwendet von: Discord, Telegram

Erstellen Sie einen Bot auf der jeweiligen Plattform:
- Discord -- Erstellen Sie eine Anwendung im Discord Developer Portal und generieren Sie ein Bot-Token.
- Telegram -- Schreiben Sie @BotFather auf Telegram, um einen Bot zu erstellen und ein Token zu erhalten.
Oeffnen Sie den Kanaele-Tab des Agenten und klicken Sie auf Verbinden neben dem Kanal.
Fuegen Sie das Bot-Token in das Token-Feld ein.
Klicken Sie auf Speichern, um die Verbindung herzustellen.

QR-Code

Verwendet von: WhatsApp

Oeffnen Sie den Kanaele-Tab des Agenten und klicken Sie auf Verbinden neben WhatsApp.
Ein QR-Code wird auf dem Bildschirm angezeigt.
Oeffnen Sie WhatsApp auf Ihrem Telefon, gehen Sie zu Verknuepfte Geraete und scannen Sie den QR-Code.
Die Verbindung wird hergestellt, sobald Ihr Telefon die Verknuepfung bestaetigt.

API Key

Verwendet von: SMS

Erhalten Sie einen API Key von Ihrem SMS-Anbieter (z.B. Twilio, Vonage).
Oeffnen Sie den Kanaele-Tab des Agenten und klicken Sie auf Verbinden neben SMS.
Geben Sie Ihren API Key und alle zusaetzlich erforderlichen Felder ein (z.B. Telefonnummer, Account-SID).
Klicken Sie auf Speichern, um den Kanal zu aktivieren.

Token

Verwendet von: Matrix, Line, Zalo

Generieren Sie ein Zugangstoken in den Entwicklereinstellungen oder dem Admin-Panel der jeweiligen Plattform.
Oeffnen Sie den Kanaele-Tab des Agenten und klicken Sie auf Verbinden neben dem Kanal.
Fuegen Sie das Token in das Token-Feld ein.
Klicken Sie auf Speichern, um die Verbindung herzustellen.

Serverkonfiguration

Verwendet von: IRC

Oeffnen Sie den Kanaele-Tab des Agenten und klicken Sie auf Verbinden neben IRC.
Geben Sie die Serveradresse, den Port, den Nickname und (optional) ein Passwort ein.
Geben Sie die Kanaele an, die bei der Verbindung beigetreten werden sollen.
Klicken Sie auf Speichern, um die Verbindung herzustellen.

Lokale Anwendung

Verwendet von: Signal, iMessage

Stellen Sie sicher, dass die erforderliche Anwendung auf dem Host-Rechner installiert und ausgefuehrt wird:
- Signal -- Signal Desktop muss installiert und mit Ihrem Signal-Konto verknuepft sein.
- iMessage -- Erfordert einen macOS-Host mit konfigurierter Messages.app.
Oeffnen Sie den Kanaele-Tab des Agenten und klicken Sie auf Verbinden neben dem Kanal.
Neotask erkennt die lokale Anwendung und stellt eine Verbindung her.
Wenn die Anwendung nicht erkannt wird, werden Sie aufgefordert, sie zu installieren oder zu konfigurieren.

Verbindungstest

Nach dem Verbinden eines Kanals fuehrt Neotask automatisch einen Latenztest durch, um die Verbindung zu verifizieren:

Eine Testnachricht wird ueber die API des Kanals gesendet und empfangen.
Die Round-Trip-Latenz wird gemessen und angezeigt.
Wenn der Test fehlschlaegt, beschreibt eine Fehlermeldung das Problem (z.B. ungueltiges Token, abgelaufene OAuth-Berechtigung, nicht erreichbarer Server).

Sie koennen den Verbindungstest jederzeit ueber die Kanaleinstellungen erneut ausfuehren.

Kanaloperationen

Sobald ein Kanal verbunden ist, koennen Sie ihn ueber den Kanaele-Tab des Agenten verwalten.

Aktivieren / Deaktivieren

Schalten Sie einen Kanal ein oder aus, ohne ihn zu trennen. Wenn deaktiviert:

Der Agent hoert auf, auf diesem Kanal nach Nachrichten zu lauschen.
Keine ausgehenden Nachrichten werden darueber gesendet.
Die Verbindungsdaten werden beibehalten, sodass Sie jederzeit ohne Neukonfiguration wieder aktivieren koennen.

Konnektivitaet testen

Fuehren Sie einen On-Demand-Konnektivitaetstest durch, um zu ueberpruefen, ob der Kanal erreichbar und reaktionsfaehig ist. Der Test:

Sendet eine leichtgewichtige API-Anfrage an den Dienst des Kanals.
Misst die Round-Trip-Latenz in Millisekunden.
Meldet das Ergebnis als Verbunden (mit Latenz) oder Fehlgeschlagen (mit Fehlerdetails).

Latenz anzeigen

Jeder verbundene Kanal zeigt seinen letzten Latenzwert im Kanaele-Tab an. Dies hilft Ihnen, langsame oder beeintraechtigte Verbindungen auf einen Blick zu erkennen. Die Latenz wird aktualisiert:

Automatisch nach jedem Verbindungstest.
Periodisch im Hintergrund, waehrend der Kanal aktiv ist.

Trennen / Abmelden

Um eine Kanalverbindung vollstaendig zu entfernen:

Klicken Sie auf Trennen neben dem Kanal.
Bestaetigen Sie die Aktion im Dialog.
Neotask widerruft oder verwirft die gespeicherten Anmeldedaten (OAuth-Tokens werden auf der Anbieterseite widerrufen, wo unterstuetzt).
Der Kanal wird aus der Liste der aktiven Kanaele des Agenten entfernt.

Um nach dem Trennen wieder zu verbinden, folgen Sie erneut den urspruenglichen Verbindungsschritten.