Solución de problemas de Integración

Si una integración no se conecta, deja de funcionar o no puede completar una tarea, usa esta guía para revisar la conexión, el acceso a la cuenta y el recurso seleccionado.

Esta página cubre problemas comunes de conexión y autorización en Atoms. Para la configuración específica del servicio, las acciones compatibles o la configuración dentro de tu app, comienza con Connect and Manage Integracións y elige la guía de tu servicio.

Comienza con estas comprobaciones

1. Comprueba dónde ocurre el fallo. ¿El Agente no puede usar un servicio en Chat, o la función falla solo en tu app? Conectar un servicio para Chat no confirma por sí solo que tu app esté configurada correctamente. Para fallos solo en la app, consulta Connect and Manage Integracións.
2. Abre la integración. En el Chat de tu proyecto, abre el menú de opciones junto al campo de entrada del mensaje y luego elige Connectors → Add connectors. Busca y selecciona el servicio. Comprueba si está conectado o si todavía ofrece Connect. Algunos servicios abren su propia pantalla de administración.
3. Comprueba el acceso en el propio servicio. Confirma que la cuenta que querías conectar puede abrir el archivo, repositorio, calendario, propiedad u otro recurso exacto implicado.
4. Guarda el error antes de cambiar nada. Registra el mensaje exacto, la hora y la zona horaria, el proyecto o Chat afectado y el último intento exitoso. Oculta la información privada en las capturas de pantalla.

Abre las opciones de entrada de Chat, elige Connectors (1) y luego Add connectors (2) para explorar las integraciones disponibles.

También puedes administrar las conexiones disponibles en Settings → Connectors. Selecciona la integración que quieres revisar.

Mantén las credenciales en privado. Nunca pegues contraseñas, códigos de inicio de sesión, claves de API, tokens de acceso u otros secretos en Chat ni en una solicitud de soporte. Introduce las credenciales solo en el flujo de inicio de sesión del servicio o en el campo de configuración segura designado.

Encuentra tu problema

No puedes encontrar o iniciar una integración

1. Usa Add connectors para buscar en el catálogo. La lista más corta del menú de Chat no es el catálogo completo.
2. Si Atoms dice que la función está disponible solo dentro de un proyecto, abre el proyecto previsto e inténtalo allí.
3. Si un control está deshabilitado, lee su explicación. Si requiere un rol o permiso diferente, pide ayuda al propietario del proyecto o del espacio de trabajo. No desconectes otro servicio solo para saltarte una restricción.

Comprueba el resultado: Puedes abrir la pantalla de conexión o administración del servicio. Si sigue sin aparecer, consulta Connect and Manage Integracións o contacta con soporte para confirmar la disponibilidad. No asumas que un servicio faltante puede habilitarse mediante intentos repetidos de inicio de sesión.

La autorización no se completa

1. Selecciona Connect una vez y busca la ventana de inicio de sesión del servicio. Si tu navegador informa de una ventana emergente bloqueada, permite las ventanas emergentes para el sitio de Atoms y vuelve a intentarlo. En Chrome, sigue las instrucciones para permitir ventanas emergentes de un sitio específico; no necesitas habilitarlas para todos los sitios.
2. Elige la cuenta prevista y revisa el acceso solicitado. Completa el flujo de autorización del servicio antes de cerrar su ventana.
3. Si el servicio dice explícitamente que tu organización ha bloqueado la app o el acceso solicitado, guarda el mensaje y contacta con tu administrador. No eludas la política de tu organización.
4. Vuelve a Atoms y reabre la integración para comprobar su estado. Cerrar una ventana de inicio de sesión no confirma que la autorización se haya realizado correctamente.

Revisa el acceso solicitado antes de completar la autorización. Autorizar una cuenta no confirma por sí solo que el recurso previsto esté conectado.

Si la autorización incluye un selector de organización o espacio de trabajo, confirma la selección prevista y revisa los permisos solicitados.

Comprueba el resultado: La integración se muestra como conectada. En las pantallas de detalle del conector que usan el diseño estándar, Connect se reemplaza por Disconnect y Try it out. Otros servicios tienen sus propios diseños. Si todavía ofrece Connect o muestra un error, captura ese resultado y contacta con soporte después de un intento nuevo.

Está conectada la cuenta equivocada

