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 Workplace 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. Open the [Slack] tab and enable the [Add Slack workspace URL] toggle.

4. Enter the URL address of your Slack workspace and confirm by pressing [Integrate].

5. Follow the on-screen instructions on the Slack website and click [Allow] to confirm.

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

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

Some object types in Timebook include the [Git] property that links them to corresponding items in Bitbucket, GitHub, or GitLab. You can configure these objects to update their statuses automatically based on specific events in Git, like opening or merging a pull request.

For more information, see Team settings, and check which features include the dedicated [Automation] tab that allows you to set up this automated configuration.

---

Jira integration for your Workplace

Jira is a popular project management tool that helps teams plan, track, and manage tasks efficiently. It organizes tasks into clear, visible tickets (known as “issues”), allowing your team to monitor progress effectively.

In Timebook, you can easily synchronize your Team’s Work Items with a specific project in Jira. To set this up, you must first enable Jira integration for your entire Timebook Workplace.

There are two methods to integrate Jira with your Timebook Workplace.

To begin, navigate to the [Integrations] section and open the [Jira] tab. You can then choose your preferred integration method—see below for more information on both options.

Jira integration methods available in the [Integrations] tab of Workplace settings.

OAuth integration with Jira

1. In the [Jira] tab of Workplace settings, select the [OAuth] option and click [Integrate].

2. You will be redirected to the Jira logging screen. Log in using your Jira credentials and allow the Timebook-Jira synchronization when prompted.

3. Back in Timebook Workplace settings, paste your Jira workspace URL into the appropriate field.

4. Generate a secret in Jira, then copy and paste it into the appropriate field in your Timebook Workplace settings.
5. In Timebook Workplace settings, click [Generate webhook URL], then copy and paste the generated URL into Jira. Your integration setup is now complete.

Access token integration with Jira

1. In the [Jira] tab of Workplace settings, select the [Access token] option and click [Integrate].

2. Enter your Jira account details:

   • Jira workspace URL

   • Email address associated with your Jira account

   • API token, which you can generate in Jira under the [Security] settings.

   After filling in these details, click [Integrate].
3. Generate a secret in Jira, then copy and paste it into the appropriate field in your Timebook Workplace settings.
4. In Timebook Workplace settings, click [Generate webhook URL], then copy and paste the generated URL into Jira. Your integration setup is now complete.

After enabling Jira integration at the Workplace level, you can synchronize Work Items of selected Timebook Teams with specific Jira projects.

For more information on syncing your Team with a Jira project, see Work settings

---

Related articles

Workplace settings

Integrations

Team settings