Kanäle

Kanäle verbinden das residente Anyy-Gateway mit Nachrichtenplattformen. Im Dashboard können Sie vor allem Konten hinzufügen, deren Zustand prüfen, Einstellungen aktualisieren, sich erneut authentifizieren und Verbindungen entfernen.

Die unterstützten Plattformen und einen Verhaltensvergleich finden Sie unter Nachrichtenplattformen.

Sitzungsverhalten und Plattformverbindungen

Authentifizierung von Plattformkonten, eingehende Nachrichten und ausgehende Zustellung sind Anyy-Integrationen. Sobald sie in eine Sitzung aufgenommen wurden, verwenden Agentennachrichten, Steuerungs-/Folgenachrichten- Warteschlangen, Abbruch und Ereignisse denselben Pi-konformen Lebenszyklus wie andere Anyy- Oberflächen. Ein Plattformadapter ergänzt weder eine weitere Agentenschleife noch eigene Warteschlangenregeln.

Das festgelegte Hauptrepository von Pi v1.2.0 hat keine entsprechende einheitliche native Feishu-/Weixin-/Slack-Adapter-API; seine README verweist für Chat-Abläufe auf das separate Projekt pi-chat. Dieses Projekt und Drittanbieter-Plugins sind keine Referenz für diese Portierung. Lokale Kontoeinstellungen und kontrollierte Protokollprüfungen belegen keine Verbindung zu einem echten externen Konto; prüfen Sie dessen beobachteten Zustand.

Die Kanalseite öffnen

Öffnen Sie Dashboard → Kanal. Wechseln Sie mit den Filtern zwischen:

• Konfiguriert — in diesem Profil gespeicherte Konten, einschließlich getrennter Konten; und
• Verfügbar — Plattformadapter, die Anyy konfigurieren kann.

Jedes konfigurierte Konto hat eine dauerhafte Konto-ID und eine Inkarnation zur Kennzeichnung seiner aktuellen Verbindung. Die derzeitigen Einrichtungsoberflächen fügen nur dann ein Konto hinzu, wenn für diese Plattform keines vorhanden ist; einen Ablauf für ein zweites Konto bieten sie nicht.

Ein Konto konfigurieren

1. Wählen Sie eine verfügbare Plattform.
2. Geben Sie eine Konto-ID ein.
3. Füllen Sie die plattformspezifischen Felder aus.
4. Füllen Sie die von der gewählten Dashboard-Aktion angebotenen Felder aus.
5. Speichern Sie die Konfiguration.

Speichern führt die ausgewählte Kontoaktion direkt aus und liefert ihren Operationsbeleg zurück. Kontoeinstellungen und geschützte Bindungen von Zugangsdaten werden gemeinsam festgeschrieben. Ein leeres Geheimnisfeld behält den bisherigen Wert nur bei, wenn das Feld dies erlaubt; entfernen Sie das Konto, um dessen durch Anyy verwaltete Zugangsdaten zu bereinigen.

Ein Beleg committed oder no_op beschreibt lokale Einstellungen, keine bestätigte Plattformverbindung. Ein neuer Start/Wiederholungsversuch oder eine unveränderte Sollzustandsaktion fordert die Laufzeit dennoch zur Verbindungsabstimmung auf. Eine Wiederholung derselben Aufruferanfrage liefert den ursprünglichen Beleg zurück. Prüfen Sie den beobachteten Kontozustand für das tatsächliche Ergebnis.

Weixin verwendet einen QR-Ablauf: Scannen Sie mit dem vorgesehenen Konto, bestätigen Sie auf dem Telefon und warten Sie auf das Authentifizierungsergebnis. Die QR-Interaktion dauert fünf Minuten. Eine vor Ablauf angenommene Bestätigung kann die lokale Prüfung danach abschließen; beim fertigen Konto muss der beobachtete Transportzustand dennoch geprüft werden. Brechen Sie den aktuellen Versuch über die Seite ab oder ersetzen Sie ihn dort.

Geht bei einem Gateway-Neustart der aktive QR-Abfragehandle verloren, wird der Versuch als unbekannt oder abgelaufen geschlossen. Anyy ruft nicht stillschweigend einen weiteren QR-Code ab; starten Sie bei entsprechender Aufforderung einen neuen Versuch.

