Task templates explained

babelforce Task Automation allows you to connect babelforce with any third-party system.

Imagine for example the following use case:

1. a ticket is opened in your help center / CRM
2. the content of that ticket is sent off to a natural language understanding tool (like Dialogflow, Deepsearch, or Microsoft LUIS, etc.)
3. the intent is then printed in your ticket
4. the ticket is routed to a certain agent based on the intent 

This one and many other use cases can be built by our Task Automation feature. We can build these use cases using low code. However, in order to make this even easier to use out-of-the-box, we offer so-called Tasks templates. Each of these templates stores one of the use cases described above, so you don't have to script it on your side. 

The following section explains how to use these predefined templates: 

Go to Automations > Global automations and add new automation. From the "Actions" dropdown menu, choose the action "Create task via template": 

To check which templates are available in your environment, you can query the following endpoint: 

GET https://{{env}}.babelforce.com/api/v3/tasks/scripts/babelforce.template

The respective curl is this one: 

curl -X 'GET' \
'https://{{env}}.babelforce.com/api/v3/tasks/scripts/babelforce.template' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer {my_bearer_token}'

Each of these templates has some predefined required fields that need to be fielded in order to carry out the task. These required fields and the respective template id are the only information you need, to construct your template task. To find out which fields are required for the template you want to use, you can use this request: 

curl -X 'GET' \
'https://{{env}}.babelforce.com/api/v3/tasks/scripts/babelforce.template/{{my_template_id}}?response=payload' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer {my_bearer_token}'

Example:

To construct a task for the template with the id

v1.0.0_babelforce.deepsearch.intent

the following fields are required: 

"required_fields": [
"body.callId",
"body.api_key",
"body.text"  ],

Just enter these into the field "request body" of the babelforce action. It should look similar to this: 

{
    "body.callId": "{call.id}",
    "body.api_key": "{{my_api_key}}",
    "body.text": "{app.speechToText.call_reason}"
}

You can also find the available tasks going to Automations > Task automations and checking the templates on top of the screen: