Workplace integrations

Enhance your Timebook experience by connecting external apps.

Expand your work with Timebook

In this section of Workplace Admin, you can boost your by integrating it with other apps. We want to give you one platform to manage all your work, and that includes external resources integrated with Timebook.

The following sections describe the available Timebook integrations.

Integrations presented here will impact the entire Workplace as all members can use them.

But Timebook also allows integrations for individual users. For more information, see Integrations


Git integration

Git is one of the most popular version control systems. It's an actively maintained open-source tool that works well on various operating systems. And you can integrate it with Timebook!

The integration between Timebook and Git is made possible by the connecting element we call the "friendly ID" - a unique number attached to each Timebook . By including the friendly ID in commit messages, you can directly link your code changes to specific Work Items in Timebook.

You can integrate with Git using different services.

When you open the [Git] tab in the [Integrations] section, you must first select the provider you want to integrate with.

Integrate Timebook with Bitbucket
  1. Go to the [Integrations] section in the Workplace Admin and open the [Git] tab.

  2. Select the [Bitbucket] option and press [Integrate].

  3. Use the toggle at the top to [Enable Bitbucket branch creation].

  4. You must now provide the following:

    • Your [User name] in Bitbucket.

    • The [App password] you generated in Bitbucket. For more information on app password creation, see this Bitbucket help page.

    • Your Bitbucket [Namespace]. For more information on namespaces, see this GitLab help page.

  5. Once we verify these credentials, you can start adding Bitbucket repositories. To do so, select a repository from the dropdown list and provide your access token. For more information on repository access tokens, see this Bitbucket help page.

Integrate Timebook with GitHub
  1. Go to the [Integrations] section in the Workplace Admin and open the [Git] tab.

  2. Select the [GitHub] option and press [Integrate].

  3. Use the toggle at the top to [Enable GitHub branch creation].

  4. You must now provide your GitHub organization and access token. For more information on access tokens, see this GitHub help page. Remember to select appropriate scopes for your token. Scopes define the accessibility of GitHub repositories in Timebook.

  5. Once we verify your access token, you will see additional options:

    • the [Enable GitHub integration] toggle to turn the integration on and off,

    • the [Trash] icon to remove this integration from your Timebook Workplace,

    • the [GitHub repository list] to connect additional repositories.

Integrate Timebook with GitLab
  1. Go to the [Integrations] section in the Workplace Admin and open the [Git] tab.

  2. Select the [GitLab] option and press [Integrate].

  3. Use the toggle at the top to [Enable GitLab branch creation].

  4. You must now provide the following:

    • Your [GitLab group]. For more information on groups, see this GitLab help page.

    • The GitLab [Access token]. For more information on tokens, see this GitLab help page.

    • Optionally, you can provide the URL address of your server.

  5. Once we verify these credentials, you can start adding GitLab repositories.

Once you integrate Timebook with Git using one of the methods above, you will notice that:

  • We will automatically turn on Bitbucket or GitHub webhooks for Git commits and pull requests. You can turn them off with the dedicated toggle.

  • Timebook Work Item card will show the dedicated [Git] field where you can find all the Git information relevant to a given Work Item.

The [Git] field on a Work Item card will only be visible if you enable the Git system field for the item type to which your Work Item belongs.

You can manage fields for selected Work Item types using our Item library


Slack integration

Slack is a messaging platform designed for teams and businesses to communicate and collaborate in real-time. It offers channels for organized discussions, direct messaging, and integrations with various tools to streamline workflows.

The integration with Slack is beneficial for Timebook Workplace members both on the individual and Team level:

  • You can push your personal Timebook notifications to Slack after enabling the integration in the [Preferences] module in Timebook.

  • Your Team can convert messages from an integrated Slack channel into Tickets, which will appear directly in the Team's Inbox in Timebook. Additionally, replies to these Slack messages will show as comments to their corresponding Tickets.

Before you can enable the features above for yourself or your Team, the Timebook-Slack integration must be set up for the entire Workplace. See below to learn more about it.

To integrate a Timebook Workplace with Slack:

  1. Go to the [Integrations] section in the Workplace Admin and open the [Slack] tab.

  2. Use the toggle at the top to [Add Slack workspace URL].

  3. Enter the URL address of your Slack workspace in the space provided and confirm by pressing [Integrate].

  4. Press the [Add Timebook to Slack] button and follow the on-screen instructions on the Slack website.

  5. The Timebook-Slack integration is now complete. The Timebook companion app is added to the Slack workspace you selected.

After the Workplace-level integration with Slack is enabled, you can proceed and enable Slack-related features for yourself in Integrations or your Team usingInbox (Team settings)


Integrations

Work Item

Item library

Inbox (Team settings)

Last updated