Getting Started with Plugins

This guide walks you through installing your first plugin. We'll use Slack as the example — it's free, sets up in under five minutes, and gives you immediate value (ops alerts in your Slack workspace).

Before you start

You need:

• An active Levy Fleets subaccount
• Admin role in that subaccount (only admins can install plugins)
• For Slack specifically: a Slack workspace and permission to install Slack apps there

Step 1 — Open the marketplace

Step 2 — Install

Click Install. The install wizard opens with three steps.

Permissions consent

You'll see a plain-English list of what Slack will be able to do — for example, "Read rides", "Read vehicles", "Read zones". Admin-class permissions (anything that can lock or unlock vehicles, change zones, or read rider PII) are highlighted in amber and require an explicit checkbox confirmation.

Configure

Each plugin renders its own configuration form. For Slack, you'll connect a Slack workspace via OAuth and pick the channels for each alert type. For Veriff, you'll enter API credentials. For Captur.ai, you'll set the parking-score threshold.

Confirm

You'll see the pricing reminder one more time (free for Slack). Click Install to finalize.

Step 3 — Verify it's working

Open Dashboard → Settings → Plugins. The newly installed plugin appears in the list with a status pill:

• Active — the install is healthy and receiving events
• Disabled — paused by an operator (webhooks suspended, config retained)
• Failing — recent webhook deliveries have failed; click the gear icon to see the error

The detail panel shows the last successful delivery, the last failure (with response body excerpt), and a 24-hour success-rate gauge.

For Slack, the easiest test is to set a vehicle to maintenance — you should see a message in the channel you configured within a few seconds.

Step 4 — Adjust later

Most plugins let you change configuration without reinstalling. Click the gear icon on the install row to:

• Update the config form (e.g., change the Slack channel)
• Disable the plugin temporarily (pauses webhook delivery, keeps config)
• Rotate the plugin's API token if you suspect it leaked
• View the audit log of every install/configure/uninstall action

Common first-install picks

What's next

• Installing a plugin — full walkthrough of the install wizard
• Configuring a plugin — editing config after install
• Troubleshooting — what to do when a plugin reports failures