# Installing and configuring an integration

Here you will learn how to install, configure, and uninstall an existing integration. For information about how to build an integration see Building an integration.

# Installing an integration

Integrations are managed through the organization management page. To access them, click on the organization management icon on the left side of the Dashboard and then select the Integrations tab.

Integrations page

Virtuoso divides integrations into two groups:

  • Added: The list of integrations currently installed to the user's organization environment;
  • Recommended: A list of applications available for installation. This will include both your organization's custom integrations and the ones built and made public by other organizations.

To install an integration, enter its details page by clicking on the integration to install. You may use the top search field to filter integrations by name. Then, press the Install integration button.

Integration install

You will be presented with a form that allows you to associate an organization user with the integration installation.

Integration associate user

You will be able to create a new organization member, just for this integration, or associate it to an existing member.

Setup integration user permissions

When associating any user to an integration you will need to ensure that the user has access to the desired projects.

If the installation was successful, the integration's details page is updated with information about the user who installed it and the integration user, and the Install integration button is replaced by an Uninstall Integration button.

Integration installed

Uninstalling an integration

Uninstalling an integration will not delete the user associated with the integration.

# Configuring an integration installation

After installation, some integrations might require specific information to work properly. As an example, the configuration page of the Slack integration allows the user to inform the Slack webhook URL and the types of the events that Virtuoso should send to the integration.

The steps you should follow to configure an integration depend on how the integration was built. If the integration has a configuration it will either:

  • Present a form inside Virtuoso requesting the configuration information below the other information about the integration:

Slack configuration page using dynamic form

  • Present a Configure integration button near the Uninstall integration button, which redirects you to the external configuration page:

Slack configuration page

Integrations that don't require a configuration won't show a form nor a button.

Last Updated: 7/6/2020, 3:38:26 PM