Получение списка диалогов

GET /v2/conversations

Запрос позволяет получить список диалогов по идентификатору бота, дате создания или обновления. Параметры фильтрации задаются через параметры запроса.

Запросы

Query параметры

НазваниеТипОбязательныйОписаниеПример
BotIDintegerНетИдентификатор бота1446
PageNumberintegerНетНомер страницы1
PageCountintegerНетКоличество записей на странице20
CreatedTostringНетОкончание периода фильтрации по дате создания диалога. При необходимости можно указать время и часовой пояс. Формат - ISO 86012023-05-01
CreatedFromstringНетНачало периода фильтрации по дате создания диалога. При необходимости можно указать время и часовой пояс. Формат - ISO 86012023-05-29
UpdatedFromstringНетНачало периода фильтрации по дате последнего сообщения респондента в диалоге. При необходимости можно указать время и часовой пояс. Формат - ISO 86012023-05-20
UpdatedTostringНетОкончание периода фильтрации по дате последнего сообщения респондента в диалоге. При необходимости можно указать время и часовой пояс. Формат - ISO 86012023-05-29

Пример запроса

curl --location --request GET 'https://manual.bot.one/api/v2/conversations?BotID=1446&CreatedFrom=2023-05-01&CreatedTo=2023-05-29' \
--header 'Authorization: Basic ZC5keW1icnlsb3ZhQHByvLnRlY2g6Q2F2ZTIwMTY='

Ответ

Успешный ответ

200 - Успешное выполнение запроса. В ответе вернется список диалогов.

{
    "0": {
        "id": "7eea9bb4-0e47-441b-ad39-0b7715a6978f",
        "name": "#319 Perm",
        "status": "in-process",
        "ip": "92.255.128.210",
        "location": "Perm",
        "updated": "",
        "duration": 935037,
        "source": "web"
    },
    "1": {
        "id": "2368bb59-59e9-467d-91a5-44fdaba94f30",
        "name": "#318 Meppel",
        "status": "completed",
        "ip": "37.1.220.250",
        "location": "Meppel",
        "updated": "2023-05-11T08:25:26+00:00",
        "duration": 13,
        "source": "web"
    },
    "meta": {
        "pagination": {
            "total": 9,
            "count": 9,
            "per_page": 40,
            "current_page": 1,
            "total_pages": 1,
            "links": {}
        }
    }
}
Параметры ответа
НазваниеОписание
idИдентификатор диалога
nameНазвание диалога (норма диалога + город, из которого начат)
statusСтатус диалога
ipIP-адрес пользователя, который начал диалог
locationГород, из которого начат
updatedДата и время публикации последнего сообщения в диалоге в формате ISO
durationДлительность диалога в секундах
sourceCервис, гдe был начат диалог

Коды ошибок

Код ошибкиНаименованиеОписание
400Bad RequestУбедитесь, что все параметры запроса имеют нужный формат
401UnauthorizedПроверьте логин и пароль для авторизации в системе
403ForbiddenПроблема с подключением к инстансу или диалогу. Это может быть связано с невалидным токеном, блокировкой инстанса, остановкой сервиса, удалением или завершением диалога и пр.