Workplace integrations

Reading time: 6 minutes

Boosting your Workplace with external integrations

The [Inegrations] section in the [Workplace settings] module allows you to enhance 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.

Only the Workplace Owner and Admins can access the options in the [Integrations] section.

See below for the complete list of options available in this section.

Tabs available in the [Integrations] section of [Workplace settings].

To access this section:

1. Click the dropdown next to the name of your Workplace in the top-left corner.

2. From the menu, select [Workplace settings].

3. Open the [Integrations] section.

Slack integration for your Workplace

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 level:

• You can push your personal Timebook notifications to Slack after enabling the integration in the [Preferences] module in Timebook. For more information, see Personal Slack integration
• Your Team can convert messages from an integrated Slack channel into , 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 enabling 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:

This is how you enable Workplace-wide integration with Slack.

1. Click the dropdown next to your Workplace’s name in the top-left corner.

2. From the resulting menu, select [Workplace settings] and open the [Integrations] section from the menu on the left.

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 Personal Slack integration or your Team using Inbox settings in Team

Version control integrations for your Workplace

Version control systems are tools to track changes, maintain a history of modifications, and enable project collaboration. They help manage project files, ensure consistency across versions, and streamline teamwork by organizing contributions from multiple users.

Timebook supports integration with version control systems by connecting with Git, one of the most popular and widely used options. Once you integrate Timebook with Git using one of the methods below, 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.

• Cards of several Timebook objects will show the dedicated [Git] field where you can find all the Git information relevant to a given object.

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.

Integrating Timebook with Bitbucket

1. Click the dropdown next to your Workplace's name in the top-left corner.

2. From the resulting menu, select [Workplace settings] and open the [Integrations] tab from the menu on the left.

3. In the [Version control] tab, select the [Bitbucket] option and click [Integrate].

4. Use the toggle at the top to [Enable Bitbucket branch creation]. 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.

Integrating Timebook with GitHub

1. Click the dropdown next to your Workplace's name in the top-left corner.

2. From the resulting menu, select [Workplace settings] and open the [Integrations] section from the menu on the left.

3. In the [Version control] tab, select the [GitHub] option and click [Integrate].

4. Use the toggle at the top to [Enable GitHub branch creation]. 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.

Integrating Timebook with GitLab

1. Click the dropdown next to your Workplace's name in the top-left corner.

2. From the resulting menu, select [Workplace settings] and open the [Integrations] section from the menu on the left.

3. In the [Version control] tab, select the [GitLab] option and click [Integrate].

4. Use the toggle at the top to [Enable GitLab branch creation]. 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.

The [Git] field on object cards will only be visible if you enable the Git property for corresponding object types.

You can manage properties for different object types using Item library

---

Related articles

Workplace settings

Integrations