Roles and Permissions

Bot building is a team job so ServisBOT comes equipped with roles and permissions. This way, bot builders can get what they need done, while IT can be confident their security settings are safe and the bot manager can trust that their experiences are stable.

If you are the first user in your organization you will have all roles applied.

Current Roles:

  • Bot Builder
  • It
  • Bot Manager
  • Master Bot Builder
  • Data Scientist

Bot Builder

You have access to all the bot building tools, conversation viewer, restricted secret access, diagnostics and dashboards.


Access to Secrets, user management and organization-wide settings are available. User management is restricted to this role.

Bot Manager

Access to endpoint configurations, diagnostics, restricted secret access, dashboards and bot-building tools

Master Bot builder

Access to bot manager and bot builder features, restricted secret access and organization wide settings

Data Scientist

Access to API Connectors, conversations viewer and machine learning model management.

Assigning roles

Assigning roles can be done using the CLI. Users will need to log out and log in before role changes affect them. A users session will also automatically expire every hour.

1: Check what roles are available for your organization:

sb-cli role list

2: Set a json file to:

	"Email": "Email",                     /* Required */
	"Name": "Name",                       /* Optional */
	"Roles": ["bot-builder","it"],        /* Optional */
	"Picture": "",     /* Optional */

3: And then run the command to update a user with that definition:

sb-cli user update file.json