Das Embed-Modul in Actimo kann verwendet werden, um eine Dashboard-URL direkt in die App einzubetten. Mit der Interpolation kannst du steuern, welche Daten dein Mitarbeiter in deinem Dashboard sieht.

Voraussetzung: Dashboard-Tool wie PowerBI, Targit oder andere, das auf einen Parameter in einer URL reagieren kann.

API Doc: https://app.swaggerhub.com/apis-docs/Actimo/Actimo

API-Schlüssel: Lass einen Admin deiner Plattform support@actimo.com kontaktieren oder wende dich an deinen Integrationsspezialisten.

Der beschriebene Fluss

Wenn der Fluss läuft, sollte er so funktionieren, wie auf dem Bild unten zu sehen ist.

Deine Url ruft die actimo api auf und verwendet die GUID, um die entsprechende Mitarbeiter-ID zu finden und die benötigten Daten anzuzeigen. Am Ende des Flusses rufst du die actimo api auf, um die GUID durch eine neue zu ersetzen und sicherzustellen, dass die Kombination sicher bleibt.

actimo vorbereiten

• Gehe zu Admin (Admin-Zugang erforderlich) und erstelle ein benutzerdefiniertes Feld namens "GUID". Beachte, dass du beim Aufrufen dieses Feldes die Feldbezeichnung finden musst. Es wird data1, data2, etc. sein. Du kannst das sehen, wenn du dir einen Kontakt in der Benutzeroberfläche ansiehst und die Registerkarte "Entwickler" geöffnet hast.

• Füge eine zufällige GUID manuell in der Benutzeroberfläche oder über unsere API zu deinem Testkontakt hinzu (siehe Aufrufe unten).

• Erstelle eine Nachricht in Actimo und füge ein Einbettungsmodul hinzu.

Die benötigten API-Aufrufe

Du musst diesen API-Aufruf jedes Mal durchführen, wenn ein Kontakt deine Url verwendet hat. Dadurch wird dein Dashboard davor geschützt, dass jemand die Kombination aus Mitarbeiter-ID und GUID für den Zugriff auf dein Dashboard wiederverwenden kann.

• Stelle eine PUT-Anfrage, um einen Mitarbeiter in Actimo (Kontakte) mit einer neuen GUID zu aktualisieren.

PUT: https://a.actimo.com/api/v1/contacts/"contact id"

Beachte bitte, dass die benutzerdefinierten Felder data1, data2 usw. heißen werden. Du kannst diese Namen auf der Registerkarte "Entwickler" in der Benutzeroberfläche sehen.

Füge dem Body die Nutzdaten hinzu, die du bei den Kontakten aktualisieren möchtest. Hier ist ein Beispiel, wie ich es mache.

Noch Fragen?

Fragen zur API kannst du einem unserer Integrationsspezialisten über support@actimo.com stellen. Wenn du bei Actimo an Bord bist, hast du bereits direkten Kontakt zu einem Spezialisten.

Bitte lass uns auch wissen, ob dies hilfreich war, indem du auf die Emoji's unten klickst oder uns ein Feedback über support@actimo.com schickst .