How do I activate hosted mode?

TL;DR: register the instance, paste your osTicket URL and an API key, click verify. Done in 2 minutes.

When to use hosted mode

Choose hosted mode if your osTicket is reachable from the public internet (e.g., osticket.yourcompany.com). Flexivity polls your osTicket directly from our cloud — there’s nothing to install on your server. If your osTicket is on a private network, use the on-prem agent instead.

What you need

A public URL where your osTicket is reachable (e.g., https://help.example.com)
An osTicket service account with API access (you can create one in the osTicket admin panel)
About 2 minutes

The 3-step activation

Sign in to app.flexivity.ai and open the onboarding wizard.
Register your instance: name, osTicket URL, choose “shared hosting”.
Provide API credentials: paste the service account API key from osTicket. Click “Verify connection” — Flexivity will reach out to your osTicket, confirm the key works, and start polling.

That’s it. No agent, no docker compose, no firewall rules.

What happens next

Flexivity polls your osTicket every few seconds for new and updated tickets.
Events flow through the AI pipeline and the results are written back to osTicket as ticket notes (or via the plugin if installed).
If your osTicket goes down or rejects the API key, the dashboard shows a clear error and tells you how to fix it.

Troubleshooting

“Connection refused”: your osTicket URL isn’t reachable from our cloud. Check that the URL is correct and the server is up.
“Invalid API key”: regenerate the key in osTicket and paste the new value. Make sure the service account has API access enabled.
“Polling stalled”: usually a transient network issue. The system retries automatically; if it persists for more than 5 minutes, check the dashboard for the error message.

Going deeper

Hosted mode integration approach — how polling works under the hood
Configuration reference — every setting and what it does
Troubleshooting guide — every known failure mode