GenerateBestCallTimeReport

Метод GenerateBestCallTimeReport

Примените метод GenerateBestCallTimeReport для получения периода времени, в течение которого наиболее высока вероятность дозвониться до ваших клиентов. Метод аналогичен GetBestCallTime, но позволяет за один запрос проверить не 1, а до 50 000 номеров. Последовательность действий:

  1. Отправьте номера на проверку с помощью метода GenerateBestCallTimeReport. В ответе на запрос вы получите идентификатор отчёта с результатами проверки
  2. Используйте эполученныйтот идентификатор, чтобы с помощью метода 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 запроса