Integraciones
Salud y monitoreo
formbase 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.
Renovación proactiva de tokens
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, formbase lo renueva automáticamente — no necesitas hacer nada.
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.
Si una renovación falla — por ejemplo porque la conexión fue revocada del lado del proveedor — formbase 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.
Estados de salud
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 Activo, En pausa, o Error de entrega; el banner es más específico.
| Qué ves | Qué significa | Qué hacer |
|---|---|---|
| Activo | Funciona con normalidad. Las respuestas se entregan a medida que llegan. | Nada — todo está en orden. |
| En pausa | La pausaste tú, o formbase la pausó tras 5 fallos seguidos. | Soluciona la causa y luego pulsa Reanudar. La entrega retoma desde el siguiente envío nuevo. |
| Conexión expirada | El token OAuth no pudo renovarse. Esto tiene prioridad sobre cualquier error de entrega. | Pulsa Reconectar en la tarjeta de integración o en el panel de detalle. |
| Acceso perdido al destino | La cuenta conectada ya no puede escribir ahí. | Vuelve a compartir el destino con esa cuenta, o reconecta con una que tenga acceso. |
| Destino no encontrado | La hoja de cálculo, base de datos o canal ya no existe. | Elimina la integración y crea una nueva. Los destinos de Sheets, Notion, Airtable, Slack y Discord quedan fijos al configurarse; un equipo de Linear o un repositorio de GitHub se pueden cambiar sin recrear la integración. |
| Entrega fallida | Las entregas recientes fallaron por un motivo inesperado. | Revisa el registro de eventos en el panel de detalle para ver el mensaje de error. |
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.
Indicadores de error
Cuando algo falla, formbase lo muestra en dos lugares:
Tarjeta de integración — 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 Reconectar directamente en la tarjeta.
Panel de detalle — abre la integración para ver un banner que indica qué ocurrió y cómo solucionarlo.
Pausa automática tras fallos repetidos
Si una integración falla 5 veces seguidas, formbase 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.
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.
Soluciona el problema de fondo y luego pulsa Reanudar. La entrega retoma desde el siguiente envío nuevo.
Registro de eventos
Cada integración lista sus últimos 20 eventos en Eventos recientes — 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 Reintentar que reinicia la exportación.
Entregas fallidas y reintentos
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 Retry-After. formbase 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.
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”. Reintentar todo 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.
Los destinos de Analytics son independientes
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 Streaming de analíticas.
Reconectar una credencial expirada
Cuando una conexión expira, haz clic en Reconectar 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.
También puedes cambiar a una cuenta conectada diferente desde el panel de detalle si la cuenta original ya no está disponible.
Preguntas frecuentes
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.
No. Las respuestas siempre se guardan en formbase 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.
formbase 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.
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.