Si la pantalla de administración de la integración muestra una cuenta, compárala con la cuenta que posee o puede acceder al recurso. No todos los conectores muestran la cuenta conectada, así que no uses solo el inicio de sesión actual del navegador como prueba de qué cuenta está usando Atoms.

Abre el recurso directamente en el servicio con la cuenta prevista. Si esa cuenta no puede acceder, pide primero acceso al propietario del recurso. Si la conexión usa la cuenta equivocada, sigue las instrucciones del servicio para cambiar de cuenta o vuelve a conectar de forma segura y elige explícitamente la cuenta correcta durante la autorización.

Comprueba el resultado: Una pequeña solicitud de lectura compatible devuelve el recurso previsto. Si todavía no puedes determinar qué cuenta está conectada, contacta con soporte en lugar de desconectar repetidamente.

La integración está conectada, pero el Agente no puede encontrar tus datos

1. Comprueba la conexión. Abre los detalles de la integración en Connectors y confirma que está conectada. Comprueba la cuenta o el recurso seleccionados cuando se muestren.
2. Comprueba el recurso exacto. Ábrelo directamente en el servicio con la cuenta prevista. Confirma su ubicación y permisos de acceso, incluida la organización, el espacio de trabajo, la carpeta o la propiedad correctos cuando corresponda.
3. Haz la solicitud específica. Nombra el servicio y proporciona el nombre exacto del recurso o el enlace cuando el conector lo admita. Pide primero una acción de lectura compatible, en lugar de buscar y cambiar varios recursos a la vez.

Por ejemplo, si el conector admite la lectura de documentos: “Usa [service] para leer [document name or link] y dime su título. No lo cambies.”

Comprueba el resultado: El Agente devuelve el recurso previsto. Si el acceso directo funciona pero el Agente todavía no puede leerlo, comprueba las capacidades compatibles del conector y el acceso concedido. Vuelve a conectar solo si hay evidencia de un problema de autorización.

El Agente puede leer datos, pero no puede cambiarlos

Una lectura correcta no confirma que el conector admita el cambio solicitado ni que tenga permiso para realizarlo.

1. Consulta Connect and Manage Integracións o la lista What you can do del conector, si se muestra. Confirma que la acción solicitada es compatible.
2. Comprueba si la cuenta conectada tiene permiso para realizar ese cambio en el recurso exacto. Pide al propietario del recurso o al administrador solo el acceso necesario.
3. Lee cualquier error o solicitud de confirmación. Si se requiere autorización adicional, sigue el flujo documentado del servicio. Volver a conectar no puede añadir una acción que el conector no admite.

Antes de volver a intentar una escritura: Inspecciona el destino para ver si el primer intento ya creó o cambió algo. Una respuesta fallida no basta para demostrar que no se produjo ningún cambio. No repitas un pago, mensaje, invitación o creación de registro hasta que conozcas el resultado anterior.

Comprueba el resultado: Un cambio compatible se realiza correctamente en un recurso de prueba apropiado, y lo confirmas directamente en el servicio. Para pagos u otros flujos de trabajo en producción, usa las instrucciones de prueba específicas del servicio en lugar de una transacción real.

Una conexión que antes funcionaba se ha detenido

Comprueba qué cambió desde la última solicitud exitosa: la cuenta, su acceso al recurso, la política de apps de la organización o la autorización de la conexión.

1. Vuelve a abrir la integración en Atoms y comprueba si sigue conectada.
2. Intenta abrir el recurso directamente en el servicio. Si se ha eliminado el acceso, resuélvelo con el propietario del recurso o el administrador.
3. Si el error dice que la autorización ha caducado, fue revocada o no es válida, sigue Reconnect safely. Si el error se refiere a una caída del servicio, un límite o una acción no compatible, aborda primero esa causa.

Comprueba el resultado: Una pequeña solicitud de lectura vuelve a funcionar. Si el mismo error persiste, guárdalo junto con la última hora exitosa y contacta con soporte.

Los resultados están desactualizados o una solicitud sigue fallando

