SuperOps

Overview

The SuperOps integration allows you to automate IT management, monitoring, and service desk operations through Bumblebee workflows. Manage tickets, assets, clients, and invoices directly from your workflows.

Prerequisites & Setup

Before setting up the SuperOps integration, you need:

• An active SuperOps.ai account.
• Administrator access to generate API tokens.

1. Generate API Token

1. Log in to your SuperOps account.
2. Click the Settings icon in the left pane.
3. Select your name under the My Profile section.
4. Go to the API Token tab and click Generate Token.
5. Copy this token for the API Key field in Bumblebee.

2. Find Your Subdomain

1. Navigate to Settings > MSP Information.
2. Locate your Customer Subdomain (e.g., if your portal is acme.superops.ai, your subdomain is acme).

Configure in Bumblebee

1. Go to the Integrations page in Bumblebee.
2. Click on SuperOps.
3. Enter your API Key and Customer Subdomain.
4. Save the configuration.

Available Tools

Schema Introspection

• introspect_schema - Introspect the GraphQL schema to discover available queries and types.

Invoices

• get_invoice_list - Get a list of invoices using the correct SuperOps GraphQL query.
• get_invoice - Get a specific invoice by ID. Required: invoice_id (str)

Tickets

• get_ticket_list - Get a list of tickets using the correct SuperOps GraphQL query.
• get_ticket - Get full details for a specific ticket by ID. Required: ticket_id (str)
• get_ticket_conversation_list - Get the list of conversations/messages for a specific ticket. Required: ticket_id (str)

Clients

• get_client_list - Get a list of all client accounts managed by the MSP.
• get_client - Get detailed information for a specific client account by ID. Required: client_id (str)

Assets

• get_asset_list - Get a list of devices/end-points/assets across all clients.
• get_asset - Get detailed specs and health data for a specific asset by ID. Required: asset_id (str)

Alerts

• get_alert_list - Get a list of active RMM/monitoring alerts across all assets.
• get_alerts_for_asset - Get alerts filtered down to a specific asset by asset ID. Required: asset_id (str)

Tasks

• get_task_list - Get a list of tasks using the SuperOps GraphQL query.
• get_task - Get detailed information for a specific task by ID. Required: task_id (str)

Analytics

• analyze_ticket_trends_by_period - Analyze ticket trends by period, based on incoming date and group by. Required: filter_start_date (str), filter_end_date (str), group_by (str). Optional: period (str)

---

Reference: SuperOps API Documentation