> ## Documentation Index
> Fetch the complete documentation index at: https://docs.piperai.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Recording Bot : configurez l'activation et le comportement du bot
> Contrôlez quand le bot de Piper rejoint vos réunions, ce qu'il dit à son arrivée, et comment gérer les cas particuliers comme les arrivées tardives ou les réunions silencieuses.
Le bot d'enregistrement de Piper rejoint automatiquement vos réunions de calendrier, capture la conversation, et transmet la transcription pour traitement. Vous contrôlez exactement quelles réunions il rejoint, lesquelles il ignore, sous quel nom il apparaît, et quel message il envoie aux participants à son arrivée. Tous les paramètres du bot se trouvent dans **Settings → Recording**.
## Activation du bot
Accédez à **Settings → Recording → Transcription Bot → Enable the Bot** et choisissez l'un des modes d'activation suivants :
| Mode | Comportement |
| --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **Do not activate automatically** | Le bot ne rejoint jamais de lui-même. Vous l'envoyez manuellement depuis la Home Page si besoin. |
| **All events** | Le bot rejoint chaque événement de calendrier comportant un lien de visioconférence. |
| **Internal events** | Le bot rejoint uniquement les réunions où tous les participants partagent votre domaine e-mail. |
| **External events** | Le bot rejoint toute réunion incluant au moins un participant hors de votre domaine e-mail. |
| **Owned events** | Le bot rejoint uniquement les réunions que vous avez créées. Les réunions auxquelles vous avez été invité par quelqu'un d'autre sont ignorées. |
La plupart des équipes commerciales utilisent **External events** — cela capture automatiquement chaque appel client tout en laissant les standups internes et les 1:1 sans bot.
## Règles de désactivation du bot
Même avec un mode d'activation large, vous pouvez prévoir des exceptions. Sous **Settings → Recording → Bot Deactivation Rules**, définissez des règles qui empêchent le bot de rejoindre certaines réunions.
**Règles de mots-clés** — Saisissez des mots ou expressions qui, s'ils sont trouvés dans le titre de la réunion, font que le bot l'ignore. Par exemple : `Lunch`, `☕️`, `Off-site`, `Interview`.
**Règles de motif e-mail** — Saisissez une chaîne contenant `@`. Piper la traite comme un motif de domaine e-mail et vérifie l'adresse de chaque participant. Si un participant correspond, le bot ignore la réunion. Par exemple : `@recruiting-agency.com` écarte le bot de toute réunion incluant quelqu'un de ce domaine.
Vous pouvez aussi définir des règles de désactivation au niveau du Meeting Type (dans **Settings → Meeting Types → \[type] → Bot Deactivation Rules**), ce qui vous donne un contrôle encore plus granulaire sur les types d'appels enregistrés.
## Message de connexion du bot
Lorsque le bot rejoint une réunion, il envoie un message pour informer les participants que l'appel est enregistré. Vous pouvez personnaliser à la fois le nom d'affichage du bot et le message qu'il envoie.
Par défaut, le bot rejoint sous le nom **PiperAI** et envoie ce message de consentement :
> *"Hi! This video call will be automatically recorded and its content may be processed by third-party providers. If you do not consent to this, please let the organizer know so that this feature can be turned off. For more information visit [www.piperai.com](http://www.piperai.com)"*
Pour personnaliser pour un utilisateur spécifique, allez dans **Settings → Users**, trouvez l'utilisateur, et mettez à jour son nom de bot et son message de connexion. Définir un message honnête et amical renforce la confiance des participants et vous maintient conforme aux normes de consentement d'enregistrement.
## Statut du bot et Activity Card
L'Activity Card de la Home Page affiche le statut actuel du bot pour chaque réunion à venir et récente. Chaque statut est coloré pour une lecture visuelle rapide :
| Statut | Couleur | Ce que cela signifie |
| ---------------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Scheduled** | Bleu | Le bot est en file d'attente et rejoindra au début de la réunion. |
| **Joining** | Bleu | Le bot est en train de se connecter à la salle de réunion. |
| **Waiting in lobby** | Orange ⚠️ | Le bot a atteint la réunion mais attend que l'hôte l'admette. |
| **Active / Recording** | Bleu 🔴 | Le bot est dans la réunion et enregistre. Un point rouge clignotant apparaît à côté du libellé de statut pendant que l'enregistrement est en direct. |
| **Left** | — | Le bot a quitté la réunion et le traitement a commencé. |
| **Failed to join** | Rouge | Le bot n'a pas pu entrer dans la réunion. Un message de diagnostic explique pourquoi (par ex. hôte n'a pas admis, plateforme non prise en charge, mot de passe incorrect). |
## Envoyer le bot manuellement
Vous pouvez envoyer le bot à toute réunion actuellement active directement depuis la Home Page :
Sur la Home Page, localisez la réunion dans votre Activity Card.
Cliquez sur **Send Bot** sur l'activity card de cette réunion.
L'option manuelle **Send Bot** ne fonctionne que pour les réunions actuellement actives (en cours). Elle ne peut pas programmer un bot pour une réunion future — utilisez les paramètres d'activation automatique ou la synchronisation de calendrier pour les réunions futures.
## Ajouts tardifs et timing
Le bot est programmé pour rejoindre au début de chaque réunion. Si une réunion est ajoutée à la dernière minute et que le bot ne la rejoint pas de lui-même, utilisez le bouton manuel **Send Bot** depuis l'Activity Card de la Home Page une fois la réunion commencée.
## Détection de silence
Le bot quitte automatiquement après une période prolongée sans personne qui parle, afin de ne pas rester dans une réunion vide une fois l'appel terminé.
Si le bot quitte pour cause de silence mais que la réunion reprend, utilisez **Send Bot** depuis l'Activity Card pour le faire revenir (la réunion doit être encore active).
## Import manuel d'audio ou de vidéo
Si vous enregistrez un appel en dehors du bot de Piper — sur un téléphone ou dans un enregistreur séparé — vous pouvez tout de même le faire passer par le pipeline complet de traitement de Piper.
Cliquez sur le bouton d'import en haut à droite de la Home Page.
Choisissez votre fichier audio ou vidéo. Piper prend en charge les formats courants dont MP3, M4A, WAV, MP4, MOV et AVI, jusqu'à 2 Go et 4 heures 15 minutes.
Donnez un titre à l'import et sélectionnez le Meeting Type approprié pour que Piper applique le bon template de notes, la bonne grille de notation et les bons champs CRM.
Piper traite le fichier exactement comme un appel enregistré par le bot — vous obtiendrez une transcription complète, des notes, un brouillon d'e-mail et une extraction de champs CRM.