Aller au contenu principal

Notifications et livraison

Anyy peut publier des notifications immédiates et des messages visibles via le Gateway résident. La livraison tient compte du routage : l’assistant peut s’adresser à l’utilisateur actuel ou à l’origine fiable de la conversation de canal, sans viser des contacts externes arbitraires.

Deux actions de message​

ActionContenu et routage
Notification (notify_user)Texte avec titre facultatif ; delivery peut choisir Gateway, une origine fiable ou une liaison par défaut sur un canal donné. Aucune entrée de pièce jointe.
Message (send_message)Texte et pièces jointes compatibles ; target accepte uniquement current_user ou origin. Aucune entrée delivery ni sélection de canal.

Avec send_message, current_user utilise la route actuelle de l’environnement. Une demande Dashboard/TUI ordinaire utilise Gateway ; une conversation de canal fiable répond normalement à son origine. origin explicite exige des métadonnées de canal fiables et ne sélectionne pas la liaison par défaut d’une autre plateforme.

Les deux actions sont auditées. L’envoi n’est pas idempotent : réessayer peut produire un doublon.

Notifications dans l’historique​

Les notifications système indépendantes associées à une conversation restent visibles après changement de conversation, retour ou actualisation. Elles conservent leur carte System notification au lieu de devenir une réponse d’agent. Les anciens avis se chargent avec l’historique et la reconnexion ne crée pas de deuxième copie.

Ces cartes sont des enregistrements d’affichage séparés des messages Pi. Elles n’entrent pas dans le contexte du modèle et ne changent pas la branche sélectionnée. Un message avec pièce jointe peut disposer de sa projection conversationnelle existante ; il n’est pas dupliqué en carte système indépendante.

Anyy attribue au corps protégé un propriétaire durable avant publication, distinct de la charge de nouvelle tentative de livraison. Effacer celle d’une livraison terminée n’efface pas cet historique. Supprimer la conversation supprime ses notifications avec elle.

Cela concerne les notifications enregistrées par l’implémentation actuelle. Un ancien avis dont le corps exact a déjà été libéré ne peut pas être reconstitué fiablement depuis l’état ou le résumé d’un travail. Les événements en direct de tout le profil sans association de session, dont Heartbeat, sont hors de cette garantie d’historique par conversation.

Destinations de livraison​

Les travaux planifiés et notifications texte utilisent les destinations ci-dessous. none est disponible pour la gestion du planificateur dans Dashboard/CLI, mais n’est pas accepté par notify_user. Ces valeurs ne sont pas les cibles de send_message.

DestinationSignification
gatewayPublie dans le flux d’événements du Gateway résident
originRetourne à l’origine fiable de la conversation de canal actuelle
current_user_defaultRésout la liaison par défaut de l’utilisateur ; notify_user exige un delivery.channel tel que telegram
noneNe livre aucun résultat à l’utilisateur

Anyy ne considère pas les noms de plateforme comme des adresses arbitraires de destinataires. Une liaison de canal configurée et autorisée doit résoudre la route.

Demander un envoi à Anyy​

Exemples :

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.

Pour une notification texte vers une liaison par défaut configurée :

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

Pour une pièce jointe, faites la demande dans la conversation Telegram fiable où le rapport est disponible :

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

La première demande peut utiliser notify_user avec delivery: { target: "current_user_default", channel: "telegram" }. Celle avec pièce jointe utilise send_message vers l’origine fiable. Les interfaces actuelles ne permettent pas à une demande Dashboard de joindre un rapport à une liaison Telegram par défaut arbitrairement choisie.

Sans origine fiable ni liaison par défaut, Anyy signale une route indisponible au lieu de deviner un destinataire.

Reçus et état de livraison​

Une publication réussie prouve qu’Anyy a accepté et transmis l’événement dans sa chaîne de livraison. Elle ne prouve pas à elle seule la réception finale par Telegram, e-mail, SMS ou un autre service.

Les envois peuvent créer un reçu reflétant ensuite la progression de l’adaptateur. Les capacités varient : certains signalent un accusé, d’autres uniquement la transmission. Vérifiez la carte système de la conversation d’origine, l’enfant d’arrière-plan ou l’historique Cron, ainsi que la santé du canal ; fin d’exécution et livraison externe sont distinctes.

Éviter les nouvelles tentatives aveugles

Vérifiez le reçu ou la santé du canal avant de réessayer un envoi incertain. Un deuxième envoi peut créer un doublon si le premier est arrivé mais que son accusé a été retardé.

Pièces jointes​

Une pièce send_message doit être disponible dans le périmètre de session actuel, et le canal actuel/d’origine fiable doit déclarer son type de média compatible. notify_user est uniquement textuel, même vers une liaison par défaut. Les pièces incompatibles sont rejetées sans être abandonnées silencieusement.

Configurer une route par défaut​

Connectez le canal dans Dashboard → Channel ou avec anyy setup channel, vérifiez la règle d’accès/l’association et testez-le. Les travaux planifiés peuvent ensuite choisir current_user_default et un canal de livraison.

Consultez Plateformes de messagerie et Automatisations planifiées.

Dépannage​

ProblèmeSolution
Aucune route par défautConfigurez et vérifiez une liaison de canal pour l’utilisateur actuel
Livraison à l’origine indisponibleLancez la demande depuis une conversation de canal fiable
Publication réussie sans message externeVérifiez reçu, état du Gateway et diagnostic du canal
Message en doubleArrêtez les tentatives automatiques et inspectez l’ancien reçu/événement
Pièce jointe rejetéeUtilisez un type de média compatible avec le canal sélectionné