Integration with personal Toggl timer

Step 1: Install the Toggl button

Install the Toggl button using the Chrome web store.

Detailed instructions are available at support.toggl.com.

Allow access to your Targetprocess account under the Permissions tab. Add Custom Domain Url Permission for your Targetprocess domain.

Afterwards log in into Toggl account in your Chrome web browser. Login button is shown in the menu of Chrome extensions.

Once completed, the Toggl button appears next to the Entity name in Targetprocess:

Press the button once - and it starts the Timer. Press it again - and the timer stops, sending the time record to your Toggl account.

Now we're ready to forward time records from Toggl to Targetprocess using Zapier!

Step 2: Set up Toggl Trigger in Zapier

Log in to your Zapier account.

Create new Zap. Select Toggl as a Trigger App:

Select "New Time Entry" for the Toggl trigger:

Connect your Toggl account to Toggl trigger. Create a New account in Zapier if details of your Toggl account are not there yet.

Grab your Toggl API token from Toggl account details > "My Profile" section. Connect your Toggl account to Toggl trigger in Zapier using the token.

Test connection.

To test the whole step please submit a new time entry in Toggl and then perform a test in Zapier.

Step 3 (optional) setup 'Filter by' in Zapier.

If you use toggl outside of Target Process, then Zapier will receive an error every time a non target process related time entry is created, a quick way to reduce these errors is to add a "Filter By" step in Zapier which prevents the Zap from continuing unless the Toggl entry 'Description' starts with '#' (see image below).

Step 4: Pull Entity ID and Time Remain using Code Action

Add new Action. Select "Code by Zapier" as an Action App:

Choose Run Javascript for the "Code by Zapier" action

Edit Template:

Edit the Input data as shown in the screenshot below:

| :---------- | :------------------------ | | description | Step 1 Description | | spent | Step 1 Duration Hours |

Copy and paste the following Code. Replace accountUrl and access_token values with your personal ones.

var match = input.description.match(/[\w\s]*#(\d+)\s(.*)/i);
var id = match ? match[1] : 0;
var accountUrl = 'https://myaccount.tpondemand.com';
var access_token = 'MjkwMDI6c1RHczJaUWsrRWpKZkpEUWlNeXFibjdkajM2M3ppY2ZIaWhIS0owUEVDMD9=';
var url = accountUrl + '/api/v1/assignables/' + id + '?access_token=' + access_token + '&include=[TimeRemain,RoleEfforts]&format=json';

fetch(url)
  .then(function(res) {
    return res.json();
  })
  .then(function(json) {
    var newRemain = 0;
    var roleEffortsCount = Object.keys(json.RoleEfforts.Items).length;
    if (roleEffortsCount == 1) {
      newRemain = json.TimeRemain - input.spent;
      if (newRemain < 0) {
        newRemain = 0;
      }     
    }
    var output = { id: id, remain: newRemain };
    callback(null, output);
  })
  .catch(callback);
return { id: id, remain : 0 };

Step 5: Post time record to Targetprocess

Use a template like the one below.

| :-------------------- | :-------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------- | | URL | https://myaccount.tpondemand.com/api/v1/times?access_token=MjkwMDI6c1RHczJaUWsrRWpKZkpEUWlNeXFibjdkajM2M4ppY2ZIaWhIS0owUEVDMD9= | Replace account URL and access token with your own values. | | Payload Type | Json | | | Wrap Request In Array | no | | | Unflatten | yes | |

| :--------------- | :------------------------ | :---------------------------------------------------------------------- | | Assignable__Id | Step 2 Id | Two underscore symbols are used. | | User__Id | 1234 | Two underscore symbols are used. Paste your Targetprocess User ID here. | | Spent | Step 1 Duration Hours | | | Remain | Step 2 Remain | | | Description | Time submitted via Toggl | Any text can be inserted here. |

To retrieve your Targetprocess User ID please make the following REST API call to Targetprocess application in your web browser:

GET /api/v1/Users/LoggedUser?include=[Id]&format=json

{"ResourceType":"User","Kind":"User","Id":1234}

| :----------- | :--------------- | | Content-type | application/json |

Test this step.