Solucionar problemas de conexión de aplicaciones

Diagnostica problemas de carga, credenciales, autorización, revisión, reconexión y desconexión en Aplicaciones.

Usa esta guía cuando una aplicación no carga, se conecta, se reconecta, guarda su acceso a herramientas o se desconecta como se esperaba. Comienza desde el estado que Runner realmente muestra en lugar de repetir un flujo de proveedor ciegamente.

Ruta de acceso: Proyecto → Aplicaciones

Antes de comenzar

Confirma que abriste Aplicaciones para el proyecto y espacio de trabajo previstos.
Borra Buscar aplicaciones y cualquier filtro de categoría de Aplicaciones de Agente.
Actualiza la página una vez y espera a que se carguen los estados de conexión.
Lee el estado exacto de la tarjeta: Conectar, Conectando..., Conectado, Reconectar, Revisión pendiente o un aviso de acción requerida.
Abre solo la acción de recuperación que coincida con ese estado.
Nunca incluyas una clave API, secreto, documento de identidad, detalle de pago o URL de devolución de llamada completa del proveedor en un mensaje de soporte o captura de pantalla.

Controles y resultados importantes

Control	Qué sucede después de seleccionarlo
Borrar búsqueda	Elimina la búsqueda actual de Aplicaciones de Agente para que el catálogo disponible pueda aparecer de nuevo.
Conectar / Conectar y autorizar	Abre el flujo de configuración o autorización externa para esa aplicación.
Reconectar, cuando se muestra	Reinicia la autorización para una conexión de proveedor existente.
Reintentar	Repite la solicitud fallida de catálogo, lista de herramientas o conexión mostrada por el panel actual.
Continuar incorporación	Vuelve al flujo de incorporación de Stripe existente cuando se requiere acción.
Desconectar	Abre una confirmación o inicia el flujo de eliminación documentado; verifica el estado guardado antes de cambiar las credenciales del lado del proveedor.

Tabla de síntoma y recuperación

Lo que ves	Significado probable	Acción segura siguiente
La aplicación falta	La búsqueda, una categoría, el acceso al espacio de trabajo o una característica condicional la está ocultando.	Borra la búsqueda, elige Todas, luego confirma que la característica está disponible para este espacio de trabajo.
La tarjeta sigue cargando	Runner no ha resuelto la conexión guardada.	Actualiza Aplicaciones una vez. Evita enviar otra conexión mientras el estado es desconocido.
No se encontraron aplicaciones	Ninguna Aplicación de Agente coincide con los filtros actuales.	Selecciona Borrar búsqueda.
Conectar no hace nada	Un campo requerido está vacío o es inválido, o el flujo del proveedor no pudo iniciarse.	Lee los errores de campo, vuelve a copiar el valor requerido y permite ventanas emergentes del proveedor cuando sea aplicable.
Conectando... no termina	La autorización externa fue cerrada, bloqueada o nunca devolvió un resultado.	Vuelve a Aplicaciones, actualiza el estado, luego usa Reconectar si Runner lo ofrece.
El proveedor dice éxito pero Runner no	Runner no ha confirmado una conexión utilizable.	Reabre Aplicaciones. Trata solo Conectado como éxito; usa Reconectar en lugar de crear duplicados.
Reconectar	La autorización existente necesita atención.	Selecciónalo y completa el flujo del proveedor de nuevo.
Revisión pendiente	Stripe está revisando los detalles enviados.	Sigue los avisos de acción; no inicies otra cuenta simplemente para eliminar la etiqueta.
Se requieren acciones de Stripe	Stripe necesita información o ha pausado una capacidad.	Revisa los detalles de Vencimiento ahora, Vencimiento después, En revisión, pago y transferencia, luego usa Continuar incorporación cuando se muestre.
Clave API o secreto rechazado	El valor es incorrecto, expirado, de la cuenta equivocada o no aceptado para esta integración.	Vuelve a copiarlo del proveedor. No edites secretos por conjetura.
Dominio de Shopify inválido	El valor no es el dominio permanente de la tienda Shopify.	Usa `your-store.myshopify.com`, no un dominio de escaparate personalizado.
La ventana de autorización de Aplicación de Agente está bloqueada	El navegador impidió el flujo externo.	Permite ventanas emergentes para Runner e inicia Conectar y autorizar de nuevo.
Las herramientas de Aplicación de Agente no se cargan	Runner no pudo recuperar la lista de herramientas de esa aplicación.	Selecciona Reintentar en Detalles de la aplicación.
El cambio de herramienta reporta falla	La nueva configuración de herramienta no fue guardada.	Espera a que el cambio se actualice, confirma su estado actual, luego reintenta una vez.
La desconexión reporta falla	Runner no confirmó la eliminación.	Asume que la conexión existente sigue activa y reabre Aplicaciones antes de intentar de nuevo.

Verificaciones específicas del proveedor

Stripe

Continúa un intento de incorporación existente con Reconectar o Continuar incorporación.
Lee los requisitos de acción en lugar de confiar solo en el color de la tarjeta.
Un escaparate publicado aún puede tener pagos pausados o no disponibles.
Usa la acción del panel de Stripe solo después de que Runner tenga una cuenta asociada.

Correo electrónico

Un cambio de cambio fallido vuelve al estado guardado.
Un cambio habilitado no prueba que un correo electrónico particular fue entregado.
Verifica el evento de tienda, destinatario, configuración de correo electrónico y versión publicada actualmente con datos de prueba seguros.

Shippo

Vuelve a copiar la clave API de Shippo de la cuenta prevista.
Una tarjeta conectada no verifica tarifas, transportistas, etiquetas o creación de envíos.

Shopify

Usa el dominio permanente myshopify.com.
Si un espacio de trabajo ya tiene una tienda conectada, revísala antes de desconectar.
Reinicia la autorización cuando el enlace de conexión expire o la tienda devuelta no coincida con el dominio que ingresaste.

CJ Dropshipping

Confirma que la clave API pertenece a la cuenta de CJ que pretendes usar.
Después de desconectar, Runner vuelve a la cuenta compartida de CJ, así que verifica el contexto de la cuenta antes de futuras acciones de proveedor.

4PX

Confirma que la clave API y el secreto pertenecen a la misma cuenta y están en los campos correctos.
Una tarjeta conectada no prueba que un destino u orden sea elegible para cumplimiento.

Aplicaciones de Agente

La sección completa o una aplicación individual puede estar condicionalmente no disponible.
Borra filtros antes de tratar una aplicación como ausente.
Revisa los cambios de herramienta antes de reconectar; no otorgues más acceso simplemente para facilitar la configuración.

La desconexión falló o produjo un resultado incierto

Mantén la cuenta del proveedor y las operaciones actuales de la tienda sin cambios.
Reabre Proyecto → Aplicaciones y verifica el estado de la tarjeta.
Si aún muestra conectado, trata la conexión como activa.
No elimines credenciales del lado del proveedor hasta que entiendas si el pago en vivo activo, correo electrónico, envío, proveedor o trabajo de cumplimiento aún depende de ellas.
Reintenta la desconexión de Runner solo después de que el estado sea claro.

Pide ayuda de forma segura

Proporciona:

el nombre de la aplicación;
el estado visible exacto y el texto de error;
si el problema ocurre mientras se conecta, se devuelve, se administran herramientas o se desconecta;
la URL del proyecto sin valores de consulta secretos; y
una captura de pantalla segura para la privacidad si muestra materialmente el problema.

No proporciones la clave API real, secreto, contraseña del proveedor, documento de identidad, detalles de pago, datos del cliente o parámetros de autorización ocultos.