GenerateBestCallTimeReport
Метод GenerateBestCallTimeReport
Примените метод GenerateBestCallTimeReport для получения периода времени, в течение которого наиболее высока вероятность дозвониться до ваших клиентов. Метод аналогичен GetBestCallTime, но позволяет за один запрос проверить не 1, а до 50 000 номеров. Последовательность действий:
- Отправьте номера на проверку с помощью метода GenerateBestCallTimeReport. В ответе на запрос вы получите идентификатор отчёта с результатами проверки
- Используйте эполученныйтот идентификатор, чтобы с помощью метода GetHLRReport получить этот отчёт. В нём по каждому проверенному номеру будет доступен период времени, в течение которого абонент вероятнее всего ответит на звонок. Благодаря этому вы сможете подобрать время для обзвона вашей клиентской базы.
Точка подключения: Выполните POST-запрос с входными параметрами к точке подключения:
POST: https://api.exolve.ru/hlr/v1/GenerateBestCallTimeReport
Авторизация
Передайте следующие Заголовки HTTP для успешной авторизации.
Имя | Тип | Описание |
---|---|---|
Authorization | string | API-ключ приложения с Bearer перед ним. Пример: Bearer e***s0 , где e***s0 замените на API-ключ вашего приложения |
Входные параметры
Передайте следующие параметры в теле запроса в JSON-формате. Параметры, отмеченные жирным шрифтом, являются обязательными.
Параметр | Тип | Описание |
---|---|---|
number | string | список номеров, по которым нужно узнать лучшее время для звонка; формат файла — base64, формат номера — 7ХХХХХХХХХХ |
Выходные параметры
Параметр | Тип | Описание |
---|---|---|
file_uuid | string | идентификатор отчёта |
Примеры
Входные параметры:
{
"numbers": "NzkwNTc3MTM1ODAKNzkwNTc3MTM1ODEKNzkwNTc3MTM1ODIKNzkwNTc3MTM1ODMKNzkwNTc3MTM1ODQKNzkwNTkK=="
}
Выходные параметры:
{
"file_uuid": "89363af6-45c8-4961-9f4a-06fa363b5fdc=="
}
Возможные ошибки
Код | Статус | Пример сообщения | Описание |
---|---|---|---|
400 | Bad Request | at least one number is required | файл не может быть пустым — передайте хотя бы 1 номер на проверку |
400 | Bad Request | invalid GenerateActivityScoreReportRequest.Numbers: value length must be at least 1 bytes | |
400 | Bad Request | invalid value for bytes field numbers | |
400 | Bad Request | unexpected token | |
400 | Bad Request | invalid value | |
400 | Bad Request | unknown field | |
401 | Unauthorized | incorrect authorization token | невалидный API-ключ |
403 | Forbidden | нет доступа к данными с предоставленным API-ключом | |
404 | Not Found | некорректно введен URL запроса |