> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.aura.konceptservices.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.aura.konceptservices.com/_mcp/server.

# Solucionar problemas

> Diagnostica y resuelve los problemas mas comunes con las integraciones de tu agente en Aura.

## Estados de una integracion

Cada integracion tiene un estado que indica su situacion actual:

* **Borrador**: la integracion se ha creado pero aun no esta configurada.
* **Configurar**: la integracion necesita que completes su configuracion.
* **Probando**: la integracion esta en proceso de verificacion.
* **Activo**: todo funciona correctamente y la integracion esta operativa.
* **Pausado**: la integracion esta detenida temporalmente.
* **Error**: algo ha fallado y la integracion no funciona.
* **Desconectado**: la integracion ha perdido la conexion con el servicio externo.

## Probar la conexion

Antes de diagnosticar un problema, usa el boton **Probar conexion** en la configuracion de la integracion. Esta prueba verifica que Aura puede comunicarse correctamente con el servicio externo y te indica el resultado inmediatamente.

## Errores comunes y soluciones

#### Calendario o recurso no encontrado

**Que significa**: Aura no puede localizar el calendario o recurso configurado en el servicio externo.

**Solucion**: verifica que el ID del calendario que has configurado es correcto. Accede a la configuracion de la integracion y comprueba que el identificador coincide con el del servicio externo.

#### Autorizacion expirada

**Que significa**: el permiso que diste a Aura para acceder a tu cuenta ha caducado.

**Solucion**: reconecta tu cuenta. Ve a la configuracion de la integracion, pulsa en **Iniciar sesion** y vuelve a autorizar el acceso.

#### Acceso denegado

**Que significa**: la cuenta que usaste no tiene los permisos necesarios para acceder al recurso solicitado.

**Solucion**: verifica que la cuenta con la que te conectaste tiene permisos suficientes en el servicio externo. Si usas una cuenta de empresa, consulta con tu administrador.

#### Demasiadas solicitudes

**Que significa**: se han enviado demasiadas peticiones al servicio externo en poco tiempo y este ha bloqueado temporalmente las solicitudes.

**Solucion**: espera unos minutos e intenta de nuevo. Si ocurre con frecuencia, considera aumentar el intervalo de sincronizacion (por ejemplo, de 5 minutos a 15 minutos).

#### Token invalido o sin token de acceso

**Que significa**: las credenciales de acceso ya no son validas. Puede ocurrir si cambiaste la contrasena de tu cuenta o revocaste los permisos manualmente.

**Solucion**: reconecta tu cuenta desde la configuracion de la integracion. Pulsa en **Iniciar sesion** para renovar las credenciales.

#### Error de red

**Que significa**: no se pudo contactar con el servicio externo. Puede ser un problema temporal del proveedor.

**Solucion**: espera unos minutos e intenta de nuevo. Si el problema persiste, verifica que el servicio externo este funcionando correctamente desde su propia pagina web.

## Pausa automatica tras fallos repetidos

Aura incluye un mecanismo de proteccion que pausa automaticamente una integracion despues de varios fallos consecutivos. Piensa en ello como un "freno de seguridad": si la integracion falla repetidamente, Aura deja de intentarlo temporalmente para no sobrecargar el servicio externo.

Cuando esto ocurre, la integracion entra en estado de **Error**. Una vez resuelvas el problema subyacente (por ejemplo, renovando las credenciales), la integracion se reactivara automaticamente al verificar que la conexion funciona correctamente.

> **Tip**
>
> La solucion mas efectiva para la mayoria de los problemas de integracion es reconectar tu cuenta. Esto renueva todas las credenciales y suele resolver los errores de autorizacion, token invalido y acceso denegado de una sola vez.