Power Automate i Zapier

1. Què necessites

Una clau API de l'empresa. A «Administració» → “Sistema” → “Claus API”, prem “Crear una clau” amb un nom com “Power Automate” i, a “Permisos per recurs (API pública)”, marca el que necessiten els fluxos: per rebre els esdeveniments d'incidents, “Incidents” lectura; per crear treballadors, “Treballadors” escriptura. Un desencadenador només ofereix els esdeveniments que la clau pot llegir, i els d'aptitud mèdica necessiten el seu propi permís. Crea una clau per eina: així, revocar-ne una no atura les altres.

El connector de goPrevina per a Power Automate i l'app de Zapier estan pendents de publicació a cada botiga. Mentrestant, demana al suport de goPrevina el fitxer del connector de Power Automate o una invitació a l'app privada de Zapier. L'app de Make arribarà després del llançament.

2. Power Automate

1. A Power Automate, “Connectors personalitzats” → “Connector personalitzat nou” → “Importa un fitxer OpenAPI”, tria el fitxer de goPrevina i crea el connector (quan estigui publicat, cerca “goPrevina” en lloc d'això).

2. La primera vegada que l'usis, enganxa la clau API.

3. Desencadenadors: “When an incident is recorded”, “When a training certificate is about to expire”, “When a worker is added” i d'altres, a més de “When an event occurs”, en què tries qualsevol esdeveniment de la llista.

4. Accions: crear i actualitzar treballadors, centres i mesures preventives, registrar incidents, assignar cursos i llegir totes les llistes (incidents, mesures, avaluacions, certificats, documents, contractistes).

Els noms del connector estan en anglès. En desar un flux amb un desencadenador de goPrevina, Power Automate se subscriu a l'esdeveniment; en apagar o esborrar el flux, treu la subscripció.

3. Zapier

A Zapier, afegeix l'app goPrevina i connecta-la amb la clau API; deixa “API Address” com està llevat que la teva empresa tingui la seva pròpia instal·lació de goPrevina. Els desencadenadors com “New Incident” o “Training Certificate Expiring” se subscriuen en encendre el Zap i es donen de baixa en apagar-lo.

4. Exemple: incident → Teams i una llista de SharePoint

1. Crea a SharePoint una llista “Incidents” amb les columnes Títol, Gravetat, Data i Id de goPrevina.

2. A Power Automate, crea un flux automatitzat amb el desencadenador “When an incident is recorded”.

3. Afegeix “Publica un missatge en un xat o canal” (Microsoft Teams), tria el canal de prevenció i escriu el missatge amb el contingut dinàmic: títol, gravetat i data.

4. Afegeix “Crea un element” (SharePoint) sobre la llista “Incidents” i assigna Títol, Gravetat, Data i Id.

5. Desa, registra un incident de prova a goPrevina i comprova que el missatge i la fila apareixen en menys d'un minut.

5. Exemple: alta a Excel → treballador

1. Porta les altes en una taula d'Excel a OneDrive o SharePoint amb les columnes Nom, Email, Lloc i Data d'alta.

2. A Zapier, fes servir el desencadenador “New Row” de Microsoft Excel sobre aquesta taula.

3. Afegeix l'acció “Create Worker” de goPrevina i assigna Full Name, Email, Position i Hire Date.

4. A “Idempotency Key”, assigna l'id de la fila: si el Zap es torna a executar amb la mateixa fila, goPrevina retorna el treballador que ja va crear en lloc d'afegir-ne un altre.

La clau necessita “Treballadors” escriptura.

6. Exemple: certificat a punt de caducar → tasca d'Outlook

1. A Power Automate, fes servir el desencadenador “When a training certificate is about to expire”. goPrevina l'envia 30 dies abans de la data de caducitat.

2. Afegeix “Get a worker” amb l'id del treballador de l'esdeveniment (employeeId) per tenir el nom.

3. Afegeix “Afegeix una tasca pendent” de Microsoft To Do, les tasques del qual mostra Outlook, amb el títol “Renovar certificat” seguit del número de certificat i el nom del treballador, i com a venciment la data de caducitat de l'esdeveniment (expiresAt).

La clau necessita “Formació” lectura i “Treballadors” lectura.

7. On són les subscripcions i com aturar-les

Cada desencadenador en ús apareix a “Webhooks” amb el nom de l'eina i el seu historial d'enviaments. Apagar el flux, el Zap o l'escenari treu la seva subscripció. Revocar la clau API treu totes les subscripcions fetes amb ella i atura els enviaments a l'instant. goPrevina signa cada esdeveniment amb la capçalera X-Goprevina-Signature i el secret retornat en subscriure's; un sistema propi la pot comprovar com explica la guia de webhooks.