Nachrichtenplattformen
Nachrichtenkanäle lassen Sie über bereits verwendete Dienste mit dem residenten Anyy-Gateway sprechen. Jedes konfigurierte Konto hat eigenes Verbindungsprofil, Zugangsdaten und Direkt-/Gruppenzugriffsrichtlinie.
Unterstützte Plattformen
Der aktuelle Kanalkatalog implementiert:
| Plattform | Verbindung |
|---|---|
| Telegram | Bot-API-Long-Polling |
| Discord | Bot-Gateway |
| Slack | Socket Mode |
| Business-Cloud-API-Webhook | |
| Messenger-Webhook | |
| IMAP-Empfang und SMTP-Versand über TLS | |
| SMS | Twilio-Webhook und REST |
| DingTalk | Stream-Verbindung |
| Feishu / Lark | Standardmäßige dauerhafte Verbindung; vorhandene Webhook-Konten aktualisierbar |
| Weixin / WeChat | QR-bestätigtes Long-Polling |
| QQ Bot | WebSocket-Gateway |
| IRC | TLS und SASL |
| LINE | Messaging-API-Webhook |
Der Einrichtungsassistent ist der maßgebliche Katalog der installierten Version. Dort als nicht unterstützt markierte Einträge werden nicht durch erratene Konfiguration aktivierbar.
Schnelleinrichtung
Starten Sie das residente Gateway für das gewählte Profil und öffnen Sie dann den interaktiven Kanalassistenten:
anyy gateway start
anyy setup channel
Der Assistent liest den Katalog des laufenden Gateways. Wählen Sie die Plattform und füllen Sie die tatsächlich angebotenen Eingaben einschließlich CLI-Richtlinienoptionen aus; prüfen Sie die Zusammenfassung vor dem Schreiben. Für eine unkonfigurierte Plattform verwendet er das Standard-Verbindungsprofil und bietet keinen allgemeinen Profilwechselselektor. Die aktuellen Einrichtungsoberflächen erstellen ein Konto nur, wenn die Plattform keines hat; ein vorhandenes Konto wird aktualisiert.
In einem nicht interaktiven Terminal gibt der Befehl ohne Plattform den Katalog aus. Ein Plattformname wählt nicht interaktive Konfiguration: anyy setup channel telegram öffnet keinen Telegram-spezifischen Assistenten. Halten Sie das residente Gateway für Einrichtung und Nachrichtenbetrieb verfügbar.
Konfigurieren und testen Sie das Hauptmodell in Dashboard oder TUI vor dem Hinzufügen eines Kanals. So trennen Sie Modell-/Anbieterprobleme von Nachrichtenverbindungsproblemen.
Dashboard-Einrichtung
Öffnen Sie Dashboard → Kanal, um gespeicherte Konten und verfügbare Plattformtypen zu sehen. „Konfiguriert“ bedeutet in diesem Profil gespeichert, nicht unbedingt verbunden. Dort können Sie:
- ein Konto hinzufügen;
- den Standard-Konfigurationseintrag der Plattform verwenden;
- nicht geheime Felder und Zugangsdaten eingeben;
- Felder der Dashboard-Aktion dieses Kontos bearbeiten;
- Kontodetails und Zustand prüfen;
- Kanäle neu laden; und
- eine Verbindung entfernen.
Weixin / WeChat bietet QR-Anmeldung und ein Absenderzugriffsformular für gebundene Konten im Dashboard. Dashboard-/TUI-Zugangsdatenformulare anderer Plattformen bieten nicht die CLI-DM-/Gruppenrichtlinienfelder. Ändern Sie diese mit anyy setup channel im interaktiven Terminal. Der Katalog kann Aktionen deklarieren, die eine bestimmte Oberfläche nicht bietet; Feishu-Wechsel ist eine solche Einschränkung.
Zugriff und Kopplung
Kanalprofile können Richtlinien wie offenen Zugriff, Kopplung, Zulassungslisten, Gruppenzugriff nur bei Erwähnung oder deaktivierten Empfang anbieten. Verfügbare Optionen hängen vom Plattformvertrag ab.
Aktuelle Absenderlisteneingaben gibt es in Zugriffsformularen gebundener Weixin-Konten und im IRC-CLI-Assistenten. Andere Absender-/Gruppenlisten können bei Vorhandensein verwendet werden, doch aktuelle Einrichtungsaktionen bearbeiten ihre Einträge nicht. Die Auswahl allowlist befüllt keine Liste; eine leere/unpassende Liste verweigert dem Absender Zugriff. Erraten Sie keine zusätzlichen --set-Schlüssel und bearbeiten Sie nicht state.db.
Kopplungsanfragen werden über die CLI verwaltet; die aktuelle Dashboard-Kanalseite hat keine Kopplungsbestätigungsliste. Ausstehende Anfragen auflisten:
anyy channel pairing list
Nach Anfrage-ID bestätigen oder ablehnen:
anyy channel pairing approve --request REQUEST_ID
anyy channel pairing reject --request REQUEST_ID
Kopplungsanfrage eines Absenders mit interaktiv eingegebenem Code bestätigen:
anyy channel pairing approve --prompt-code \
--channel telegram --account personal
Vorhandene Berechtigung widerrufen:
anyy channel pairing revoke --grant GRANT_ID --reason "access removed"
Prüfen Sie Person/Konto und Plattform vor der Bestätigung. Eine Berechtigung kann unter der Kanalrichtlinie Gesprächszugriff und aktivierte Assistentenfähigkeiten zugänglich machen.
Gesprächsbereich
Anyy verwendet für dasselbe aktuelle Konto, Gegenüber und dieselbe Thread-Route eine gebundene Sitzung erneut. Gemeinsame Räume teilen Gesprächskontext. Plattform-Antwortkontext variiert: Slack und Discord bewahren Threads; aktuelle WhatsApp- und E-Mail-Routen verwenden auch eingehende Nachrichtenkennungen. Nachrichten desselben Kontakts teilen daher nicht überall eine Anyy-Sitzung.
/new erstellt für die aktuelle Route eine frische Sitzung; /stop unterbricht deren aktive Ausführung. Eine fehlgeschlagene Befehlsantwort macht eine festgeschriebene lokale Aktion nicht rückgängig. Das Neuerstellen eines Kontos oder Ändern seiner Identität erlaubt einer Ersatzverbindung nicht, historische Antworten erneut abzuspielen.
Zustand und Neuladen
Eine Plattform prüfen:
anyy channel doctor telegram
Kanalkonfiguration im laufenden Gateway neu laden:
anyy channel reload
Ergänzen Sie bei unterstützten Doctor-, Kopplungslisten- oder Neuladebefehlen --json für strukturierte Programmausgabe. Lokaler Aktionsbeleg, Adapter-Fähigkeitsdeklaration und beobachtete Nachrichtenzustellung sind getrennte Fakten. Der ausgelieferte Katalog kann ein ausführbares Profil als Vorschau kennzeichnen; testen Sie tatsächliches Konto und jede benötigte Fähigkeit.
Annahme durch die Plattform bedeutet nicht, dass der Empfänger die Nachricht gelesen hat. Ein Versand ohne Bestätigung kann sent_unconfirmed bleiben. Neue abschließende Antworten werden nur wiederholt, wenn der Fehler nachweislich vor einer externen Wirkung sicher auftrat; teilweise oder ungewisse Sendungen werden nicht automatisch vollständig wiederholt. Prüfen Sie das Gespräch vor Anforderung einer weiteren Kopie. Neuladen stimmt aktuelle Konten ab, statt alten Verlauf erneut abzuspielen.
Nicht interaktive Einrichtung
Automatisierung kann eine Plattform mit dem Kanalaktionsvertrag konfigurieren:
anyy setup channel CHANNEL \
[--set INPUT=VALUE] \
[--sensitive-fd INPUT=FD] \
[--external-locator-fd INPUT=FD]
Ein bereits konfiguriertes Telegram-Konto kann etwa seine Richtlinie mit anyy setup channel telegram --set dm_policy=pairing --set group_policy=mention aktualisieren. Neue Konten benötigen auch ihre deklarierten Zugangsdaten.
Verwenden Sie --set für nicht geheime Eingaben. Verwenden Sie --sensitive-fd mit einem eigenen offenen Deskriptor ab Nummer 3 für Zugangsdaten, damit Werte weder in Prozessargumenten noch Shell-Verlauf erscheinen. --external-locator-fd liefert extern verwaltete Geheimnisspeicherorte, wenn die gewählte Eingabe sie unterstützt.
Exakte Eingabe-IDs werden von gewählter Plattform/Profil definiert und im Einrichtungsablauf angezeigt. Erraten Sie keine Feldnamen anhand eines anderen Kanals.
Webhook-Plattformen
WhatsApp, Facebook, SMS, LINE und das Feishu-Webhook-Profil benötigen eingehende Webhook-Zustellung. Ihr Einrichtungsvertrag fragt nach plattformspezifischen Callback-Feldern und Prüfdaten.
Der gemeinsame Webhook-Listener ist standardmäßig deaktiviert. Aktivieren Sie ihn in config.yaml des gewählten Profils:
channel_webhooks:
enabled: true
listen: 127.0.0.1:8770
Starten Sie Gateway nach Änderung dieser Starteinstellung neu. anyy channel reload allein startet keinen zuvor deaktivierten Listener. Leiten Sie den exakten Plattformpfad /channels/PLATFORM/ACCOUNT_ID/webhook über HTTPS an diesen Listener, nicht an den Dashboard-Port. Bewahren Sie Body und Signaturheader, halten Sie Prüfgeheimnisse vertraulich und vervollständigen Sie Plattformabonnements/-berechtigungen. Twilio validiert auch die ursprüngliche öffentliche URL.
Fehlerbehebung
| Problem | Lösung |
|---|---|
| Konto gespeichert, empfängt aber nie | anyy gateway status und anyy channel doctor CHANNEL ausführen |
| Long-Poll-/WebSocket-Kanal trennt sich | Zugangsdaten/Netzzugriff korrigieren, dann anyy channel reload |
| Webhook-Prüfung schlägt fehl | Öffentliches HTTPS-Routing, Callback-URL, Signiergeheimnis und Plattformabonnement prüfen |
| Direktnachricht ignoriert | DM-Richtlinie, Kopplungszustand und Zulassungsliste prüfen |
| Gruppennachricht ignoriert | Gruppenrichtlinie und nötige Erwähnung prüfen |
| Falsche Person gekoppelt | Berechtigung sofort widerrufen und ausstehenden/aktiven Zugriff prüfen |