Benachrichtigungen und Zustellung

Anyy kann unmittelbare Benachrichtigungen und sichtbare Nachrichten über das residente Gateway veröffentlichen. Die Zustellung berücksichtigt Routen: Der Assistent kann den aktuellen Benutzer oder vertrauenswürdigen Ursprung des aktuellen Kanalgesprächs adressieren, keine beliebigen externen Kontakte.

Zwei Nachrichtenaktionen

Aktion	Inhalt und Routing
Benachrichtigung (notify_user)	Text mit optionalem Titel; delivery kann Gateway, vertrauenswürdigen Ursprung oder eine Standardbindung auf einem angegebenen Kanal wählen. Keine Anhangseingabe.
Nachricht (send_message)	Text und unterstützte Anhänge; target ist nur current_user oder origin. Keine Eingabe für delivery oder Kanalauswahl.

Bei send_message verwendet current_user die aktuelle Laufzeitroute. Eine normale Dashboard-/TUI-Anfrage verwendet Gateway; ein vertrauenswürdiges Kanalgespräch antwortet normalerweise an seinen Ursprung. Explizites origin erfordert vertrauenswürdige Kanalmetadaten. Es wählt nicht die Standardbindung einer anderen Plattform.

Beide Aktionen werden protokolliert. Senden ist nicht idempotent: Eine Wiederholung kann doppelte Nachrichten erzeugen.

Benachrichtigungen im Chatverlauf

Unabhängige, einem Gespräch zugeordnete Systembenachrichtigungen bleiben sichtbar, wenn Sie zu einem anderen Gespräch wechseln, zurückkehren oder die Seite neu laden. Sie behalten ihre Karte Systembenachrichtigung, statt eine Agentenantwort zu werden. Ältere Meldungen laden mit dem Gesprächsverlauf; eine erneute Verbindung erstellt keine zweite Kopie derselben Meldung.

Diese Systemkarten sind Anzeigedatensätze getrennt von Pi-Gesprächsnachrichten. Sie gehen weder in den Modellkontext ein noch ändern sie den ausgewählten Gesprächszweig. Eine Nachricht mit Anhängen kann stattdessen ihre vorhandene Gesprächsdarstellung haben; diese Nachricht wird nicht als unabhängige Systemkarte dupliziert.

Anyy gibt dem geschützten Benachrichtigungsinhalt vor der Veröffentlichung einen eigenen dauerhaften Besitzer. Dieser ist von einer Zustellwiederholungs-Nutzlast getrennt. Das Löschen der Wiederholungs-Nutzlast einer abgeschlossenen Zustellung löscht diesen Gesprächsverlauf nicht. Das Löschen des Gesprächs entfernt dessen Benachrichtigungsverlauf zusammen mit dem Gespräch.

Dies gilt für mit der aktuellen Implementierung gespeicherte Meldungen. Eine ältere Meldung, deren exakter Inhalt bereits freigegeben wurde, lässt sich nicht zuverlässig aus Status oder Zusammenfassung eines Auftrags rekonstruieren. Profilweite Live-Ereignisse ohne Sitzungszuordnung, einschließlich Heartbeat-Meldungen, fallen nicht unter diese Garantie pro Gespräch.

Zustellziele

Geplante Aufträge und Textbenachrichtigungen verwenden die folgenden Routingbegriffe. none steht der Scheduler-Verwaltung über Dashboard/CLI zur Verfügung; es ist kein akzeptiertes Zustellziel für notify_user. Diese Werte sind keine send_message-Zielwerte.

Ziel	Bedeutung
gateway	Im Ereignisstrom des residenten Gateways veröffentlichen
origin	Zum vertrauenswürdigen Ursprung des aktuellen Kanalgesprächs zurückleiten
current_user_default	Standardbindung des aktuellen Benutzers auflösen; notify_user benötigt delivery.channel, etwa telegram
none	Kein benutzersichtbares Ergebnis zustellen

Anyy behandelt Plattformnamen nicht als beliebige Empfängeradressen. Eine konfigurierte und autorisierte Kanalbindung muss die Route auflösen.

Anyy um Versand bitten

Beispiele:

When this check finishes, notify me with the title “Backup verified” and a one-line result.

Send this summary back to the current Channel conversation.

Für eine reine Textbenachrichtigung an eine konfigurierte Standardbindung:

Notify my default Telegram binding with a short text summary of this result.

Stellen Sie für einen Anhang die Anfrage im vertrauenswürdigen Telegram-Gespräch, in dem das Berichtsartefakt verfügbar ist:

Reply to this Telegram conversation with the generated report as an attachment.

Die erste Anfrage kann notify_user mit delivery: { target: "current_user_default", channel: "telegram" } verwenden. Die Anhangsanfrage verwendet send_message an den vertrauenswürdigen Ursprung. Die aktuellen Schnittstellen erlauben einer Dashboard-Anfrage nicht, einen Bericht an eine beliebig ausgewählte Standard-Telegram-Bindung anzuhängen.

Fehlt ein vertrauenswürdiger Ursprung oder eine Standardbindung, meldet Anyy eine nicht verfügbare Route, statt einen Empfänger zu erraten.

Belege und Zustellstatus

Eine erfolgreiche Veröffentlichung beweist, dass Anyy das Ereignis angenommen und an seine Zustellpipeline übergeben hat. Sie beweist für sich nicht den endgültigen Empfang bei Telegram, E-Mail, SMS oder einem anderen externen Dienst.

Nachrichtenversand kann einen Beleg erzeugen, der später Adapter-Zustellfortschritt widerspiegelt. Kanalfähigkeiten unterscheiden sich: Einige Adapter melden Bestätigungen, andere nur Versand. Prüfen Sie Systemkarte des Ursprungsgesprächs, Hintergrundkind oder Cron-Ausführungsverlauf sowie Kanalzustand; ein abgeschlossener Lauf und externe Zustellung sind getrennte Zustände.

Nicht blind wiederholen

Prüfen Sie vor einem erneuten ungewissen Versand Nachrichtenbeleg oder Kanalzustand. Ein zweiter Versand kann ein Duplikat erzeugen, wenn der erste den Anbieter erreicht hat, dessen Bestätigung aber verspätet war.

Anhänge

Ein Anhang für send_message muss im aktuellen Sitzungsbereich verfügbar sein, und der aktuelle/vertraute Ursprungskanal muss seinen Medientyp unterstützen. notify_user ist rein textbasiert, auch bei Auswahl einer Standard-Kanalbindung. Nicht unterstützte Anhänge werden abgelehnt, statt stillschweigend verworfen.

Eine Standardroute konfigurieren

Verbinden Sie den Kanal unter Dashboard → Kanal oder mit anyy setup channel, prüfen Sie Absenderzugriffsrichtlinie/Kopplung und testen Sie ihn. Geplante Aufträge können danach current_user_default mit einem Zustellkanal wählen.

Siehe Nachrichtenplattformen und Geplante Automatisierungen.

Fehlerbehebung

Problem	Lösung
Keine Standardroute	Kanalbindung für den aktuellen Benutzer konfigurieren und prüfen
Ursprungszustellung nicht verfügbar	Anfrage in einem vertrauenswürdigen Kanalgespräch starten
Veröffentlichung erfolgreich, aber keine externe Nachricht sichtbar	Beleg, Gateway-Status und Kanal-Doctor-Ausgabe prüfen
Doppelte Nachricht	Automatische Wiederholungen stoppen und früheren Beleg/Ereignis prüfen
Anhang abgelehnt	Vom gewählten Kanal unterstützten Medientyp verwenden