---
title: Conectar, gestionar y reconectar una aplicación
description: Comprende los estados de conexión de la aplicación de Runner y repara o elimina una conexión de forma segura.
---

Usa esta guía para llevar una aplicación a través de su ciclo de vida de conexión: inicia la conexión, confirma su estado real, repara la autorización cuando sea necesario y desconéctala de forma segura.

**Ruta de acceso:** **Proyecto → Aplicaciones**

## Antes de empezar

Úsalo cuando:

- una aplicación dice **Conectar**, **Conectando...**, **Reconectar** o **Revisión pendiente**;
- necesitas verificar si un flujo de proveedor anterior realmente terminó;
- una aplicación de agente necesita acceso a herramientas diferente; o
- tienes la intención de eliminar una conexión y necesitas entender la advertencia primero.

Necesitas acceso al proyecto y cualquier cuenta, credencial o aprobación solicitada por el proveedor externo. Algunas aplicaciones son condicionales y pueden no aparecer en cada espacio de trabajo.

## Lee la tarjeta antes de actuar

| Estado de tarjeta o control | Significado | Qué hacer |
| --- | --- | --- |
| Indicador de carga | Runner está verificando la conexión guardada. | Espera antes de seleccionar otra acción. |
| **Conectar** | Runner no tiene una conexión utilizable para esta aplicación. | Abre el diálogo de configuración o el flujo de autorización del proveedor. |
| **Conectando...** | Una solicitud de conexión está en progreso. | Termina el flujo del proveedor o espera a que Runner devuelva un resultado. |
| **Conectado** | Runner reconoce una conexión utilizable. | Usa su control de gestión o desconexión si necesitas un cambio. |
| **Gestionar** | La aplicación de agente conectada tiene herramientas configurables. | Abre los detalles de la aplicación y revisa el acceso a herramientas. |
| **Reconectar** | La autorización falta, ha expirado o de otra manera necesita atención. | Inicia la autorización de nuevo. No asumas que la conexión anterior aún funciona. |
| **Revisión pendiente** | Stripe tiene la cuenta pero no la ha hecho lista. | Sigue el estado o aviso de acción; la etiqueta no es un botón de Conectar. |
| **Continuar incorporación** | Stripe aún necesita información. | Continúa la configuración existente en lugar de crear otra cuenta. |
| Eliminar o **Desconectar** | Una conexión puede ser eliminada. | Lee y confirma el impacto específico del proveedor. |

## Completar el ciclo de vida

1. Abre **Aplicaciones** y encuentra la aplicación.
2. Selecciona **Conectar**.
3. Proporciona solo los campos mostrados en el diálogo. Dependiendo de la aplicación, esto puede ser un dominio de tienda, una clave API, una clave y secreto, credenciales del proveedor o autorización externa.
4. Completa el paso del proveedor, luego vuelve a Aplicaciones.
5. Confirma que la tarjeta ahora muestra una insignia conectada o los controles conectados del proveedor. Una ventana de diálogo o proveedor cerrada no es prueba de éxito.
6. Si la tarjeta muestra **Reconectar** o **Continuar incorporación**, selecciona esa acción y continúa la conexión existente.
7. Para eliminar la aplicación, selecciona su control de desconexión, lee la confirmación y elige **Desconectar** o **Confirmar** solo cuando el impacto indicado en todo el espacio de trabajo sea aceptable.
8. Reabre Aplicaciones y confirma que la tarjeta volvió a su estado desconectado.

## Las aplicaciones de tienda y las aplicaciones de agente difieren

Las aplicaciones de tienda usan controles específicos del proveedor:

- **Correo electrónico** usa un cambio de encendido/apagado.
- **Stripe** puede mostrar incorporación, revisión, acción requerida, panel de control y controles de desconexión.
- **Shippo**, **CJ Dropshipping**, **4PX** y **Shopify** solicitan datos de configuración específicos del proveedor y muestran una confirmación de desconexión destructiva.

## Seguridad de la conexión

- Trata las claves y secretos del proveedor como contraseñas.
- Lee si una conexión pertenece al espacio de trabajo o solo al proyecto actual.
- Una ventana del proveedor que se completa no garantiza que Runner haya recibido un resultado utilizable.
- No desconectes un proveedor de envío, pago, correo electrónico o cumplimiento durante operaciones activas de la tienda sin verificar la advertencia y tus pedidos actuales.
- Si una desconexión falla, Runner mantiene el estado actual. No asumas que el proveedor fue eliminado.

## Guías relacionadas

- [Descripción general de aplicaciones e integraciones](../apps-and-integrations)
- [Conectar y controlar aplicaciones de agente](./agent-apps)
- [Solucionar problemas de conexión de una aplicación](./troubleshooting)