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.
Las capturas y grabaciones muestran la interfaz en inglés.
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 → Apps
Antes de empezar
Úsalo cuando:
- una aplicación dice Conectar, Conectando…, Reconectar o En revisión;
- 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.
En móvil, toca la fila del proveedor para abrir su diálogo de detalles antes de elegir Conectar. Las Apps de Agente están bajo Conecta tus herramientas; los proveedores de tienda están bajo Gestiona tu tienda. Para CJ, utiliza la guía de conexión del proveedor.
Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.
Identifica el proveedor y su estado actual antes de abrir la configuración. Los controles conectados existentes no son evidencia de una nueva autorización.
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. |
| En revisión | 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. |
Conectar o reparar una conexión
-
Abre Apps y encuentra la app.
-
Selecciona Conectar.
-
Proporciona solo los campos mostrados en el diálogo. Dependiendo de la app, 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 regresa a Apps.
-
Confirma que la tarjeta ahora muestra una insignia de conectado o los controles conectados del proveedor. Un diálogo cerrado o ventana del proveedor no es prueba de éxito.
-
Si la tarjeta muestra Reconectar o Continuar con la incorporación, selecciona esa acción y continúa con la conexión existente.
Desconectar solo cuando quieras eliminar el acceso
- Para eliminar la app, selecciona su control de desconexión, lee la confirmación y elige Desconectar o Confirmar solo cuando el impacto a nivel de espacio de trabajo sea aceptable.
- Vuelve a abrir Apps y confirma que la tarjeta regresó a su estado desconectado.
La grabación abre los formularios en blanco de Shippo, 4PX y Shopify, luego los cierra. No se ingresan credenciales y no se conecta ningún proveedor.
Los proveedores de tienda y las Apps de Agente son diferentes
Los proveedores bajo Gestiona tu tienda usan controles específicos del proveedor:
-
Correo usa un interruptor de encendido/apagado.
-
Stripe puede mostrar controles de incorporación, revisión, acción requerida, panel de control y desconexión.
-
Shippo, 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.
-
Que una ventana del proveedor se complete no garantiza que Runner haya recibido un resultado utilizable.
-
No desconectes un proveedor de envío, pago, correo o cumplimiento durante operaciones activas de la tienda sin verificar la advertencia y tus pedidos actuales.
-
Si una desconexión informa un error, actualiza e inspecciona el estado actual antes de intentar nuevamente. No asumas que el proveedor fue eliminado.