Integraciones de la SPA
«Integraciones» reúne tres cosas de tu SPA: el estado de las integraciones de cada cliente, los webhooks que reciben los eventos de todos tus clientes y las integraciones propias de la SPA. Cuenta con las mismas reglas que la cola de trabajo de cada empresa, así que las cifras coinciden.
Estas guías se publican de momento en castellano. Dentro de la aplicación, la misma ayuda está en castellano, catalán, gallego, euskera, inglés y francés.
1. Qué hay en la pantalla
Arriba, el título «Integraciones» y el botón «Nuevo webhook». Debajo, tres pestañas: «Clientes», «Webhooks» y «Propias». «Clientes» abre con cuatro tarjetas de estado («Con errores», «Con avisos», «Correcto» y «Sin integraciones»), un buscador y una fila por cliente con «Cliente», «Estado», «Integraciones», «Sincronizaciones», «Webhooks» y «Claves API».
2. Ver qué clientes tienen problemas
«Con errores» cuenta los clientes con una integración en error o caducada, una sincronización fallida o una alerta abierta. «Con avisos» cuenta los que tienen un webhook con fallos, envíos fallidos o claves API caducadas o que caducan en 30 días. «Correcto» son los que tienen integraciones y ninguna falla; «Sin integraciones», los que todavía no han configurado nada. Una integración o una sincronización desactivada no cuenta como fallo.
Pulsa una tarjeta para filtrar la lista y púlsala otra vez para quitar el filtro. El buscador filtra por nombre de cliente. Los clientes con problemas salen primero y cada fila lista qué falla. El nombre abre la ficha de la empresa; el menú de la fila tiene “Abrir la empresa”.
3. Crear un webhook
1. Pulsa «Nuevo webhook».
2. Escribe el “Nombre” y la “URL de destino” (una dirección pública con https://), y elige los “Eventos”: “Todos los eventos” o los que necesites.
3. Pulsa “Crear webhook”.
4. Se abre “Secreto de firma”: cópialo con el botón de copiar y pulsa “Ya lo he copiado”. No vuelve a mostrarse; con él tu sistema comprueba que cada envío viene de goPrevina.
Cada webhook recibe los eventos de todos tus clientes con concierto vigente y cada envío indica la empresa de origen.
4. Vigilar y mantener los webhooks
En «Webhooks» hay tres tarjetas (“Con fallos”, “Inactivos” y “Correctos”) que filtran la lista, con las mismas reglas que la cola de trabajo de la empresa. Cada fila muestra la dirección, el estado, el “Último envío correcto” y los “Envíos fallidos”. Tras 5 fallos seguidos goPrevina desactiva el webhook por sí mismo: arregla tu sistema y vuelve a activarlo.
El menú de la fila tiene “Abrir”, “Editar”, “Enviar prueba”, “Reenviar eventos…”, “Activar” o “Desactivar” y “Eliminar” (pide confirmación). “Reenviar eventos…” abre un panel con “Desde” y “Hasta”: vuelve a enviar los eventos de ese periodo a los que el webhook está suscrito, como máximo 31 días; si no cambias nada, son las últimas 24 horas.
5. Integraciones propias de la SPA
En «Propias» se consultan el inicio de sesión único, DocuSign y Adobe Sign de la SPA, con su estado y la fecha de la última verificación. Una integración con error o caducada sale en rojo con el último mensaje de error.