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.
TelegramLien vers la section Telegram
Ce qu’il faut savoirLien vers la section 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.
1. Créer votre botLien vers la section 1. Créer votre bot
- Dans Telegram, ouvrez @BotFather et envoyez
/newbot. - Choisissez un nom, puis un nom d’utilisateur qui finit par
bot, par exempleemma_moon_bot. - Copiez le jeton que BotFather vous donne.
- Recommandé : envoyez
/à BotFather, puis « Disable », pour que personne ne puisse ajouter votre bot à un groupe.setjoingroups
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 TelegramLien vers la section 2. Connecter Telegram
- « Connecteurs » › « Catalogue » › Telegram › « Connecter ».
- Collez le jeton du bot sur la page de connexion, puis revenez sur Moon AI.
3. Relier le bot à un agentLien vers la section 3. Relier le bot à un agent
- « Connecteurs » › « Messageries » › « Relier une messagerie », ou, sur la page d’un agent, « Lui parler depuis une messagerie ».
- Choisissez l’« Agent qui répond ».
- Réglez les options (voir plus bas).
- 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.
- Cochez la case de consentement, puis cliquez sur « Relier ».
- 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 liaisonLien vers la section 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’agentLien vers la section 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 /. |
/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 TelegramLien vers la section 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.
LimitesLien vers la section 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élierLien vers la section 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.
DéclencheursLien vers la section 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.
Événements disponiblesLien vers la section É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éclencheurLien vers la section Créer un déclencheur
- Ouvrez la page de l’agent, onglet « Tâches », section « Déclencheurs ».
- Cliquez sur « Ajouter un déclencheur ».
- Choisissez l’événement dans « Quand ».
- 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.
- Écrivez la « Consigne » de « Ce que fait l’agent », par exemple : « Résume l’e-mail et prépare une réponse. »
- 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.
- Réglez « Lancements par jour au maximum » (de 1 à 100).
- Cochez si besoin « Laisser l’agent préparer des actions » : chaque action attend votre accord.
- 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.
Suivre et gérerLien vers la section 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.