Skip to main content
A mini app is a small tool your team builds in the OpenCX dashboard by describing it to Companion. Use one when the built-in reports or the session sidebar don’t show what your team needs, such as a dashboard cut your way or a widget that looks something up for the session you’re working on.
Open Apps in the sidebar of your OpenCX dashboard. Building an app requires the Mini apps and Companion permissions with Write access in Settings → Roles.

What you can build

Every app is one of two kinds. Companion picks the kind from your request, and asks when it can’t tell. An app can work with:
  • Your OpenCX data: sessions, contacts, reports and more, limited to the permissions approved when the app is published.
  • Your own systems, by running the actions and workflows you already have. An app never holds keys or passwords itself.
  • Specific outside domains, such as map tiles, when the publisher approves them.
  • Files: it can read a CSV or Excel file you pick and let you download what it generates.
Build and publish a mini app covers permissions and domains in detail.

Where apps live

How an app goes live

  1. You describe the app to Companion. It builds a draft and shows a live preview beside the chat.
  2. You preview the draft on real data and ask Companion for changes.
  3. You publish it. Publishing approves the permissions and domains the app uses and makes that version live.
  4. You choose which roles can open it. Dashboard apps can then be pinned under Reports & Apps. Inbox widgets appear in the inbox for everyone they’re shared with.
Nobody else sees a draft. When you change a published app, your team keeps the published version until you publish again.

Who can do what

Permission names below are the labels in Settings → Roles. A role with Full admin access holds every permission, but an app’s editor list restricts admins too. See Control who can edit.
The Builds mini apps row under Settings → Advanced is a separate AI agent capability, available on request. Building apps with Companion in the dashboard doesn’t depend on it, only on the role permissions above.
Creating, publishing, sharing and deleting an app, and changes to its editors, appear in Audit logs.

Build and publish

Create, preview, publish and roll back an app.

Share and use

Roles, editors, Reports & Apps and inbox widgets.

Permissions reference

What each role permission allows.

Actions

Connect your systems for apps to use.