Analytics Tools

Ask natural language analytics questions and get AI-powered explanations for detected anomalies. 2 tools in this category.

analytics.ask

Ask a natural language question about comms performance. The platform translates the question into SQL, runs it, and returns formatted results.

Roles: ALL_ROLES

Field	Type	Required	Description
`question`	`string`	Yes	Natural language analytics question
`brandId`	`uuid`	Yes	Brand context for the query
`dateRange`	`object`	No	Date range to scope the query
`dateRange.start`	`datetime`	No	Start date
`dateRange.end`	`datetime`	No	End date


{
  "tool": "analytics.ask",
  "input": {
    "question": "What was the open rate for email campaigns last week?",
    "brandId": "brand-uuid",
    "dateRange": {
      "start": "2026-05-12T00:00:00Z",
      "end": "2026-05-18T23:59:59Z"
    }
  }
}

anomaly.explain

Get an AI-powered explanation for a detected anomaly in delivery or engagement metrics.

Roles: ALL_ROLES

Field	Type	Required	Description
`anomalyId`	`string`	Yes	Anomaly identifier from the alerting system
`includeContext`	`boolean`	No	Include related metrics for context (default true)


{
  "tool": "anomaly.explain",
  "input": {
    "anomalyId": "anom_abc123",
    "includeContext": true
  }
}