Integrationen

Integrationen

Überblick Integrationen

In awork ist es ganz einfach einen Überblick über alle Integrationen, die du mit anderen Tools hergestellt hast, zu erhalten. Dazu gehst du einfach auf >Einstellungen< / >Integrationen<. Hier kannst du einfach Integrationen einrichten und testen.

Aktuell stehen dir folgende Integrationen zur Verfügung: 

In diesem Bereich findest du eine Liste aller aktiven Integrationen und kannst diese bearbeiten, löschen oder pausieren. Im Log findest du alle Einträge der letzten 20 Tage. Alle erfolgreichen Einträge sind grün, die nicht erfolgreichen rot (inkl. Anzeige des Fehlers).

Integrations_GER.jpg

 

 

Kalender-Integration einrichten

Du kannst Termine aus externen Kalendern in deine awork-Zeiterfassung integrieren. Dazu kannst du die Kalender-Integration im Modul >Meine erfassten Zeiten< nutzen. Wenn du noch keinen Kalender hinzugefügt hast findest du am rechten Bildschirmrand eine Leiste, die dich zur Integration führt. 

Calender_1_GER.jpg

 Du kannst Kalender dieser 3 Anbieter in awork integrieren:

  • Google
  • Microsoft (Outlook & Exchange)
  • iCloud

Wenn du einen Google- oder Microsoft-Kalender verbindest wirst du auf eine Seite weitergeleitet auf der du die Logindaten für den Kalender eingeben musst und diesen für awork freigibst. Du kannst natürlich auch mehrere Kalender hinzufügen.

Wenn du einen iCloud-Kalender nutzt, dann öffnet sich zunächst ein weiteres Fenster in awork. Hier trägst du deine Apple-Id ein. Im folgenden Schritt wechselst du zu https://appleid.apple.com/  und folgst den Anweisungen aus dem Pop-Up in awork: Navigiere in deinem Apple-ID-Management zum Punkt Sicherheit/Security und generiere dort ein neues App-Passwort. Bestätige zunächst, dass du die Schritte befolgt hast. Dann gibst du das Passwort in der Textzeile in awork ein. Nun steht der Intergration deines Kalenders nichts mehr im Weg.

Alternativ kannst du zum Hinzufügen von neuen oder zum Verwalten von schon integrierten Kalendern auch den Button rechts oben im Bild nutzen:

Calender_2_GER.jpg


Nun werden dir alle Termine aus allen integrierten Kalendern in awork angezeigt. Du kannst anhand der Symbole in den Terminen zwischen den verschiedenen Anbietern unterscheiden. Möchtest du aus einem Termin direkt eine Zeiterfassung machen, kannst du dies ganz komfortabel per Klick auf den Termin tun. Die Dauer ist automatisch die des Termins, du kannst sie aber anpassen.

Calender_GIF_GER.gif

Slack-Integration für awork einrichten

Du kannst awork mit deinem Slack verbinden und es somit integrieren. Hier kannst du für verschiedene Aktionen Nachrichten in bestimmten Slack-Channels ausgeben lassen. Eine Liste, bei welchen Aktionen eine Nachricht ausgelöst wird, findest du ganz unten.

Um die Integration einzubinden, gehst du auf >Einstellungen< / >Integrationen<. Hier kannst du auf den >Slack-Button< klicken.

Slack_GER.jpg

Anschließend wirst du zu Slack weitergeleitet. Hier musst du deinen Slack-Teamnamen eingeben, einen Channel oder eine Person auswählen und den Zugriff erlauben. Danach wirst du zurück in awork geleitet und musst dich einmal neu anmelden und den Workspace auswählen, das mit Slack verknüpft werden soll. 

Slack3.png

Screensho.png

In dem erscheinenden Pop-up-Fenster kannst dunun festlegen, bei welcher Aktion eine Nachricht in Slack erstellt werden soll. Diese Einstellungen gelten immer global in deinem awork-Workspace und kann nicht nur für bestimmte Projekte angewendet werden.

Screenshot_2.png 

Liste von Aktionen

  • Benutzer hinzugefügt
  • Benutzer gelöscht
  • Benutzer-Status geändert
  • Benutzer aktiviert/deaktiviert
  • Neues Projekt erstellt
  • Projekt gelöscht
  • Neue Aufgabe erstellt
  • Aufgabe gelöscht
  • Aufgaben-Status geändert
  • Unternehmen hinzugefügt
  • Unternehmens-Status geändert
  • Zeiterfassung hinzugefügt
  • Zeiterfassung gelöscht
  • Projekt-Kommentar hinzugefügt
  • Aufgaben-Kommentar hinzugefügt
  • Projektmitglied hinzugefügt
  • Projektmitglied gelöscht
  • Aufgabenzuweisung hinzugefügt
  • Aufgabenzuweisung gelöscht