Geht die Antwort auf die Anmeldeanfrage verloren, verwenden Sie Erneut versuchen oder laden Sie die Anmeldeseite neu. Dashboard behält dieselbe Anfrage bei, sodass eine Wiederholung keinen weiteren Authentifizierungsversuch startet. Nur ein ausdrückliches Aktualisieren fordert einen neuen QR-Code an. Die Wiederherstellung einer Anfrage gilt zehn Minuten je Interaktion; kehren Sie danach zu den Kontoeinstellungen zurück. Dies verlängert nicht die fünfminütige Lebensdauer des QR-Codes.

Erneute Authentifizierung muss zum Konto passen

Scannen Sie bei der erneuten Authentifizierung eines Weixin-Kontos mit derselben Identität. Um es durch eine andere Identität zu ersetzen, entfernen Sie zuerst das alte Konto und konfigurieren Sie ein neues.

Die Dashboard-/TUI-Zugangsdatenformulare der meisten Plattformen bieten keine DM-/Gruppenrichtlinienfelder. Ändern Sie diese über den interaktiven Assistenten anyy setup channel. Weixin hat ein eigenes Zugriffsformular für gebundene Konten. Die Feishu-Einrichtung verwendet die standardmäßige dauerhafte Verbindung; die üblichen Einrichtungsoberflächen bieten keine Auswahl zum Wechsel des Verbindungsprofils. Für vorhandene Webhook-Konten siehe die Plattformanleitung.

Den Kontozustand lesen

Öffnen Sie ein konfiguriertes Konto, um Folgendes zu prüfen:

• gewünschten und aktuellen Laufzeitzustand;
• Status gesund, beeinträchtigt, fehlerhaft oder unbekannt;
• letzte ein- und ausgehende Aktivität;
• ausgewiesene Unterstützung für Zustellbestätigungen und beobachtete Wiederholungs-/Backoff-Nachweise;
• Authentifizierungs- oder Berechtigungsfehler;
• redigierte Konfigurationswerte.

Ein beeinträchtigtes Konto kann teilweise noch funktionieren. Folgen Sie vor wiederholtem Neuladen der auf der Seite angezeigten Abhilfe.

Die Unterstützung für Zustellbestätigungen ist eine ausgewiesene Fähigkeit des Adapters und kein Nachweis, dass eine bestimmte Nachricht die Plattform erreicht hat. Aktuelle Nachweise, Diagnosen und der Zeitpunkt des nächsten Versuchs beschreiben die beobachtete Verbindung.

Anyy hält eine abschließende Antwort ausstehend, wenn es sie vor dem Senden sicher erneut versuchen kann. Wurde ein Teil angenommen oder ist das Remote-Ergebnis ungewiss, wiederholt es die Nachricht nicht automatisch. Prüfen Sie das Plattformgespräch, bevor Sie eine weitere Kopie anfordern. Fortschrittsmeldungen eines beendeten Gesprächsschritts folgen seiner abschließenden Antwort nicht nach.

Zugriffsrichtlinien

Verfügbare Einstellungen hängen von der Plattform ab. Häufige Richtlinien sind:

• Direktnachrichten deaktiviert, gekoppelt, auf einer Zulassungsliste oder offen;
• Gruppennachrichten auf Erwähnungen oder eine vorhandene Raum-Zulassungsliste beschränkt; und
• CLI-Kopplungsbestätigung für einen neuen Absender auf unterstützten Plattformen.

Richtlinien-/Listenfelder sind oberflächenspezifisch. Aktuelle öffentliche Eingaben für Absenderlisten gibt es für Weixin und IRC; andere Adapter können eine vorhandene Liste verwenden, bieten in ihren aktuellen Einrichtungsaktionen aber keine Bearbeitung der Einträge. Gehen Sie nicht davon aus, dass die Auswahl von allowlist eine Liste erstellt. Verwenden Sie die engste Richtlinie, die der tatsächliche Einrichtungsablauf konfigurieren kann. Eine Kontoverbindung autorisiert nicht jeden Absender.

Öffnen Sie bei einem bereits gebundenen Weixin-Konto die Einstellungen, um DM-Richtlinie und Absenderliste allow_from zu ändern. Das Speichern der Zugriffseinstellungen bewahrt die aktuelle Anmeldung; erneutes QR-Scannen ist unnötig. Eine leere Liste entfernt alle Zulassungslisteneinträge.

Kanäle neu laden

