Skip to content

Integration Tokens

Configure here the authentication tokens required to connect the Orchestrator to third-party services such as Slack and Microsoft Teams.

Screenshot of the BotCity Orchestrator, showing the Integration Tokens page. The page displays fields to fill in with integration tokens for the Slack Bot token and Microsoft Teams, along with a brief description.

Tip

You can access the Integration Tokens menu via the button, shown by the GIF: A short video showing how to access the Integration Token from the Orchestrator page.

Slack Bot Token

The Slack Bot token integrates the BotCity Orchestrator with Slack for general notifications. Once the token is added and saved, users can choose to receive their notifications via Slack. More information on how to obtain a Slack token here.

Integrating BotCity Orchestrator with Slack

Get your Slack OAuth Token and Channel ID: Follow the step-by-step guide in the documentation to obtain the OAuth token and the channel ID from Slack.

Add the OAuth Token: Go to the Integrations page in your BotCity Orchestrator workspace. Find the "Slack Bot Token" field, paste the OAuth token obtained earlier, and click Save to apply the changes. Integrations Menu

Link your Profile to a Slack Channel: In the BotCity Orchestrator, click your profile avatar in the top right corner and select "Profile".
Find the "Slack ID" field and enter the Slack channel ID. Click Save to complete the integration.
Profile Slack Channel ID

Enable notifications on your profile: Go to Profile in the BotCity Orchestrator and make sure Notifications are enabled for your account.
Enable notifications

After completing these steps, the BotCity Orchestrator will be able to send notifications to the specified Slack channel.

Microsoft Teams

The BotCity Orchestrator integration with Microsoft Teams allows users to receive general notifications via Teams.

Setting up a Webhook

Create a team or go to a team where you want alerts to be sent. In the top right corner, find the icon with three dots. Click on it and then click Connectors.

MS Teams Connectors

In the search field on the new screen, type Incoming Webhook. The result will show the option as illustrated below. After identifying the correct option, click the Configure button.

MS Teams Webhook

On the new screen that opens, fill in the required information and copy the generated URL. The URL maps to the channel and you can use it to send information to Teams.

Paste the generated URL in the Microsoft Teams url field in Maestro. After that, you can configure alerts normally so they are also directed to the team you selected.

Impact on existing automations

No reconfiguration needed

The Integration Hub is a discovery and setup interface. Integrations already configured in your automations continue to work without any changes.

  • Existing automations, runners, and schedules are not affected.
  • Old links to the Integrations page redirect automatically to the Integration Hub.
  • The Integration Hub is immediately available in the Global Menu for all workspaces.