Build a custom Davis Assistant integration

Important

Dynatrace Davis Assistant will reach end of life on January 31, 2023. For options and best practices on managing the push of problem notifications to your preferred third-party incident management or ChatOps service, see problem notifications documentation.

Learn how to build a custom integration using the Davis Assistant API for platforms that aren't supported out of the box.

General requirements

A valid, enabled Davis Assistant API token
A system with network access to Davis Assistant on port 443

Authorization

All requests must include the Authorization header that includes a Davis Assistant API token.
Create a new Davis Assistant API token in the Davis Assistant API page (go to Configurations > Davis Assistant API in Davis Assistant Web).

Note
If the token is invalid, the API returns a 401 Unauthorized status code. If you're attempting to perform an action that requires administrative privileges for the selected environment and lack these privileges, the API returns a 403 Forbidden status code.

POST user interaction input

URL	`https://assistant.dynatrace.com/api/v2/interact`
Method	POST
Header	Content-Type: application/json
Header	Authorization: api-token ${DAVIS ASSISTANT API TOKEN}

Request format

BodyExample

Property	Description	Type	Required
timezone	User's time zone in tzdata format	string	required
sessionId	Uniquely identifies a session to avoid conversation collisions (unique for each user).	string	required
input	Question or phrase to be sent to Davis Assistant	string	required
responseFormat	The output format desired Valid formats: "all" "audible" "visual"	string	optional
tags	An array of tags for filtering interactions—all tags must match an underlining entity in order to be included in the response. Valid formats: "test" { "key": "environment", "value": "prod" } { "context": "AWS", "key": "environment", "value": "dev" }	array	optional

Request body:

json
{
  "timezone": "America/Detroit",
  "sessionId": "custom:test@dynatrace.com:1",
  "input": "What happened this week?",
  "responseFormat": "audible",
  "tags": ["test", { "key": "environment", "value": "prod" }]
}

Response format

BodyExample

Property	Type	Description
responseFormat	string	Included response formats
response.text	string	Plain text version of response
response.visual	object	Slack– and Davis Assistant Web–compatible format
response.audible	object	SSML-compatible format used for Alexa speech responses
tenant	string	Name of environment associated with response
url	string	A URL is included in the response when there's a related Dynatrace dashboard. This property might not be on every response.

Response body (Status code 200):

json
{
  "responseFormat": "all",
  "response": {
    "text": "Today, 11 problems occurred. The largest concentration of problems was around today at 9:00 AM. Would you like to see a listing of these issues?",
    "visual": {
      "text": "Today, 11 problems occurred. The largest concentration of problems was around <!date^1525093200^{date_long_pretty} at {time}|today at 9:00 AM>. Would you like to see a listing of these issues?"
    },
    "audible": {
      "ssml": "Today, 11 problems occurred. The largest concentration of problems was around today at 9:00 AM. Would you like to hear a listing of these issues?"
    }
  },
  "tenant": "Demo Environment",
  "url": "https://demo.dynatrace.com/e/131245bf-c8f0-4f70-b37d-0ac6e0b32a1e/#problems;gtf=c_1525060800000_1525147199999"
}