# Cuentas conectadas

> Cómo darle a Orkan acceso a tus servicios (Gmail, Stripe, WhatsApp…), cómo se guardan las claves y cómo compartirlas con tu equipo.

Una **cuenta conectada** es la clave o el permiso que le das a Orkan para usar un servicio en tu nombre: tu Gmail, tu tienda de WooCommerce, tu bot de Telegram… Los pasos de tus automatizaciones eligen qué cuenta usar.

Las claves se guardan **cifradas** y **no se vuelven a mostrar**: después de guardarlas solo verás su huella, que sirve para reconocerlas.

## Conectar una cuenta

Hay dos caminos:

-   **Desde el menú:** entra en **Cuentas conectadas** y pulsa **Conectar una cuenta**. Elige el servicio (busca «Gmail», «Stripe»…), rellena los datos y pulsa **Guardar**. Los servicios genéricos (clave de API, usuario y contraseña, base de datos…) están en **Otras (avanzado)**.
-   **Desde el paso:** si un paso necesita una cuenta que no tienes, pulsa **Conectar cuenta de {servicio}** en su panel. La cuenta queda ya elegida en ese paso.

Cada formulario trae **¿Dónde la consigo?**, con el camino exacto para sacar la clave de ese servicio. En la wiki lo tienes por servicio en las [integraciones](https://wiki.itsorkan.com/integraciones/): ahí está también qué permisos hay que dar.

Al terminar, Orkan comprueba que la cuenta funciona («Funciona: Orkan ha podido entrar en…»). Puedes repetirlo cuando quieras con **Probar**, en el menú de la cuenta.

## Gestionar tus cuentas

En el menú de cada cuenta:

-   **Cambiar datos**: las claves guardadas no se muestran. Deja vacío un campo de clave para mantener la que ya tiene.
-   **Probar**: comprueba que sigue funcionando.
-   **Volver a conectar**: renueva el permiso de las cuentas que se conectan dando permiso en el servicio.
-   **Compartir**: mira [más abajo](#compartir-una-cuenta).
-   **Desconectar**: Orkan deja de tener permiso, pero la cuenta se queda. Las automatizaciones que la usen fallarán hasta que la vuelvas a conectar.
-   **Eliminar**: borra la cuenta con sus claves. No se puede deshacer.

> **No se puede eliminar una cuenta que se está usando**
>
> No se puede eliminar una cuenta que se está usando
> 
> Si una automatización **activa** usa la cuenta, Orkan no te deja eliminarla: «No se puede eliminar: una automatización activa la está usando». Pausa o cambia esa automatización antes.

## Google, Microsoft y Salesforce

Estos tres servicios no usan una clave que copias: se conectan **dando permiso en el propio servicio** (OAuth). Pulsas **Conectar con Google** (o Microsoft 365, o Salesforce), se abre el servicio, aceptas, y al volver la cuenta queda conectada. Puedes quitar el permiso cuando quieras.

> **Hoy hace falta un cliente OAuth propio**
>
> Hoy hace falta un cliente OAuth propio
> 
> Para que este permiso funcione, **tu Orkan necesita tener configurado su propio cliente OAuth** de ese servicio, que se registra en la consola de desarrolladores de Google, de Microsoft o de Salesforce. **En la nube dedicada todavía no viene ninguno configurado.** Hasta entonces el servicio aparece como «Todavía no está disponible en tu Orkan» y la cuenta no se puede conectar así.
> 
> Si necesitas conectar uno de estos servicios, [escríbenos a contact@gnevoo.es](mailto:contact@gnevoo.es). Quien administra un Orkan en sus propios servidores puede configurarlo; mira [instalarlo en tus servidores](https://wiki.itsorkan.com/administrar/self-host/).

El resto de servicios (Telegram, Stripe, WooCommerce, WhatsApp, Slack, Notion, OpenAI…) se conectan con una clave o un token y no tienen esta limitación. Mira las [integraciones](https://wiki.itsorkan.com/integraciones/) para ver cómo sacar cada una: [Google](https://wiki.itsorkan.com/integraciones/google/), [Microsoft](https://wiki.itsorkan.com/integraciones/microsoft/) y [CRM](https://wiki.itsorkan.com/integraciones/crm/) (Salesforce).

## Quién puede conectar cuentas

-   **Propietarios y administradores** siempre pueden.
-   **Editores**: solo si la organización lo permite. Es el permiso «Los editores pueden conectar cuentas» en **Personas y accesos › Permisos de los editores**. Si no lo tienen, verás «Las cuentas las conecta quien administra tu organización» y tendrás que pedírselo. Mira [personas y roles](https://wiki.itsorkan.com/usar/personas-y-roles/).
-   **Lectores** no pueden.

## Compartir una cuenta

Por defecto, una cuenta la usan las automatizaciones de quien la conectó. Para que otras personas de tu organización la usen, pulsa **Compartir** en el menú de la cuenta, elige a la persona y marca qué puede hacer:

-   **Puede usarla en sus automatizaciones**,
-   **Puede verla**.

**Dejar de compartir** retira el acceso. Los cambios quedan registrados en la actividad de la organización. En las opciones avanzadas también se puede compartir con una cuenta de servicio o con un rol.

## Si una cuenta falla

-   **Falta conectar** o **Volver a conectar**: la cuenta ha caducado o no se completó el permiso. Vuelve a conectarla.
-   «No ha funcionado… revisa que la clave esté bien copiada y que no haya caducado»: copia la clave de nuevo desde el servicio con **Cambiar datos**.
-   Las ejecuciones fallidas por una cuenta te lo dicen, con un botón **Conectar cuenta**. Mira [ejecuciones](https://wiki.itsorkan.com/usar/ejecuciones/).