Skip to main content
Nebuly’s analytics platform provides deep insights into your AI system usage by leveraging both user interactions and eligible user metadata. One of the most important concepts for accurate metric computation is the Eligible User.

​
What are Eligible Users?

Eligible users represent the population of users who have access to your AI agent. Unlike interaction events, which capture what users do, eligible users define who is allowed to use the platform, and when. Tracking eligible users is essential for calculating high-level KPIs such as:
  • Activation rate – the percentage of eligible users who are actively using the AI agent.
Each eligible user has:
  • A unique identifier (end_user)
  • A set of tags that describe user attributes (e.g., region, department, role)
  • A start date (active_from) indicating when the user gained access
  • An optional end date (active_to) marking when access was removed
We recommend frequently updating the list of eligible users to keep the system aware of the currently active user base.

​
Step 0: Get your API key

Before sending eligible users, you must create a project and retrieve your associated API key.
  • Head to ⚙️ settings and navigate to “project settings”; - Create a new project (if you don’t have one already) and give it a name (e.g. Internal chatbot); - Copy the nebuly default_key that has been assigned to the project.

​
Step 1: Send Eligible Users

There are three available endpoints to manage eligible users:

Send Eligible Users

Update Eligible Users

Delete Eligible Users

Each endpoint allows you to insert, update, or delete eligible users by providing a list of user records with structured metadata. This gives Nebuly visibility into your total addressable user base at any point in time. We also provide a GET endpoint to retrieve all eligible users for inspection:

View Eligible Users

​
Why are Eligible Users Important?

While interaction events tell us what users did, eligible users tell us who could have done it. This context is crucial for meaningful metrics:
  • If you had 100 users with access last week, and only 10 used the system, your activation rate is 10%.
  • If you remove old users or add new ones but don’t update the eligible user list, metrics like activation rate become misleading.
Keeping the eligible user list fresh and synchronized ensures accurate metric computation.