> ## 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.

# Solución de problemas del bot de Piper y problemas de grabación

> Resuelve problemas comunes del bot de Piper: no se unió, se fue antes de tiempo, omitió una reunión, o no se activa, con guías paso a paso para cada escenario.

El bot de Piper se une automáticamente a tus reuniones y te envía una transcripción y un resumen de IA cuando termina la llamada. La mayoría de los problemas con el bot siguen un puñado de patrones predecibles: una reunión perdida, una salida temprana, una regla de desactivación que no sabías que estaba activa. Recorre los escenarios a continuación para identificar y resolver el problema rápidamente.

<Accordion title="El bot no se unió a mi reunión">
  La causa más común es que el bot simplemente no se activó para esa reunión específica. Puedes enviarlo manualmente siempre que la reunión esté activa en ese momento.

  <Steps>
    <Step title="Encuentra la reunión en tu Home Page">
      Localiza la Activity Card de la reunión que está actualmente en curso.
    </Step>

    <Step title="Envía el bot manualmente">
      Haz clic en **Send Bot** en la Activity Card. El bot se unirá en unos momentos.
    </Step>

    <Step title="Monitorea el estado del bot">
      La Activity Card se actualiza en tiempo real. Verás el estado pasar de *Bot joining* a *Bot active/recording* una vez que se haya conectado con éxito.
    </Step>
  </Steps>

  <Warning>
    La acción **Send Bot** solo funciona para reuniones que están activas en ese momento. No puedes enviar el bot a una reunión que ya terminó o que aún no ha comenzado.
  </Warning>

  Si el bot sigue sin unirse después de usar Send Bot, revisa la Activity Card por un estado *Failed to join*; incluirá un mensaje de diagnóstico que explica el error específico.
</Accordion>

<Accordion title="El bot abandonó mi reunión antes de tiempo">
  Piper abandona automáticamente una reunión después de un periodo prolongado de silencio continuo. Esto es intencional: la plataforma asume que la reunión terminó si no se detecta audio durante un tiempo.

  Las causas comunes incluyen:

  * Un segmento largo de pantalla compartida o presentación donde nadie habló.
  * Una sala de espera o periodo de espera al inicio de la llamada.
  * Problemas de enrutamiento de audio del lado del organizador que Piper no pudo detectar.

  **Para que el bot regrese a una reunión en curso:**

  <Steps>
    <Step title="Ve a tu Home Page">
      Encuentra la Activity Card de la reunión que sigue en curso.
    </Step>

    <Step title="Haz clic en Send Bot">
      Esto reincorpora al bot a la llamada en vivo. La grabación se reanudará desde ese punto.
    </Step>
  </Steps>

  <Note>
    La transcripción de la sesión reflejará el hueco en la grabación. La sección antes de que el bot se fuera y la sección después de que se reincorporó aparecerán ambas en tu transcripción final.
  </Note>
</Accordion>

<Accordion title="El bot no estuvo listo a tiempo para mi reunión">
  El bot está programado para unirse a la hora de inicio de la reunión. Si una reunión se agrega de último momento, la unión automática puede no estar configurada a tiempo.

  **Solución:** Usa la opción manual **Send Bot** desde la Activity Card de la Home Page una vez que la reunión esté en curso. El bot se unirá rápidamente cuando se active manualmente, sin importar cuándo se agregó la reunión.

  <Tip>
    Para llamadas recurrentes o llamadas programadas con poco margen, recuerda que el botón Send Bot siempre está disponible como respaldo. No necesitas esperar al flujo automático.
  </Tip>
</Accordion>

