Integrations

Intergrations overview

In awork it's very easy to keep track of all your integrations with our tool. Just browse to "Settings" and "Integrations". On this page you can create and test your integrations.

Right now awork offers the following integrations:

You will find a list of all your integrations in this section. You can edit, pause or delete them via the action button. There is also the possibility to access the log of an integration. The log shows the actions from the last 20 days. Every successful integration will be marked green und the unsuccessful ones red (showing the reason for the error).

Integrations_ENG.jpg

Configure Calendar integration

The calendar integration in the "My Time Tracking" section enables you to see all your appointments from you usual calendar tools while working in awork. To activate it, go to "My Time Tracking" and click the button shown on the right.

Calender_1_ENG.jpg

When adding a new calendar you can select between three providers for your calendar

  • Google
  • Microsoft (Outlook & Exchange)
  • iCloud

When connecting a Google or Microsoft calendar, you will be guided to a new page where you can enter your normal login-data. After enabling awork to access your account, you will be redirected to awork. If you have multiple calendars in your account, you can choose to either integrate all of them or only a selection. Afterwards you can instantly view your appointments in your time tracking grid.

If you are using an iCloud-calendar, you will have to enter your Apple-ID in awork. Then go to https://appleid.apple.com/ and follow the instructions in the awork window: Navigate to Security and generate a new app-password. Enter said password in awork after confirming you have followed the steps and you can connect your iCloud-calendar.

As an alternative way to integrate a new calendar in awork, or even to manage existing calendars, you can use the calendar-button on the top right.

Calender_2_ENG.jpg

Now you will see the appointments from all the integrated calendars. The symbol of each appointment tells you, which calendar/provider the entry is from. You can create a time tracking for those appointments by simply clicking on them. The duration of the trackings will automatically equal the duration of the appointment.

Calender_GIF_ENG.gif

Tipp: awork does not support self-hosted exchange servers.

Configure Slack integration

You can connect awork and Slack, so that your activities from awork will be postet to Slack. Furthermore, you can work on awork projects from within slack, e.g. create new tasks, edit existing tasks and much more.

Set up Slack Integration

To create the integration go to Settings/Integrations and click on the slack logo.

Now you will be forwarded to Slack and will be asked to enter your team name and allow awork access to your Slack-Team. Afterward, you will be forwarded to awork and need to log in to the workspace that should be linked to slack. 

Connect_Slack_V2_ENG.gif

Now every user that wants to actively use the integration needs to link his/her awork and Slack accounts. Users that just want to see messages in a channel don't need to do this. Every user will be asked to link the account when they have their first interaction with the integration. Alternatively, you can use the command "/connect" to link your accounts.

Tip: The language of messages from the integration is the one the user that created the integration has set in awork. Private notifications will be in the current users' awork language. 

ConnectAccount_ENG.gif

Link an awork project with Slack

A project can be linked to a Slack channel from the project details. Just click the three dots and select Link to Slack. Now awork asks you to select the channel and all actions that should trigger a message in Slack. 

You can just link one project per Slack channel.

Link_Project_ENG.gif

Edit tasks in Slack

When a new task is created in awork it will be posted to the linked Slack channel. Now you can work with that task in Slack. You can do the following things:

  • Change task status
  • (Re-)assign a user
  • Set a deadline
  • Comment on the task

CreateTask_ENG.gif

Create tasks/time tracking entries from Slack

The awork Slack integration allows you to work in awork directly from slack. You can use the following "/" commands (The content between [ ] is the name of awork entities you want to use or create):

  • /add [task] - Creates a new task in awork
  • /comment [task]:[Text] - Creates a new comment on a task
  • /connect - Link Slack account with awork account
  • /disconnect - Delete link between Slack und awork account
  • /link [project] - Link an awork project to a Slack channel
  • /start [task/project] - Start time tracking for a task/project
  • /stop - Stop time tracking
  • /unlink - Delete link between awork project and Slack channel

