> For the complete documentation index, see [llms.txt](https://docs.deeray.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.deeray.com/api/analitika/semanticheskie-pokazateli/analiz-problemy.md).

# Анализ проблемы

## ТОП-5 групп в анализе выявленных проблем

<mark style="color:green;">`POST`</mark> `https://api.deeray.com/v1/carrot/analytics/problems_brief`

#### Path Parameters

| Name       | Type   | Description                                        |
| ---------- | ------ | -------------------------------------------------- |
| range.to   | string | Вернуть данные по указанную дату                   |
| range.from | string | Вернуть данные с указанной даты                    |
| range      | object | Диапазон дат, за которые необходимо вернуть данные |
| secret-key | string | Ключ доступа к проекту                             |
| api-key    | string | Ключ авторизации клиента                           |

{% tabs %}
{% tab title="200 " %}

```
{
	"item": {
		"sections": [{
			"diff": 0,
			"id": "6311ae17c1ee52b36e68aaf4ad066387",
			"name": "Other",
			"value": 352,
			"value_hint": "352"
		}, {
			"diff": 0,
			"id": "de6012c9fa4403ad887cdd9f4cbfe6bf",
			"name": "Ошибки сайта",
			"value": 339,
			"value_hint": "339"
		}, {
			"diff": 0,
			"id": "315ed8da33a737614b67cce7dc55049c",
			"name": "Качество сервиса",
			"value": 201,
			"value_hint": "201"
		}, {
			"diff": 0,
			"id": "3e966545a178fd6efa7bb8c70a254cb9",
			"name": "Персонал",
			"value": 197,
			"value_hint": "197"
		}, {
			"diff": 0,
			"id": "474cc4efd4a92820bad2dbe61f076451",
			"name": "Продукты",
			"value": 189,
			"value_hint": "189"
		}],
		"type": "day"
	},
	"code": 0
}
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
Если атрибут `range` не указан, то данные будут предоставлены за последние 30 дней.
{% endhint %}

{% hint style="info" %}
range.from и range.to должен быть в формате YYYY-MM-DD, например "2021-01-30".
{% endhint %}

Данный запрос позволяет получить семантическую информацию по проблемам, которые были выявлены в коммуникациях. В **ответе будут присутствовать следующие параметры:**

·  Название топ-5 групп выявленных в коммуникациях проблем (ранжирование проведено в зависимости количества выявленных проблем в каждой группе)

·  Количество проблем, выявленных в каждой их топ-5 групп.\ <br>

## ТОП N групп и детализация по самой большой группе проблем

<mark style="color:green;">`POST`</mark> `https://api.deeray.com/v1/carrot/analytics/problems`

#### Path Parameters

| Name       | Type   | Description                                                                                        |
| ---------- | ------ | -------------------------------------------------------------------------------------------------- |
| sample     | string | Тип семплирования данные для отображения на графике. Может принимать значение: hours, days, weeks. |
| range.to   | string | Вернуть данные по указанную дату                                                                   |
| range.from | string | Вернуть данные с указанной даты                                                                    |
| range      | object | Диапазон дат, за которые необходимо вернуть данные                                                 |
| secret-key | string | Ключ доступа к проекту                                                                             |
| api-key    | string | Ключ авторизации клиента                                                                           |

{% tabs %}
{% tab title="200 " %}

```
```

{% endtab %}
{% endtabs %}

Данный запрос является промежуточным между запросом \_brief (о выявленных проблемах) и детализированным запросом по конкретной группе. Ответ будет содержать ТОП-N групп и детализированную информацию о самой большой группе. При этом вы можете установить настройки N в зависимости от потребности своих бизнес-процессов.<br>

## Детализация информации по указанной группе проблем

<mark style="color:green;">`POST`</mark> `https://api.deeray.com/v1/carrot/analytics/problems_section`

#### Path Parameters

| Name       | Type   | Description                                                                                        |
| ---------- | ------ | -------------------------------------------------------------------------------------------------- |
| section    | string | Идентификатор группы, по которой необходимо вернуть данные.                                        |
| sample     | string | Тип семплирования данных для отображения на графике. Может принимать значение: hours, days, weeks. |
| range.to   | string | Вернуть данные по указанную дату                                                                   |
| range.from | string | Вернуть данные с указанной даты                                                                    |
| range      | object | Диапазон дат, за которые необходимо вернуть данные.                                                |
| secret-key | string | Ключ доступа к проекту                                                                             |
| api-key    | string | Ключ авторизации клиента                                                                           |

{% tabs %}
{% tab title="200 " %}

```
```

{% endtab %}
{% endtabs %}

Данный запрос предоставляет расширенную информацию по выявленным проблемам в указанной группе. В ответе будут присутствовать с**ледующие параметры:**

·  наиболее массовые проблемы с указанием их частотности,

**·**  данные по динамике количества упоминаний об инцидентах в рамках указанной проблемы с разбивкой по датам, неделям или времени,

·  пики и средние показатели количества обращений в целом, и негативных комментариев в частности.

Если вы хотите воспользоваться возможностью расширения количества возвращаемых параметров по разделу «Анализ проблем» - напишите нам **<help@deeray.com>**  и мы сделаем все возможное, чтобы вы получили необходимые вам данные.<br>
