Integration Hub¶
The Integration Hub is a dedicated area within the BotCity Platform, accessible through the Global Menu, that centralizes all available integrations in one place. It provides ready-to-use code snippets, use case examples, and setup instructions so you can connect your automations to external tools quickly.
Tip
You can access the Integration Hub module through the top left menu of the Orchestrator,
represented by the icon: 
Migrated from Integrations
The Integrations page previously available in the Orchestrator has been migrated and expanded into the Integration Hub. Any existing links to the old page will automatically redirect to the new location — no action required.
Available integrations¶
The Integration Hub groups all supported integrations into the following categories:
| Category | Tool | Type | Description |
|---|---|---|---|
| Communication | Slack | Plugin | Sends, reads, and manages Slack messages and files in automations. |
| Communication | Plugin | Send and receive emails via IMAP and SMTP on any mail server | |
| Communication | Gmail | Plugin | Send, read, and manage Gmail messages in your automations |
| Communication | Outlook | Plugin | Send and manage corporate Outlook emails |
| BI & Dashboards | Power BI | Plugin | Visualize metrics, ROI, and performance data in Power BI |
| BI & Dashboards | Google Sheets | Plugin | Read, manage, and update Google Sheets spreadsheets |
| BI & Dashboards | Excel | Plugin | Read, manipulate, and update Excel files in your automations |
| BI & Dashboards | CSV | Plugin | Read, manipulate, and write CSV files |
| Productivity | Google Drive | Plugin | Search, download, and manage files in Google Drive |
| Productivity | Google Calendar | Plugin | Create, access, and manage Google Calendar events |
| Productivity | OneDrive | Plugin | Manage OneDrive files in your automations |
| Productivity | SharePoint | Plugin | Access and manage SharePoint files and documents |
| Observability | Grafana | API | Visualize metrics from the Orchestrator API in Grafana dashboards |
| Observability | Datadog | API | Monitor automations with real-time metrics and alerts in Datadog |
| Observability | Dynatrace | API | Monitor automations with metrics and events via the Dynatrace API |
| Data & Storage | Data Lake | API | Export execution logs and data via the Orchestrator API |
Integration detail page¶
Click any integration card to open its detail page. Each detail page has two tabs:
Overview tab¶
The Overview tab provides context before you start:
- A description of what the integration does.
- Use Cases: practical examples of how the integration can be applied.
- Prerequisites: what needs to be configured before you begin.
- A direct link to the BotCity documentation for the integration.
Settings tab¶
The Settings tab content varies by integration type:
| Integration type | What you find |
|---|---|
| Plugin | Step-by-step configuration with copyable code snippets for each step, and use case examples with links to the full documentation |
| API | A link to the tool's own website and documentation (Grafana, Datadog, Dynatrace), where the setup is performed |
Tip
On Plugin-type integrations, each configuration step includes a copy button so you can paste the snippet directly into your automation code.
Integration Tokens¶
Configure here the authentication tokens required to connect the Orchestrator to third-party services such as Slack and Microsoft Teams.
Tip
You can access the Integration Tokens menu via the button,
shown by the GIF: 
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.
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.
Enable notifications on your profile: Go to Profile in the BotCity Orchestrator and make sure Notifications are enabled for your account.
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.
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.
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.