Integracions de la SPA

1. Què hi ha a la pantalla

A dalt, el títol «Integracions» i el botó «Nou webhook». A sota, tres pestanyes: «Clients», «Webhooks» i «Pròpies». «Clients» s'obre amb quatre targetes d'estat («Amb errors», «Amb avisos», «Correcte» i «Sense integracions»), un cercador i una fila per client amb «Client», «Estat», «Integracions», «Sincronitzacions», «Webhooks» i «Claus API».

2. Veure quins clients tenen problemes

«Amb errors» compta els clients amb una integració en error o caducada, una sincronització fallida o una alerta oberta. «Amb avisos» compta els que tenen un webhook amb fallades, enviaments fallits o claus API caducades o que caduquen en 30 dies. «Correcte» són els que tenen integracions i cap falla; «Sense integracions», els que encara no han configurat res. Una integració o una sincronització desactivada no compta com a fallada.

Prem una targeta per filtrar la llista i torna-la a prémer per treure el filtre. El cercador filtra pel nom del client. Els clients amb problemes surten primer i cada fila indica què falla. El nom obre la fitxa de l'empresa; el menú de la fila té “Obre l'empresa”.

3. Crear un webhook

1. Prem «Nou webhook».

2. Escriu el “Nom” i la “URL de destinació” (una adreça pública amb https://) i tria els “Esdeveniments”: “Tots els esdeveniments” o els que necessitis.

3. Prem “Crea el webhook”.

4. S'obre “Secret de signatura”: copia'l amb el botó de copiar i prem “Ja l'he copiat”. No es torna a mostrar; amb ell el teu sistema comprova que cada enviament ve de goPrevina.

Cada webhook rep els esdeveniments de tots els teus clients amb concert vigent i cada enviament indica l'empresa d'origen.

4. Vigilar i mantenir els webhooks

A «Webhooks» hi ha tres targetes (“Amb fallades”, “Inactius” i “Correctes”) que filtren la llista, amb les mateixes regles que la cua de treball de l'empresa. Cada fila mostra l'adreça, l'estat, l'“Últim enviament correcte” i els “Enviaments fallits”. Després de 5 fallades seguides goPrevina desactiva el webhook per ell mateix: arregla el teu sistema i torna'l a activar.

El menú de la fila té “Obre”, “Edita”, “Envia una prova”, “Reenvia esdeveniments…”, “Activa” o “Desactiva” i “Eliminar” (demana confirmació). “Reenvia esdeveniments…” obre un panell amb “Des de” i “Fins a”: torna a enviar els esdeveniments d'aquell període als quals el webhook està subscrit, com a màxim 31 dies; si no canvies res, són les últimes 24 hores.

5. Integracions pròpies de la SPA

A «Pròpies» es consulten l'inici de sessió únic, DocuSign i Adobe Sign de la SPA, amb el seu estat i la data de l'última verificació. Una integració amb error o caducada surt en vermell amb l'últim missatge d'error.