# Salud y monitoreo

Cómo Formstep monitorea las integraciones, renueva tokens y muestra errores.

## Salud y monitoreo

Formstep mantiene tus integraciones funcionando en segundo plano — renueva tokens antes de que expiren, las pausa cuando algo falla, y te muestra exactamente qué ocurrió para que puedas resolverlo rápido.

<h2 id="proactive-token-refresh">Renovación proactiva de tokens</h2>

<p>
  Un proceso diario en segundo plano revisa las conexiones OAuth de tu espacio de trabajo, incluido Cal.com. Si un token caduca en las
  próximas 24 horas, Formstep lo renueva automáticamente — no necesitas hacer nada.
</p>

<p>
  Esto aplica a Google, Slack, Linear, Airtable y Cal.com. Notion y GitHub emiten tokens que no caducan, así que se omiten. Los tokens de
  Discord caducan al cabo de unos 7 días y se renuevan bajo demanda justo antes de cada entrega, en lugar de con el proceso diario.
</p>

<p>
  Si una renovación falla — por ejemplo porque la conexión fue revocada del lado del proveedor — Formstep marca la conexión como caducada y
  pasa a estado de error todas las integraciones que la comparten. Verás una advertencia en cada integración afectada y recibirás un correo
  de notificación.
</p>

<h2 id="health-states">Estados de salud</h2>

<p>
  Cada tarjeta de integración lleva una insignia de estado, y al abrir la integración se muestra un banner que explica qué hacer. La
  insignia dice <strong>Activo</strong>, <strong>En pausa</strong>, o <strong>Error de entrega</strong>; el banner es más específico.
</p>

<p>
  Los problemas de conexión siempre tienen prioridad. Si un token caducó, reconectar arregla de una vez todas las integraciones que
  comparten esa cuenta — no hace falta atender cada una por separado.
</p>

<h2 id="error-indicators">Indicadores de error</h2>

<p>Cuando algo falla, Formstep lo muestra en dos lugares:</p>

<ul>
  <li>
    <strong>Tarjeta de integración</strong> — la tarjeta muestra una insignia de estado y un borde de color: naranja para un problema de
    conexión, rojo para un error de entrega. Cuando la conexión caduca, aparece un botón <strong>Reconectar</strong> directamente en la
    tarjeta.
  </li>
  <li>
    <strong>Panel de detalle</strong> — abre la integración para ver un banner que indica qué ocurrió y cómo solucionarlo.
  </li>
</ul>

<h2 id="auto-pause">Pausa automática tras fallos repetidos</h2>

<p>
  Si una integración falla 5 veces seguidas, Formstep la pausa para que un destino roto no siga consumiendo entregas. Un error de
  autenticación, de permisos o de "no encontrado" se salta el contador y detiene la integración de inmediato, porque reintentar no lo
  soluciona.
</p>

<p>
  En cualquier caso, se envía un correo a la persona que configuró la integración — o al propietario del espacio de trabajo cuando esa
  dirección no está disponible. Se envía como máximo una vez por integración cada 24 horas, así que un destino roto no puede inundar tu
  bandeja de entrada.
</p>

<p>Soluciona el problema de fondo y luego pulsa Reanudar. La entrega retoma desde el siguiente envío nuevo.</p>

<h2 id="event-log">Registro de eventos</h2>

<p>
  Cada integración lista sus últimos 20 eventos en <strong>Eventos recientes</strong> — entregas, pruebas de conexión y exportaciones de
  relleno, cada uno marcado como correcto o fallido. Una entrada fallida muestra el mensaje de error propio del destino, así que un error de
  validación de Notion se lee exactamente como lo redactó Notion. Un relleno fallido también recibe un botón <strong>Reintentar</strong> que
  reinicia la exportación.
</p>

<h2 id="failed-deliveries">Entregas fallidas y reintentos</h2>

<p>
  Cada entrega recibe hasta 5 intentos, esperando al menos 1, 2, 4 y 8 minutos entre ellos, o más tiempo cuando el destino lo pide mediante
  un encabezado <code>Retry-After</code>. Formstep busca reintentos pendientes cada 30 minutos, así que cada reintento puede llegar hasta
  media hora más tarde, y el último intento unas dos horas después del primero.
</p>

<p>
  Las respuestas que agotan los 5 intentos se cuentan en un banner en la parte superior de la integración: "3 respuestas fallaron en la
  entrega". <strong>Reintentar todo</strong> vuelve a encolar cada una de ellas y reactiva la integración si estaba pausada o en error. El
  banner se oculta cuando no hay ningún fallo.
</p>

> ℹ️ **Los destinos de Analytics son independientes**
> <p>
>     Todo lo de esta página trata sobre las integraciones de respuestas. El reenvío de eventos de Analytics es best-effort y nunca se
>     reintenta, y la transmisión de respuestas a Axiom se detiene por sí sola tras 20 fallos consecutivos. Consulta{' '}
>     <a href="/es/integrations/analytics-streaming">Streaming de analíticas</a>.
>   </p>

<h2 id="reconnecting">Reconectar una credencial expirada</h2>

<p>
  Cuando una conexión expira, haz clic en <strong>Reconectar</strong> en la tarjeta de integración o en el panel de detalle. Esto vuelve a
  ejecutar el flujo OAuth con el mismo proveedor. Una vez autorizada, la credencial se restaura y todas las integraciones que usan esa
  cuenta se reanudan automáticamente.
</p>

<p>También puedes cambiar a una cuenta conectada diferente desde el panel de detalle si la cuenta original ya no está disponible.</p>

<h2 id="faq">Preguntas frecuentes</h2>

  <p>
    Una vez al día. Los tokens que expiran en 24 horas se renuevan automáticamente. Si sospechas un problema antes, abre el panel de detalle
    de la integración — el estado de salud se actualiza en tiempo real según los resultados de entrega.
  </p>

  <p>
    No. Las respuestas siempre se guardan en Formstep independientemente del estado de la integración. Las entregas fallidas se ponen en
    cola y pueden reintentarse desde el panel de detalle una vez resuelto el problema.
  </p>

  <p>
    Formstep renueva los tokens de forma proactiva, así que en la mayoría de los casos no lo notarás. Si la renovación falla, recibes un
    correo de notificación de inmediato — normalmente antes de que el token expire realmente.
  </p>

  <p>
    La integración cambia a la nueva cuenta. Asegúrate de que la nueva cuenta tenga acceso al mismo destino (hoja de cálculo, base de datos,
    canal). Si el destino no existe en la nueva cuenta, tendrás que actualizar la configuración de la integración.
  </p>

<h2 id="next-steps">Próximos pasos</h2>
<div class="not-prose grid gap-3 sm:grid-cols-2">
  - [Google Sheets](/es/integrations/google-sheets) — Sincroniza respuestas automáticamente a una hoja de cálculo
  - [Slack](/es/integrations/slack) — Envía respuestas a un canal de Slack
  - [Webhooks](/es/integrations/webhooks) — Envía JSON firmado por POST a cualquier URL
  - [Notion](/es/integrations/notion) — Envía respuestas a una base de datos de Notion
</div>