1. Compara el resultado con el propio servicio. Confirma la cuenta, el recurso, el intervalo de fechas, los filtros y la zona horaria cuando corresponda. Pide al Agente que obtenga el valor actual en lugar de basarse en una respuesta anterior de la conversación.
2. Para un error explícito de tiempo de espera o servicio no disponible, consulta la página oficial de estado o ayuda del servicio. Si el error indica un tiempo para reintentar, espera hasta entonces; no envíes solicitudes repetidas mientras persistan el límite o la caída.
3. Guarda cualquier texto no enviado, actualiza Atoms y vuelve a comprobar el estado del conector. Actualizar la página no es lo mismo que volver a autorizar la cuenta.
4. Vuelve a intentar una pequeña solicitud de lectura. Antes de reintentar cualquier cosa que cambie datos externos, inspecciona el destino para ver el resultado anterior.

Comprueba el resultado: El resultado nuevo coincide con el recurso previsto en el servicio. Si sigue siendo incorrecto, envía a soporte los valores esperados y reales con marcas de tiempo. No asumas que todas las integraciones se actualizan con la misma frecuencia.

Volver a conectar de forma segura

Vuelve a conectar cuando la autorización no sea válida o cuando esté vinculada la cuenta equivocada, no como primer paso para cada solicitud fallida.

Antes de desconectar: Termina o pausa las tareas que dependen de la conexión, comprueba el resultado de cualquier escritura externa pendiente y asegúrate de que puedes volver a iniciar sesión con el acceso requerido. Desconectar hace que la conexión no esté disponible hasta que se conecte de nuevo. Consulta Connect and Manage Integracións para conocer cualquier efecto adicional; no asumas que desconectar revierte cambios anteriores ni cancela trabajo ya enviado.

1. Abre los detalles de conexión del servicio. Si tiene su propia pantalla de administración de cuentas, sigue las instrucciones de esa integración.
2. En la pantalla estándar de detalle del conector, selecciona Disconnect cuando estés listo y luego selecciona Connect. No asumas que habrá una confirmación adicional antes de la desconexión.
3. Elige la cuenta prevista y completa la autorización. Revisa los permisos solicitados.
4. Vuelve a Atoms y confirma el estado conectado.
5. Ejecuta la comprobación de recuperación a continuación antes de reanudar la tarea original.

Si vuelve el mismo error, deja de reconectar y contacta con soporte con el error y las comprobaciones ya realizadas.

Verifica que el problema esté resuelto

1. Solicita una acción compatible y de solo lectura sobre un recurso que puedas verificar directamente. Si usas Try it out, revisa el prompt sugerido antes de enviarlo.
2. Compara la respuesta con el propio servicio. Confirma el recurso correcto, el contexto de la cuenta y el resultado solicitado, no solo el indicador de conexión.
3. Si tu tarea requiere cambios, usa un recurso de prueba apropiado o el flujo de prueba documentado del servicio y verifica el resultado en el destino.

Comprueba el estado de la conexión y el recurso seleccionado. Un indicador de conexión por sí solo no confirma que los datos esperados estén disponibles o actualizados.

Confirma la organización y el proyecto, luego abre Dashboard para inspeccionar el recurso sin hacer cambios. Desconectar no forma parte de esta comprobación.

Si la comprobación se supera, reanuda tu tarea. Si Chat funciona pero la función sigue fallando dentro de tu app, consulta Connect and Manage Integracións o solución de problemas de compilación y vista previa. Comprueba el entorno en el que ocurre el fallo; una solicitud exitosa en Chat no demuestra que la app esté configurada correctamente.

Obtener ayuda

Si el problema persiste, usa Get support e incluye:

• El nombre de la integración y el correo electrónico de tu cuenta de Atoms.
• El proyecto o enlace de Chat afectado, y si el fallo ocurre en Chat o en tu app. Para una app, identifica el entorno afectado.
• La cuenta y el recurso del servicio previstos, usando solo identificadores no secretos necesarios para investigar.
• El error exacto, la fecha, la hora y la zona horaria; incluye la última hora exitosa si se conoce.
• Los pasos para reproducirlo, el resultado esperado, el resultado real y las comprobaciones ya intentadas.
• Tu navegador y dispositivo, además de capturas de pantalla censuradas o una grabación corta si resulta útil.

Para una escritura fallida, indica si el destino muestra un cambio completado, ningún cambio o un resultado desconocido. Elimina contraseñas, códigos de inicio de sesión, claves de API, tokens y datos privados no relacionados de todos los archivos adjuntos.