Actions

Actions enable conversations applications to interact with the outside world. The inputs they accept are attributes and they provide their response in terms of attributes as well.

Developing a Webhook action
The webhook action allows you to send and receive attributes to/from a webhook URL.
Webhook request structure
1
{
2
  "input_data": {
3
    "attributes": {
4
      "[attribute name]": "[attribute value]"
5
    }
6
  }
7
}
Copied!
Webhook response structure
Successful
1
{
2
  "successful": true,
3
  "output_data": {
4
    "attributes": {
5
      "full_name": "John Smith"
6
    }
7
  }
8
}
Copied!
Unsuccessful
1
{
2
  "successful": false,
3
  "errors": [
4
    {
5
      "message": "[error message]"
6
    }
7
  ]
8
}
Copied!
Examples
Populating attributes
This example models an action which takes first & last name attributes and uses them to populate a full name attribute. As the action response specified that it was successful, this will also automatically populate the action_success attribute with true.
Request
1
{
2
  "input_data": {
3
    "attributes": {
4
      "first_name": "John",
5
      "last_name": "Smith",
6
    }
7
  }
8
}
Copied!
Response
1
{
2
  "successful": true,
3
  "output_data": {
4
    "attributes": {
5
      "full_name": "John Smith"
6
    }
7
  }
8
}
Copied!
Unsetting attributes
This example models a successful action which takes feedback attributes and then returns null values for some of them, causing OpenDialog to unset those attributes. It is possible for an action response to both unset and populate attributes, they are not mutually exclusive. As the action response specified that it was successful, this will also automatically populate the action_success attribute with true.
Request
1
{
2
  "input_data": {
3
    "attributes": {
4
      "location": "Bristol",
5
      "rating": 5,
6
      "comments": "Great service!"
7
    }
8
  }
9
}
Copied!
Response
1
{
2
  "successful": true,
3
  "output_data": {
4
    "attributes": {
5
      "rating": null,
6
      "comments": null,
7
      "referral_code": "ABCXYZ123"
8
    }
9
  }
10
}
Copied!
Errors
This example models an unsuccessful action which has returned an error. As the action response specified that it was unsuccessful, this will also automatically populate the action_success attribute with false. The error message(s) will be automatically added to the logs.
Request
1
{
2
  "input_data": {
3
    "attributes": {
4
      "location": "Bristol"
5
    }
6
  }
7
}
Copied!
Response
1
{
2
  "successful": false,
3
  "errors": [
4
    {
5
      "message": "Missing expected attributes: 'rating', 'comments'"
6
    }
7
  ]
8
}
Copied!

Developing With OpenDialog - Previous

Interpreters

Next - Reference

What are Conversations?

Last modified 6mo ago

Copy link

Contents

Developing a Webhook action

Webhook request structure

Webhook response structure

Examples