# Messageries et déclencheurs

> Parler à vos agents depuis Telegram avec votre propre bot, et lancer un agent tout seul quand un e-mail, un commentaire ou une réunion arrive.

Vous pouvez écrire à un agent depuis Telegram, avec votre propre bot : il vous répond là-bas, avec les mêmes outils et les mêmes limites que dans la conversation. Avec les déclencheurs, un agent peut aussi démarrer seul quand un événement arrive dans un de vos services.

## Telegram

### Ce qu’il faut savoir

- Vous créez votre propre bot Telegram. Le compte Telegram qui envoie le code de liaison devient le seul à pouvoir parler à l’agent : toute autre personne est ignorée.
- Les conversations apparaissent aussi dans Moon AI.
- Les messages transitent en clair par Telegram et par notre service de connexion, aux États-Unis, qui les conserve jusqu’à un an. Moon Blur ne les protège que vis-à-vis des fournisseurs d’IA.

> [!NOTE]
> **Selon votre forfait**
>
> Les messageries sont incluses dans les forfaits avec connecteurs. Vous pouvez relier jusqu’à 5 messageries. Voir les [formules](https://realmoon.ai/tarifs/).

### 1. Créer votre bot

1. Dans Telegram, ouvrez @BotFather et envoyez `/newbot`.
2. Choisissez un nom, puis un nom d’utilisateur qui finit par `bot`, par exemple `emma_moon_bot`.
3. Copiez le jeton que BotFather vous donne.
4. Recommandé : envoyez `/setjoingroups` à BotFather, puis « Disable », pour que personne ne puisse ajouter votre bot à un groupe.

Utilisez un bot créé pour Moon AI seulement : un bot déjà utilisé par un autre service cesse d’y recevoir ses messages.

### 2. Connecter Telegram

1. « Connecteurs » › « Catalogue » › Telegram › « Connecter ».
2. Collez le jeton du bot sur la page de connexion, puis revenez sur Moon AI.

### 3. Relier le bot à un agent

1. « Connecteurs » › « Messageries » › « Relier une messagerie », ou, sur la page d’un agent, « Lui parler depuis une messagerie ».
2. Choisissez l’« Agent qui répond ».
3. Réglez les options (voir plus bas).
4. Collez de nouveau le jeton du bot quand Moon AI le demande. Moon AI le garde chiffré et ne s’en sert que pour configurer votre bot, montrer qu’il écrit et l’arrêter.
5. Cochez la case de consentement, puis cliquez sur « Relier ».
6. Ouvrez le lien sur le téléphone où Telegram est installé, ou scannez le QR code : Telegram ouvre votre bot. Appuyez sur « Démarrer ».

Le code de liaison est valable 10 minutes et accepte 5 essais. Si le délai est passé, ouvrez la fiche de la liaison et cliquez sur « Obtenir un code », puis envoyez-le tout de suite. Le bot répond « Relié à Moon AI », avec le nom de l’agent par défaut.

### Options de la liaison

| Option | Effet |
| --- | --- |
| « Laisser l’agent préparer des actions » | L’agent peut préparer des messages, publications, événements… Chaque action attend votre accord, avec un bouton dans Telegram ou dans Moon AI. |
| « Respecter mes réglages « Agir sans demander » » | Déconseillé. Les actions des connecteurs réglés pour agir sans demander s’exécutent alors sans validation, même depuis Telegram. |
| « Répondre aux inconnus » | Toute autre personne qui écrit au bot reçoit « Ce bot est privé. », au plus une fois par jour. Sinon, personne d’autre ne reçoit de réponse. |

### Parler à l’agent

Écrivez au bot comme à n’importe qui. Le bot montre qu’il écrit et répond « Je m’en occupe… » pendant que l’agent travaille.

| Commande | Effet |
| --- | --- |
| `/nouveau` | Ouvre une nouvelle conversation. |
| `/agent` | Liste les agents disponibles. Répondez `/agent` suivi du numéro pour en choisir un pour cette conversation. |
| `/stop` | Arrête la réponse en cours. |
| `/delier` | Délie la messagerie. Moon AI demande de confirmer avec `/delier confirmer`. |
| `/aide` | Affiche l’aide. |

Les commandes anglaises (`/new`, `/help`, `/unlink`) fonctionnent aussi.

- Seuls les messages texte sont lus, dans la conversation privée avec le bot, 8 000 caractères au plus. Un fichier envoyé sans texte n’est pas pris en charge.
- Un message transféré est traité comme un contenu écrit par quelqu’un d’autre : l’agent ne suit pas ses consignes.
- Une réponse longue se termine par « Lire la suite dans Moon AI » avec un lien. Les fichiers créés sont à ouvrir dans Moon AI.
- La ligne « Outils utilisés » dit quels outils l’agent a appelés.

### Valider une action depuis Telegram

Quand l’agent veut agir, Telegram affiche l’action avec les boutons « Valider » et « Refuser », et un lien « Voir et valider dans Moon AI ». La même demande attend aussi dans « À valider ». La première décision compte, où qu’elle soit prise. Voir [Valider les actions](https://realmoon.ai/documentation/agents/valider/).

### Limites

| Limite | Valeur |
| --- | --- |
| Messages | 20 par 10 minutes et 300 par jour, par liaison |
| Réponses en même temps | 3 |
| Longueur d’un message | 8 000 caractères |

Chaque réponse compte dans votre limite d’utilisation, comme un message dans Moon AI. Quand la limite est atteinte, le bot le dit, avec l’heure de reprise.

### Gérer et délier

« Connecteurs » › « Messageries » liste vos liaisons, avec la date du dernier message. La fiche d’une liaison montre qui peut parler à l’agent. Elle permet de changer l’« Agent par défaut » (pour les nouvelles conversations ; `/agent` en choisit un autre dans une conversation), de mettre la liaison en « Pause » puis « Reprendre », et de « Délier ». Si Moon AI a besoin du jeton du bot de nouveau, la fiche le demande : collez-le, puis « Enregistrer le jeton ».

Une fois la messagerie déliée, le bot ne répond plus ; vos conversations restent dans Moon AI. Pour l’utiliser de nouveau, reliez-la avec un nouveau code. Supprimer l’agent qui répond met la liaison en pause jusqu’à ce que vous choisissiez un autre agent.

> [!NOTE]
> **Autres messageries**
>
> Parler à un agent depuis WhatsApp, Instagram ou Messenger n’est pas possible. Vos agents peuvent en revanche y publier et y envoyer des messages une fois le connecteur ajouté.

## Déclencheurs

Un déclencheur lance un agent tout seul quand quelque chose arrive dans un de vos services : un nouvel e-mail, un commentaire, une réunion qui approche. L’agent travaille dans sa propre conversation et vous demande votre accord avant d’agir.

> [!NOTE]
> **Selon votre forfait**
>
> Les déclencheurs d’agents sont inclus dans les forfaits avec tâches planifiées. Voir les [formules](https://realmoon.ai/tarifs/).

### Événements disponibles

| Service | Événements |
| --- | --- |
| Gmail, Outlook | « Nouvel e-mail reçu » |
| Google Agenda | « Réunion qui commence bientôt » |
| Slack | « Message dans un salon » |
| GitHub | « Nouveau commentaire », « Nouvelle issue », « Nouvelle pull request » |
| Notion | « Nouveau commentaire », « Nouvelle page » |
| Linear, Jira, Trello, Asana | « Nouveau commentaire » |
| YouTube | « Nouvelle activité » |

Le service doit être connecté dans « Connecteurs » et ne pas être en pause.

### Créer un déclencheur

1. Ouvrez la page de l’agent, onglet « Tâches », section « Déclencheurs ».
2. Cliquez sur « Ajouter un déclencheur ».
3. Choisissez l’événement dans « Quand ».
4. Remplissez « Seulement ces expéditeurs » : une adresse, un domaine ou un nom d’utilisateur par ligne. C’est recommandé, car n’importe qui peut vous envoyer un e-mail ou un commentaire.
5. Écrivez la « Consigne » de « Ce que fait l’agent », par exemple : « Résume l’e-mail et prépare une réponse. »
6. Choisissez « Où va le résultat » : « Dans sa conversation », « Dans sa conversation, avec une notification », ou dans sa conversation et sur une messagerie reliée.
7. Réglez « Lancements par jour au maximum » (de 1 à 100).
8. Cochez si besoin « Laisser l’agent préparer des actions » : chaque action attend votre accord.
9. Cliquez sur « Créer le déclencheur ».

« Filtres (facultatif) » ajoute « Ignorer ces expéditeurs » et « Seulement s’il contient » (un mot par ligne). Un événement ignoré ne lance rien et n’utilise rien de votre limite. Si le service choisi est en pause, reprenez-le d’abord : il revient partout, dans les conversations, les agents et les routines.

> [!WARNING]
> **Le contenu vient d’un tiers**
>
> Le contenu d’un événement (un e-mail, un commentaire) est écrit par quelqu’un d’autre. L’agent ne suit jamais les consignes qu’il pourrait contenir, et ses actions attendent toujours votre validation.

### Suivre et gérer

La section « Déclencheurs » affiche, pour chacun, le nombre de lancements du jour et l’heure du dernier événement. « Résultats » ouvre sa conversation. « Modifier », « Pause », « Reprendre » et « Supprimer le déclencheur » le gèrent ; supprimer un déclencheur garde sa conversation dans votre historique.

Chaque lancement utilise votre limite d’utilisation, comme un message. Vous pouvez avoir jusqu’à 20 déclencheurs. Si la page indique que les déclencheurs sont suspendus pour le moment, les nouveaux événements ne lancent pas l’agent jusqu’à leur retour ; vos déclencheurs gardent leurs réglages.

## Voir aussi

- [Agents](https://realmoon.ai/documentation/agents/agents/)
- [Valider les actions](https://realmoon.ai/documentation/agents/valider/)
- [Notifications](https://realmoon.ai/documentation/agents/notifications/)

---

Documentation Moon AI › Agents, routines et connecteurs › Messageries et déclencheurs. Page : https://realmoon.ai/documentation/agents/messageries/. Modifiée le 5 novembre 2026.

© 2026 Stellarr Studio SAS. Tous droits réservés. Moon AI, Moon Blur et Stellarr Studio sont des marques déposées à l’INPI.