Перейти к содержанию

Примеры использования

Для выполнения всех запросов требуется авторизация через X-Token.

Получить историю диалога по идентификатору диалога

1. Запрос на экспорт диалога

Bash
1
2
curl --location 'https://client.elma-bot.ai/api/v1/dialogs/export/6410af0299553fcfb57523e0' \
--header 'X-Token: 73802c1e-33bd-4b54-b491-1dc496d58add'

В результате выполнения запроса получаем идентификатор запроса на экспорт:

JSON
1
2
3
{
    "requestId": "6185d9f4-7a63-461f-bdaa-eb893de9c821"
}

Данный идентификатор требуется передать в качестве параметра в метод получения информации о статусе экспорта.

2. Получение статуса запроса на экспорт диалога

Bash
1
2
curl --location 'https://client.elma-bot.ai/api/v1/dialogs/export/status/6185d9f4-7a63-461f-bdaa-eb893de9c821' \
--header 'X-Token: 73802c1e-33bd-4b54-b491-1dc496d58add'

Если процесс экспорта был успешно завершен, в результате выполнения запроса получим сведения о статусе и ссылку на скачивание файла экспорта:

JSON
1
2
3
4
5
{
    "status": "Success",
    "fileUrl": "https://client.elma-bot.ai/api/v1/clients/file-storage/conversation-export/624d635a4775ca75efdc905d/85853a14-cd12-439a-814a-356196caf75a",
    "errorMessage": null
}

По указанной ссылке можно скачать файл экспорта истории диалога в формате json без использования авторизации.

Получить историю всех закрытых диалогов через Telegram за указанный период времени

1. Запрос на экспорт диалогов

Bash
1
2
3
4
5
6
7
8
9
curl --location 'https://client.elma-bot.ai/api/v1/dialogs/export' \
--header 'X-Token: 73802c1e-33bd-4b54-b491-1dc496d58add' \
--header 'Content-Type: application/json' \
--data '{
    "startFromDate": "2023-02-15",
    "startToDate": "2023-02-26",
    "status": "Closed",
    "channelId": "Telegram"
}'

В результате выполнения запроса получаем идентификатор запроса на экспорт:

JSON
1
2
3
{
    "requestId": "338e22d8-4c51-4cf0-945e-2f5a35e885c5"
}

Данный идентификатор требуется передать в качестве параметра в метод получения информации о статусе экспорта.

2. Получение статуса запроса на экспорт диалога

Bash
1
2
curl --location 'https://client.elma-bot.ai/api/v1/dialogs/export/status/338e22d8-4c51-4cf0-945e-2f5a35e885c5' \
--header 'X-Token: 73802c1e-33bd-4b54-b491-1dc496d58add'

Если процесс экспорта был успешно завершен, в результате выполнения запроса получим сведения о статусе и ссылку на скачивание файла экспорта:

JSON
1
2
3
4
5
{
    "status": "Success",
    "fileUrl": "https://client.elma-bot.ai/api/v1/clients/file-storage/conversation-export/624d635a4775ca75efdc905d/7695bc58-d0e0-4d25-8ce7-860ae3a092e9",
    "errorMessage": null
}

По указанной ссылке можно скачать zip-архив, содержащий файлы экспорта в формате json без использования авторизации.