REST

The DRUID ChatBot Platform enables you to connect to any enterprise application through any REST APIs.

DRUID Integrations are called from the Flow Engine, which sends the conversation parameters as request parameters and receives back the integration results as response entity.

The entities transport data via integrations. The data is packed as request entity and send it to the systems integrated with the bot. When receiving data from apps, the bot maps the data within the conversation as response entity. For more information, see Integrations.

Note: The calls to your on premise systems are possible in a secured way, without being required to have your APIs accessible from the Internet. For more information, see Installing the DRUID Connector Host.

The REST integration steps

The diagram describes how the REST integration is working:

The DRUID app gets the security context from the REST provider. It usually includes a call to the authentication API.
The actual call to the business API. The call includes the security context obtained in Step 1 on all REST requests. DRUID reuses the security context across multiple integration calls until the security context expires. DRUID acknowledges the expiration based on the settings in Step 3.
The response received in Step 2 is checked for token expiration using status or specific body. When a request is made, DRUID ChatBot checks if the security context is valid and if so, sends the request to the REST service that authorizes it; otherwise goes to Step 1.