E.g. you can simply type "/add Design new logo" in Slack. This will create the task "Design new logo" in your linked awork project.

Slash_CreateTask_ENG.gif

awork BOT/Show awork notifications in Slack

If you have linked your Slack account to your awork account you will find awork as an app in slack. In this "channel" you will see all your notifications if you choose to show them in slack.

You can also use all "/" commands. E.g. you can create private tasks or start a timer. 

Priv_Not_2_ENG.gif

Configure Zapier integration

About the integration

Zapier is a great tool to connect awork with a lot different tools, even without deep programming knowledge. 

Zapier works in two directions: You can get information out of awork and post it into another tool or you can take information of a tool and create an entity within awork We offer the following options

Get information out of awork (Trigger)

  • New task created
  • New time tracked
  • Tracked time updated

Create awork entities (Action)

  • Create a new project
  • Create a new project-task
  • Create a new client

How to set it up

 

To create your first Zap (yes, it's called that way) navigate to "Settings" / "Integrations" and click of the Zapier button (or choose to add a predefined snap by us). 

Zapier_GER.jpg

You will be forwarded to the Zapier homepage. Here you can choose the app that you want to connect with awork (e.g. Slack).

Screenshot_1.jpg

Now you have the option to choose a commonly used connection or select a trigger and action in either app. 

Screnshot_2.jpg

Zapier will show you a short summary of your selections.

Screenshot_3.jpg

Zapier will lead you through some steps where you need to confirm the selected settings. Our example should create a awork task when a slack message gets starred. 

So after a few screens you need to select which slack field will be the name of the awork task (1), select the awork project (2), Type of Work (3) and Task Stastus (4). 

ATTENTION: The options you need to set depend on the app and trigger you selected.

Screenshot_4.jpg

Now Zapier will ask you to run a test zap (the data of this test will show up in your awork workspace). Afterwards you are done, save you zap and set the connection to active. 

Zapier Integration with Webhooks

If you want to get information from awork that is not in our standard zapier integration, you can use webhooks.

Go to zapier.com and select "Webhooks" as a trigger.

 

Zapier_1_GER.png

Select the option "Catch Hook".

Zapier_2_GER.png

Copy the url on the next screen into an awork webhook. More information about how to do that here.

Zapier_3_GER.png

Now you need to add a filter where you can decide details on the information that should trigger the zap, e.g. the task status. Now just continue as described above. 

Zapier_5_GER.png

Google Assistant (awork Voice)

awork voice  is the skill from awork for the Google Assistant. With awork voice you can use awork via voice commands.

To do that you need to activate the awork voice skill in your Google Assistant account. 

Afterwards you can use the skill in Google Assistant and on the Google Home devices. 

What can I do with awork voice?

Even though awork voice is still in it's infancy, you can perform many helpful actions:

Create new task

"Ok Google, talk to awork voice. Create a new task: Prepare presentation"

Now you will have a new private tasks "Prepare presentation". At the moment awork voice only supports private task, because there are still some challenges to match task to projects via voice. 

After you create a task, awork voice will ask you to set a deadline. You can simply answer something like "tomorrow", "Monday" or "Next week".

Start and stop time trackings
"Ok Google, talk to awork voice. Start a timer."

"Ok Google, talk to awork voice. Stop the timer."

awork voice will ask you if you want to work on the same task, if your last time tracking was connected to as task. 

If there is already a timer running, awork voice will ask if you want to stop the timer to start a new one or if your comment should be ignored. 

Recommend a task

"Ok Google, talk to awork voice. Is there anything to do?"

 awork voice will recommend your most urgent task to you. If you want to work on another task just say "next" or "Give me another task". 

If you say "Start timer" you start tracking time for that task.

Ask for due tasks

"Ok Google, talk to awork voice. Are there any due tasks till Monday?"

awork voice will tell you the amount of tasks you have to finish till Monday.

 Check for new notifications

"Ok Google, talk to awork voice. Are there any new notifications?"

awork voice will tell you if you have any new notifications.

Set up awork voice

The setup of awork voice does not work with a google home device, because you will need a display and a keyboard to sign in. If you connected it with your google account, you will be able to use your google home devices. 

1. Download the Google Assistant app

  • Google Assistant comes preinstalled on most Android smartphones. Otherwise you can download it in the Google Play Store.
  • If you use an iPhone download the app from the App Store.
  • Sign in to the app with your Google account

Unfortunately you can't use the Google Assistant in a web browser. 

2. Activate awork voice

  • Open the following link on your smartphone: awork - Google Assistant 
  • You smartphone should forward you to the google assistant app and show the details for awork voice. Click on "try now" to acticate awork voice.
  • If you are singed in to your Google account you can now send awork voice to your connceted devices via your browser (link).

Google_Assistant.png

3. Connect your awork account with google

To tell awork voice which user and workspace to use, you need to connect awork and awork voice. awork voice will prompt you to login to awork. Your information will be saved in your Google account. 

  • Google Assistant App: Start awork voice by saying / writing "Ok Google. Talk to awork voice" Now the app will ask you to log in to awork.
  • You can connect to awork in your web browser using this Link and click on connect. Now you will see the awork log in screen. You can only see the button if you are signed in to Google. 

4. Active the Assistant

You can activate the assistant with the command "Ok Google, talk to awork voice". Now awork waits for your commands.

awork voice is closed right after every conversation. This means you need to repeat the command for every interaction.

Note

  • The Google Assistant will handle awork voice commands as private and limit themn though Voice Match, because awork voice demands a login to awork. Only the User of the Google Account kan use the functions of awork voice via voice commands.

Configure Shift integration

Currently there is no native integration with Shift

The Shift Support provided us with the following workaround to integration awork into Shift.

  1. Go to the Apps Menu
  2. Search for the Jira app and click on the + button to add it to your apps menu
  3. Click on the "Use Custom URL" checkbox 
  4. Add the URL for your awork workspace. Be sure to include the entire URL
  5. Name your app and choose a color, then SAVE

awork will appear in your sidebar with the Jira logo and the color and naming of your choice. 

For further questions please contact the Shift Support (https://support.tryshift.com/home/).

Configure noCRM.io integration

The basis for the integration between awork and noCRM.io is Zapier. The process is the one for our normal Zapier integration.

First you choose noCRM.io (1) and connect it with awork (2). The trigger needs to be "New Manual Trigger" (3) and the action "Create Project" (4).

Screen_1.png

Now you need to connect your Zapoer and noCRM.io account.

Screen_2.png

To do so you need to create an API key for noCRM.io : https://YOUR_ACCCOUNT_URL.nocrm.io/admin/api_keys

Screen_4.png

Now you can enter the key on the next screen.

Screen_3.png

Now just proceed with the normal steps from our Zapier integration

Client Applications

If you want to build your own integration, you can create a client application. To do this, you need to click on Settings and then on Integrations.

Visit our Developer Resources page to learn more about it.

ClientsApplications-en.png

Webhooks

To create a webhook go to "Settings" / "Integrations". Click on the webhooks button.

Webhook_1.png

Now you can select a name (1), enter the URL (2) and select if an authentication is needed. You need to select an event that triggers the webhook (4) and test it (5). Not you can save it.

Webhook_2.png

You can see a list your webhooks on the integration page (7). You can edit (7), pause (8), delete (10) your webhooks or check it's logs (9).

Webhook_3.png

 

The following events in awork can trigger webhooks:

  • Client added
  • Client deleted
  • File added
  • File deleted
  • Project added
  • Project comment added
  • Project deleted
  • Project member added
  • Project member deleted
  • Project status changed
  • Project task added
  • Project task deleted
  • Task assignment added
  • Task assignment deleted
  • Task comment added
  • Task status changed
  • Time tracking added
  • Time tracking deleted
  • User activation changed
  • User added
  • User deleted
  • User status changed