Добавление номеров в обзвон

Данный метод Calls API позволяет добавить перечень номеров с параметрами в обзвон:

POST https://app.aimylogic.com/api/calls/campaign/{token}/addPhones

Тело запроса

В теле запроса к данному методу передается массив объектов, описывающих добавляемые в обзвон номера и политику звонков на каждый номер. В каждом объекте можно задать следующие поля.

Поле	Описание	Пример
phone	Номер телефона абонента. Обязательное поле.	"79123456789"
payload	Произвольные дополнительные данные, которые необходимо передать в сценарий. Необязательное поле.	{"promo": "Скидка 20% на все тарифы Aimylogic!"}
startDateTime	Начальное время звонка. Звонок будет совершен в интервале от startDateTime до finishDateTime. Необязательное поле.	"2020-03-23T00:00:00Z"
finishDateTime	Конечное время звонка. После finishDateTime звонки совершаться не будут. Необязательное поле.	"2020-03-23T00:00:00Z"
allowedDays	Дни недели, в которые звонок может быть совершен. Необязательное поле.	["mon", "wed", "fri"]
allowedTime	Временные интервалы для каждого дня недели, в которые может быть совершен звонок. Необязательное поле.	{"default": [{"localTimeFrom": "10:00", "localTimeTo": "18:00"}]}
retryIntervalInMinutes	Пауза между попытками дозвониться в минутах. Необязательное поле.	120
maxAttempts	Количество попыток дозвониться. Необязательное поле.	1
gmtZone	Часовой пояс абонента. Необязательное поле.	"+03:00"

Допустимое время звонка

allowedDays

Поле allowedDays задает дни недели, в которые может быть совершен звонок. Значение поля — массив, в котором могут содержаться следующие строки: "mon", "tue", "wed", "thu", "fri", "sat", "sun".

предупреждение

При явном указании поля allowedDays звонок возможен только в разрешенные в нем дни недели. Настройки allowedTime для других дней недели при этом игнорируются.

allowedTime

Поле allowedTime позволяет указать для каждого дня недели один или несколько возможных временных интервалов, в которые может быть совершен звонок.

Значение поля — это объект с ключами, соответствующими допустимым названиям дней недели из поля allowedDays, а также ключом default. В значении по каждому ключу содержится массив объектов с вложенными полями localTimeFrom и localTimeTo — самым ранним и поздним временем для звонка.

подсказка

Время указывается в формате HH:mm. Указанное время является относительным — при звонке учитывается местное время абонента.

Звонки в дни недели, не указанные в теле запроса, будут совершаться в рамках интервалов, переданных по ключу default.

localTimeFrom и localTimeTo

При указании localTimeFrom и localTimeTo следует учитывать следующие особенности:

• В каждом интервале обязательно указывать как верхнюю, так и нижнюю границы. Отсутствие одной из границ приведет к ошибке.
• Интервалы не должны пересекаться: верхняя граница одного интервала не должна быть позже, чем нижняя граница другого. Такая ситуация также приведет к ошибке.
• Если localTimeFrom больше, чем localTimeTo, интервал считается корректным: он начинается в указанный день, а завершается на следующий день.

[
  {
    "localTimeFrom": "10:00"
  }
] // Ошибка: не указана верхняя граница

[
  {
    "localTimeFrom": "10:00",
    "localTimeTo": "13:30"
  },
  {
    "localTimeFrom": "13:00",
    "localTimeTo": "14:30"
  }
] // Ошибка: пересекающиеся интервалы

[
  {
    "localTimeFrom": "20:00",
    "localTimeTo": "03:00"
  }
] // Корректный интервал с 8 вечера до 3 ночи

Часовой пояс абонента

Значение gmtZone должно удовлетворять любому из следующих форматов:

• Z — время UTC.
• +h, +hh, ±hhmm или ±hhmmss с опциональными элементами:
  • разделитель : между часами, минутами и секундами, например +hh:mm:ss;
  • префикс UTC, GMT или UT, например GMT-hh:mm.
• ID часовых поясов, установленных IANA TZDB.

Дублирование номеров в обзвонах

Если один и тот же номер был добавлен в обзвон с одинаковыми настройками и payload два раза или больше, такие повторы будут проигнорированы. Ограничение действует 24 часа с момента добавления номера.

подсказка

Если вы используете звонки на один и тот же номер для тестирования обзвона, воспользуйтесь специальным методом GET https://app.aimylogic.com/api/crmCalls/campaign/{token}/test/addPhone.

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

curl --request POST 'https://app.aimylogic.com/api/calls/campaign/8231.7056.1b131df1/addPhones' \
--header 'Content-Type: application/json' \
--data-raw '[
  {
    "phone": 79123456789,
    "payload": {
      "name": "Alex",
      "age": 34
    },
    "allowedTime": {
      "mon": [
        {
          "localTimeFrom": "10:00",
          "localTimeTo": "11:30"
        },
        {
          "localTimeFrom": "13:00",
          "localTimeTo": "14:30"
        }
      ],
      "default": [
        {
          "localTimeFrom": "10:00",
          "localTimeTo": "18:00"
        }
      ]
    },
    "retryIntervalInMinutes": 120,
    "maxAttempts": 0,
    "gmtZone": "+03:30"
  }
]'

Ответ на запрос — массив идентификаторов всех созданных заданий на обзвон.