Zapier-Integration einrichten

Über die Integration

Mit der Hilfe von Zapier kannst du awork mit einer Menge anderer Anwendungen verbinden, selbst ohne tiefgehende Programmierkenntnisse. 

Zapier funktioniert in zwei Richtungen: Du kannst Informationen aus awork beschaffen und sie in einer anderen Anwendung nutzen oder du nutzt Informationen einer anderen Anwendung und erstellst damit Instanzen in deinem awork. Wir bieten die folgenden Optionen: 

Informationen aus awork holen (Trigger)

  • Neue Aufgabe erstellt
  • Neue Zeit erfasst
  • Zeiteintrag aktualisiert

awork-Objekte erstellen (Action)

  • Erstelle ein neues Projekt
  • Erstelle ein neues Unternehmen
  • Erstelle eine neue Projekt-Aufgabe

Wie man Zapier einrichtet

 

Um deinen ersten Zap (ja, so nennt man das) zu erstellen, gehst du auf >Einstellungen< / >Integration< und klickst auf das Zapier-Logo (oder wählst einen vordefinierten Zap). 

Zapier_GER.jpg

Nun wirst du auf die Zapier-Homepage weitergeleitet. Hier kannst du nun eine App auswählen, die du mir awork verbinden willst (z. B. Slack).  

Screenshot_1.jpg

Nun werden dir häufig genutzte Optionen zu Verbindung angezeigt. Du hast aber auch die Möglichkeit einen Trigger (awork oder die andere App) auszuwählen und die Aktion im jeweiligen Pendent festzulegen. Wenn du auf >Connect< klickst kommst du zum nächsten Schritt.

Screnshot_2.jpg

Nun werden Trigger und ausgeführte Aktionen noch einmal zusammengefasst.

Screenshot_3.jpg

Nun musst du noch die gewählten Einstellungen in mehreren Schritten bestätigen. In unserem Beispiel wollen wir aus "Starred Messages" in Slack eine Aufgabe in awork anlegen. Du musst nun also festlegen welches Feld aus Slack den Namen der Aufgabe festlegt (1), welches Projekt in awork verwendet werden soll (2), welcher "Type of Work" in awork (3) und welcher Aufgabenstatus (4) genutzt werden soll. 

ACHTUNG: Die Eigenschaften die ausgewählt werden müssen, ändern sich natürlich je nach gewählter App und Aktion. 

Screenshot_4.jpg

Anschließend musst du einen Testlauf (Achtung die Daten werden bereits in dein awork-Workspace geschrieben) durchlaufen. Nun musst du den Zap nur noch speichern und aktivieren und die Verbindung ist aktiv. 

Client Applications

Wenn du für awork deine eigene Integration bauen möchtest, kannst du dir eine Client Application anlegen. Hierfür klickst du im Menü auf >Settings< und weiter auf >Integrationen<.

Besuche unsere Developer Resources Seite um mehr zu erfahren.

ClientsApplications-de.png

Webhooks

Du kannst in awork Webhooks verwenden. Dafür klickst du unter >Einstellungen< auf >Integrationen<. Hier findest du einen Webhooks-Button um neue Webhooks anzulegen.

Folgende Events in awork können Webhooks auslösen:

  • Aufgabe erstellt
  • Aufgabe gelöscht
  • Aufgabenstatus geändert
  • Datei gelöscht
  • Datei hinzugefügt
  • Kommentar zu Aufgabe hinzugefügt
  • Kommentar zu Projekt hinzugefügt
  • Kunden gelöscht
  • Kunden hinzugefügt
  • Projekt gelöscht
  • Projekt hinzugefügt
  • Projektstatus geändert
  • User-Aktivierung geändert
  • User gelöscht
  • User hinzugefügt
  • User vom Projekt entfernt
  • User von Aufgabe entfernt
  • User zu Aufgabe zugewiesen
  • User zum Projekt hinzugefügt
  • User-Status geändert
  • Zeiterfassungseintrag gelöscht
  • Zeiterfassungseintrag hinzugefügt