DocumentaciónAplicaciones e integraciones
Conectar, gestionar y reconectar una aplicación
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
- Abre Aplicaciones y encuentra la aplicación.
- Selecciona Conectar.
- 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.
- Completa el paso del proveedor, luego vuelve a Aplicaciones.
- 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.
- Si la tarjeta muestra Reconectar o Continuar incorporación, selecciona esa acción y continúa la conexión existente.
- 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.
- 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.