With the Insight JAVA API you may customize your organization to fit your special requirements. You may want to create your own plugin or post function to do that specific thing to help your organization. Read the Insight Javadoc to be able to create your own customizations and see the Groovy script examples to get more inspiration on what you can do and something to start with.
How to setup your own plugin
When using the Insight JAVA-API from your own plugin, you need to specify the dependency to Insight so you are able to code against the Insight classes.
You need to install insight locally into your mvn repository. Read more about how to do that here: https://maven.apache.org/guides/mini/guide-3rd-party-jars-local.html
Plugin descriptor configuration
You also need to specify the dependency in the plugin configuration (or as annotation).
In atlassian-plugin.xml if will look like this:
Insight has exported all the necessary packages so you can just access the insight facade classes by doing something like this:
This is available from Insight 3.3.4. From version 4 the package is changed so if you are using version 3.x the package should be "com.riadalabs.jira.plugins.insight.channel.web.api.facade"