What is the AskMaven API

The AskMaven API is a REST API that allows you and your bots, web sites, and apps to call Maven capabilities programmatically. You can use the API to ask Maven for the next best actions (route to skill, KB article, etc) for a concierge bot/app.

Use Cases

A typical use case for using AskMaven APIs is to get a routing decision to transfer to a skill from a Bot or LOB app.

  1. A brands concierge bot (for example a bot built in Conversation Builder or Google Dialogflow) handles branded greetings, dialogs, and intents.
  2. It then calls the AskMaven API which evaluates all the policies setup in AI Powered routing and then returns the next best best action.
  3. The concierge bot then uses the action (for example route to a skill), to transfer the conversation to that skill in LiveEngage.
  4. This is often used in conjunction with the Context Session Store to pass custom attributes to use in a policy (for example intents). To learn more about how to use the Context Session Store please see documentation.

Developer Key

To use AskMaven APIs you will need to create and use an API key. To get your unique key:

  1. Login to Maven with your LiveEngage credentials and then navigate to Developer Key.

  2. Copy and paste the key you see in the experience and use it in your API headers.

  3. To generate a new key, click on the Regenerate Key button. Please note that this will invalidate the previous key. The key is shared for all Maven APIs and therefore you will have to use the new key wherever the APIs are being called.