Integration with Teamwork.com

To add your Teamwork.com profile, first you have to open the Settings > Profile tab in Whid. Then click on the “Add Profile” button, set a name for your profile (e.g. “Teamwork.com” or “Teamwork”) and select “Teamwork.com” from the target system selector.

Afterwards you can fill the Teamwork.com URL field.

To fill the API token field, you can open “Edit my Details” in Teamwork.com, and select the API & Mobile tab. Here you create your token or if you did that already, reveal your existing API token and copy it to Whid.

Note that Teamwork.com only provides one API token at a time, so if you already integrated it with another application, you must use the same API token for Whid.

Finally, there are two toggles. The first to set is whether your tasks should be entered as billable. Enabling it sets all tasks for this profile to billable.

The second toggle determines whether you want to book on projects or to specific tasks. If you want to book on projects, you will need to use project IDs in the next steps and for tasks, you will need task IDs.

Now you can save your credentials.

Whid validates your credentials on Save. If you are not connected to the internet while saving, you can choose the “Save without validation” option, but Whid will always need internet access when you sync your tracked times to Teamwork.com.

In Teamwork.com you can sync your booked times to projects and tasks. These synced times will appear as new time entries. To make your sync even easier, you can set up automatic mappings between your tracked tasks and Teamwork.com tasks and projects.

Open the Settings > Sync Mappings tab in Whid.

Add a new entry in the “Auto Extraction for Sync Mappings” section: select your Teamwork.com profile from the dropdown, and set the “Regex Pattern” to something like T-(\d+) for tasks or P-(\d+) for projects. This will tell Whid to expect a task ID after “T-” in a task name.

Save the changes.

You can find task or project IDs in Teamwork.com. For a project, go to Projects in the sidebar, click on the relevant project and you’ll see the ID in the URL. To find the ID of a task you are assigned to, you can, for example go to Home > My Work and get the task ID from the URL.

To put the “Auto Extraction for Sync Mappings” to work, track your times with names that include their corresponding Teamwork.com task or project ID.

We recommend using the “task hierarchy” feature: you can create a task name that contains the Teamwork.com task or project ID, a short description of the high-level issue you are working on, and the actual lower-level task you implement in the context of that issue.

For example, if you are a developer and you work on a bugfix, one of your task names could look like this: Dev / T-424522 / UI glitch / Reproduce bug.

Now you want to see all your tracked times in your Teamwork.com instance? Then it’s time to sync them!

To open the sync overlay, first open the Main Window by right-clicking the tray icon and selecting “Main Window”. Then click the “Sync times” button in the upper right corner.

At the top, you can choose a time range for which you want to sync your entries.

If you use your Teamwork.com task or project ID as described above, you might not have to adjust anything. But if something isn’t quite right, you can make adjustments as needed.

For each task you can enter a sync ID and select the profile which includes the system you want to sync to. You can also leave those fields empty for entries you don’t want to sync.

If Whid successfully detected the Teamwork.com task or project ID in your recorded entries, it will automatically fill the corresponding task or project ID as sync ID, and set your Teamwork.com profile as Target.

After selecting which entries you would like to sync and filling the corresponding sync IDs, you can click on “Sync selected”.

Whid then reports the result for each synced entry: a green checkmark means the sync was successful, while a red X indicates that something went wrong.