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).

Integration_Page_ENG.png

Billing Integration

You can create invoices directly from awork with the billing integration. The integration works with the following tools:

Set up integration 

Set up the integration in awork

To set up the billing integration go to settings / integrations. Now you can select your billing tool.

Then you need to enter the API key from your billing tool. (See below how to get the API key from your billing tool.) Just copy and paste the key into the field and click on save. Now the integration is activated. 

Integration_ENG.gif

Get API key from the billing tool

sevDesk

You can find the API token under settings / user. 

sevDesk_ENG.gif

Lexoffice

Since 12.07.2020 Lexoffice is being integrated via oAuth 2.0 authentication. If you start an integration to Lexoffice from awork, you will be forwarded to Lexoffice and have to log in with your Lexoffice credentials. You are then redirected back to awork and can use the integration directly. The exchange of API keys is no longer necessary.

The integration is valid until the user (who authorized the Lexoffice integration) removes or blocks the authorization of awork in Lexoffice.

HQ

You can find the API token under Admin / API Clients

HQ_API_ENG.png

Create invoice

You can create invoices from time reports. Just click the dollar icon in the top and select create invoice.

Now you will be shown an overview of all your billable, not-billable and billed times.

1st_step.gif

Using new invoice vs existing draft

In this step, you can decide if you want to create a new invoice or use an existing draft. 

2nd_step.gif

Select level for positions

Now you can select the following options for your invoice positions:

  • Groups = Positions: only the group titles with the sums of the groups will be used as invoice positions (this option is only available if you have grouped the time report!)
  • Sums = Positions: only the summed time entries will be used as invoice positions (this option is only available if you have activated sums in the time report!)
  • Times = Position: every time entry will be an invoice position. 

3rd_step.gif

Position text and quantity unit

The next step allows you to select which entity should be used as text for the position. There are the following options:

  • Project name
  • Task name
  • User name

Furthermore, you can decide if you want to bill the times by days or hours. One day will always be eight hours.

4th_step.gif

Adjust data and enter prices

Now you can enter a price for each position. You can also add or edit data. There are the following options:

  • Change the name of the position
  • Change the number of hours/days
  • Delete positions
  • Change the order of positions
  • Create new positions

5th_step.gif

Mark time entries as billed and create invoice

The last step allows you to set all the time entries as billed and create the invoice in your billing tool. You can now close the window or go directly to the invoice in your billing tool.

6th_step.gif

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 Microsoft Teams Integration

Configure Teams integration

To configure the Teams integration go to the channel you want to connect to awork, go to options and select Connectors. Now you can search for the awork app. Click on configure, log in to your workspace and select the project you want to connect to that channel. 

Now there will be a list where you can select which activities from awork should be posted to your Teams-channel.

Teams_Connect_ENG.gif

Create a tab for awork

To create a new tab in a team-channel just click on the +button in your tab bar. A pop-up will appear, here you can search and select awork. Now you simply log in to your awork workspace and select the project you want to link to the tab. When opening the tab awork will ask you a second time to log in and you are good to go. 

Teams_Tab_ENG.gif

Edit tasks in Teams

When a new task is created in awork it will be posted to the linked Teams-channel.

Teams_NewTask_ENG.gif

Now you can interact with that task in Teams. You can do the following things:

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

Teams_EditTask_ENG.gif

Create tasks/time tracking entries from Teams

The awork Teams integration allows you to work in awork directly from Teams. 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
  • /start [task/project] - Start time tracking for a task/project
  • /stop - Stop time tracking
  • /help- Shows you all available commands

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

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.

The linked channel will be shown in the projects details. 

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

Configure Shift-Integration

Shift ist a tools that helps you to integrate all of your apps into one tool and helps you to be more productive. Now you can also add awork to your shift account

Configure Shift integration

Go to Shift and click on the + Button to add a new application. Search for awork and click on the awork icon. Now you can select a name and a color for the awork integration. Afterwards all you have to do is log into your awork account and your are ready to go. 

Shift_Integration.gif

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 awork 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 awork 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