Wählen Sie Neu laden, wenn die aktuell gespeicherten Konten mit der Laufzeit abgestimmt werden müssen. Das Speichern eines Kontos fordert dies normalerweise bereits an; Neu laden spielt weder historische Nachrichten erneut ab noch startet es einen deaktivierten Webhook-Listener.

Über die CLI:

anyy channel reload
anyy channel doctor telegram

doctor beobachtet die konfigurierte Kanalverbindung und meldet Diagnosen, ohne die Kontokonfiguration zu ändern. Änderungen am Webhook-Listener erfordern einen Gateway-Neustart; siehe Nachrichtenplattformen.

Kopplung über die CLI

Die aktuelle Dashboard-Kanalseite hat keine Bestätigungsliste für Kopplungsanfragen. Verwenden Sie für Plattformen mit Kopplung die CLI:

anyy channel pairing list
anyy channel pairing approve --request REQUEST_ID
anyy channel pairing reject --request REQUEST_ID
anyy channel pairing revoke --grant GRANT_ID

Prüfen Sie vor dem Bestätigen Plattform, Konto, maskierte Absenderidentität und angeforderten Zugriff.

Findet die begrenzte Liste eine bekannte Anfrage- oder Berechtigungs-ID nicht, geben Sie deren Kontobereich ausdrücklich an:

anyy channel pairing approve --request REQUEST_ID --channel telegram --account personal
anyy channel pairing revoke --grant GRANT_ID --channel telegram --account personal

Dies wählt für dieselbe ID-basierte Aktion das aktuelle Konto; Eigentumsprüfungen werden dadurch nicht umgangen.

Ein Konto entfernen

Die Kontodetailseite bietet eine Löschaktion. Das Entfernen löscht Kanalkonfiguration und durch Anyy verwaltete Zugangsdaten für dieses Konto. Nachrichten auf der externen Plattform werden nicht gelöscht.

Das Entfernen schreibt den lokalen Stopp-/Entfernungszustand gemeinsam mit der Zugangsdatenbereinigung fest und stimmt anschließend den tatsächlichen Transport ab. Aktualisieren Sie Liste und Verbindungszustand, bevor Sie die Identität erneut konfigurieren. Ein lokaler Entfernungsbeleg beweist keine Abmeldung von der Plattform.

CLI-Einrichtung

Starten Sie den interaktiven Assistenten:

anyy setup channel

Das Hinzufügen eines Plattformnamens wählt die nicht interaktive Konfiguration, keinen plattformspezifischen Assistenten. Beispielsweise kann bei einem vorhandenen Telegram-Konto die Richtlinie geändert werden, während erlaubte Zugangsdaten erhalten bleiben:

anyy setup channel telegram --set dm_policy=pairing --set group_policy=mention

Die Konfiguration eines neuen Kontos benötigt zusätzlich die ausgewiesenen Zugangsdatenfelder.

Verwenden Sie anyy setup channel --help für nicht interaktive --set- und vertrauliche Eingabeoptionen.

Sicherheitstipps

• Halten Sie Bot-Token und Signiergeheimnisse aus Shell-Verlauf und Screenshots heraus.
• Beginnen Sie mit Kopplung oder einer Zulassungsliste, bevor Sie eine offene DM-Richtlinie verwenden.
• Prüfen Sie Webhook-Endpunkte und Plattformberechtigungen beim Anbieter.
• Entfernen Sie Zugangsdaten, wenn Sie ein Konto außer Betrieb nehmen.
• Behandeln Sie externe Nachrichteninhalte und Anhänge als nicht vertrauenswürdige Eingaben.

Fehlerbehebung

Problem	Lösung
Das Konto bleibt nicht verfügbar	Öffnen Sie die Detailseite und folgen Sie der gemeldeten Abhilfe
Die Anmeldung ist abgelaufen	Authentifizieren Sie dieselbe Kontoidentität erneut
Nachrichten kommen an, aber Antworten schlagen fehl	Prüfen Sie Sendeberechtigung, Zustellstatus und Ratenlimits der Plattform
Ein neuer Absender kann Anyy nicht verwenden	Prüfen Sie DM-Richtlinie und ausstehende Kopplungsanfragen
Die Konfiguration hat sich geändert, die Laufzeit nicht	Wählen Sie Neu laden oder führen Sie anyy channel reload aus

Unter Cron erfahren Sie, wie geplante Ergebnisse über einen verbundenen Kanal zugestellt werden.