> ## 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: configura la activación y el comportamiento del bot
> Controla cuándo el bot de Piper se une a tus reuniones, qué dice al llegar, y cómo gestionar casos especiales como uniones tardías o reuniones silenciosas.
El bot de grabación de Piper se une automáticamente a tus reuniones de calendario, captura la conversación y entrega la transcripción para su procesamiento. Controlas exactamente a qué reuniones se une, cuáles omite, con qué nombre aparece y qué mensaje envía a los asistentes al llegar. Toda la configuración del bot se encuentra en **Settings → Recording**.
## Activación del bot
Ve a **Settings → Recording → Transcription Bot → Enable the Bot** y elige uno de los siguientes modos de activación:
| Modo | Comportamiento |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| **Do not activate automatically** | El bot nunca se une por sí solo. Lo envías manualmente desde la Home Page cuando lo necesites. |
| **All events** | El bot se une a todo evento de calendario que tenga un enlace de videoconferencia. |
| **Internal events** | El bot se une solo a reuniones donde todos los asistentes comparten tu dominio de correo. |
| **External events** | El bot se une a cualquier reunión que incluya al menos un asistente fuera de tu dominio de correo. |
| **Owned events** | El bot se une solo a reuniones que tú creaste. Las reuniones a las que fuiste invitado por otra persona se omiten. |
La mayoría de los equipos comerciales usan **External events**: captura automáticamente cada llamada de cara al cliente sin poner el bot en los standups internos ni en los 1:1.
## Reglas de desactivación del bot
Aun con un modo de activación amplio, puedes definir excepciones. En **Settings → Recording → Bot Deactivation Rules**, define reglas que impidan que el bot se una a reuniones específicas.
**Reglas de palabras clave** — Ingresa palabras o frases que, si se encuentran en el título de la reunión, hacen que el bot la omita. Por ejemplo: `Lunch`, `☕️`, `Off-site`, `Interview`.
**Reglas de patrón de correo** — Ingresa una cadena que contenga `@`. Piper la trata como un patrón de dominio de correo y revisa la dirección de cada asistente. Si algún asistente coincide, el bot omite la reunión. Por ejemplo: `@recruiting-agency.com` mantiene al bot fuera de cualquier reunión que incluya a alguien de ese dominio.
También puedes definir reglas de desactivación a nivel de Meeting Type (en **Settings → Meeting Types → \[tipo] → Bot Deactivation Rules**), lo que te da un control aún más granular sobre qué tipos de llamada se graban.
## Mensaje de conexión del bot
Cuando el bot se une a una reunión, envía un mensaje para informar a los asistentes que la llamada está siendo grabada. Puedes personalizar tanto el nombre de visualización del bot como el mensaje que envía.
Por defecto, el bot se une como **PiperAI** y envía este mensaje de consentimiento:
> *"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)"*
Para personalizarlo para un usuario específico, ve a **Settings → Users**, busca al usuario y actualiza su nombre de bot y mensaje de conexión. Configurar un mensaje honesto y amigable genera confianza en los asistentes y te mantiene alineado con las normas de consentimiento de grabación.
## Estado del bot y la Activity Card
La Activity Card de la Home Page muestra el estado actual del bot para cada reunión próxima y reciente. Cada estado tiene un código de color para una lectura visual rápida:
| Estado | Color | Qué significa |
| ---------------------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Scheduled** | Azul | El bot está en cola y se unirá a la hora de inicio de la reunión. |
| **Joining** | Azul | El bot se está conectando a la sala de reunión. |
| **Waiting in lobby** | Naranja ⚠️ | El bot llegó a la reunión pero está esperando que el organizador lo admita. |
| **Active / Recording** | Azul 🔴 | El bot está en la reunión y grabando. Un punto rojo parpadeante aparece junto a la etiqueta de estado mientras la grabación está activa. |
| **Left** | — | El bot se ha ido y el procesamiento ha comenzado. |
| **Failed to join** | Rojo | El bot no pudo entrar a la reunión. Un mensaje de diagnóstico explica por qué (por ejemplo, el organizador no lo admitió, plataforma no compatible, contraseña incorrecta). |
## Enviar el bot manualmente
Puedes enviar el bot a cualquier reunión activa en este momento directamente desde la Home Page:
En la Home Page, localiza la reunión en tu Activity Card.
Haz clic en **Send Bot** en la tarjeta de actividad de esa reunión.
La opción manual **Send Bot** solo funciona para reuniones que están activas en este momento (en curso). No puede programar un bot para una reunión futura; usa la configuración de activación automática o la sincronización de calendario para reuniones futuras.
## Incorporaciones tardías y tiempos
El bot está programado para unirse a la hora de inicio de cada reunión. Si una reunión se agrega de último momento y el bot no se une por sí solo, usa el botón manual **Send Bot** desde la Activity Card de la Home Page una vez que la reunión haya comenzado.
## Detección de silencio
El bot se retira automáticamente tras un período prolongado sin que nadie hable, para no quedarse en una reunión vacía después de que la llamada haya terminado.
Si el bot se retira por silencio pero la reunión se reanuda, usa **Send Bot** desde la Activity Card para traerlo de vuelta (la reunión debe seguir activa).
## Subir audio o video manualmente
Si grabas una llamada fuera del bot de Piper —en un teléfono o en una grabadora separada—, aún puedes procesarla a través de todo el pipeline de Piper.
Haz clic en el botón de carga en la esquina superior derecha de la Home Page.
Elige tu archivo de audio o video. Piper admite formatos comunes, incluidos MP3, M4A, WAV, MP4, MOV y AVI, de hasta 2 GB y 4 horas 15 minutos.
Dale un título a la carga y selecciona el Meeting Type adecuado para que Piper aplique la plantilla de notas, la rúbrica de puntuación y los campos de CRM correctos.
Piper procesa el archivo exactamente igual que una llamada grabada por el bot: obtendrás una transcripción completa, notas, un borrador de correo y extracción de campos de CRM.