<Accordion title="No estoy recibiendo el bot en ninguna de mis reuniones">
  Si el bot no se une a ninguna reunión automáticamente, tu modo de activación puede estar configurado para impedir la unión automática.

  <Steps>
    <Step title="Abre Settings → Recording">
      Navega a **Settings** y luego selecciona la sección **Recording**.
    </Step>

    <Step title="Revisa el modo de activación de Transcription Bot">
      Revisa la configuración de **Transcription Bot**. Si está configurada en **Do not activate automatically**, el bot nunca se unirá a las llamadas sin un disparo manual de Send Bot.
    </Step>

    <Step title="Actualiza el modo de activación">
      Cambia el modo de activación a tu configuración preferida (por ejemplo, activar para todas las reuniones, o solo para reuniones internas/externas) y guarda.
    </Step>
  </Steps>
</Accordion>

<Accordion title="El bot omite reuniones específicas pero no otras">
  Piper admite reglas de desactivación que impiden que el bot se una a reuniones que coincidan con ciertos criterios. Si el bot omite consistentemente una reunión particular o una categoría de reuniones, probablemente una regla de desactivación sea la responsable.

  <Steps>
    <Step title="Abre Settings → Recording → Bot Deactivation Rules">
      Navega a **Settings → Recording** y desplázate hasta la sección **Bot Deactivation Rules**.
    </Step>

    <Step title="Revisa las reglas activas">
      Busca reglas que coincidan con:

      * Una **palabra clave en el título de la reunión** (por ejemplo, "confidencial", "interno", "1:1").
      * Un **patrón de correo** que coincida con alguno de los asistentes (por ejemplo, todas las reuniones con un dominio específico).
    </Step>

    <Step title="Edita o elimina la regla">
      Actualiza o elimina la regla si está atrapando reuniones que quieres que Piper grabe.
    </Step>
  </Steps>

  <Note>
    Las reglas de desactivación son una función de privacidad deliberada. Si alguien de tu equipo las configuró intencionalmente, consulta con tu Piper Admin antes de eliminarlas.
  </Note>
</Accordion>

<Accordion title="¿Cómo personalizo el nombre del bot o su mensaje de conexión?">
  Cuando el bot se une a una reunión, envía un mensaje de conexión a todos los participantes para notificarles que la llamada está siendo grabada. Tanto el nombre de visualización del bot como el texto del mensaje son personalizables.

  <Steps>
    <Step title="Ve a Settings → Users">
      Navega a **Settings** y luego selecciona **Users**.
    </Step>

    <Step title="Actualiza el nombre del bot y el mensaje">
      Edita los campos **Bot display name** y **Connection message** según la redacción que prefieras. Por ejemplo, podrías usar el nombre de tu empresa como nombre de visualización y adaptar el mensaje a la redacción de consentimiento de tu equipo legal.
    </Step>

    <Step title="Guarda tus cambios">
      Los cambios se aplican a todas las futuras reuniones inmediatamente después de guardar.
    </Step>
  </Steps>

  <Tip>
    Por defecto, el bot aparece como **PiperAI** y envía este mensaje de consentimiento al unirse: *"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)"* Si tu organización opera en una jurisdicción con requisitos específicos de divulgación de consentimiento, actualiza el mensaje en consecuencia.
  </Tip>
</Accordion>

<Accordion title="¿Cómo verifico el estado actual del bot para una reunión?">
  Cada reunión en tu Home Page tiene una Activity Card que muestra el estado en tiempo real del bot. Los estados posibles son:

  | Estado                     | Significado                                                                                    |
  | -------------------------- | ---------------------------------------------------------------------------------------------- |
  | **Scheduled**              | El bot está preparado y se unirá automáticamente a la hora de inicio de la reunión             |
  | **Bot joining**            | El bot está en proceso de conectarse a la llamada                                              |
  | **Bot active / recording** | El bot se ha unido y está grabando activamente                                                 |
  | **Bot left**               | El bot ha dejado la llamada (la reunión terminó o se alcanzó un umbral de silencio prolongado) |
  | **Failed to join**         | El bot no pudo conectarse; un mensaje de diagnóstico explica el motivo                         |

  Si ves *Failed to join*, lee el mensaje de diagnóstico en la Activity Card para conocer la causa específica, y luego usa **Send Bot** para reintentar si la reunión sigue activa.
</Accordion>