Перейти к основному содержимому

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

Следующие методы Calls API представляют собой упрощенные методы для добавления в обзвон одного номера с параметрами:

  • GET https://app.aimylogic.com/api/crmCalls/campaign/{token}/addPhone
  • POST https://app.aimylogic.com/api/crmCalls/campaign/{token}/addPhone
  • GET https://app.aimylogic.com/api/crmCalls/campaign/{token}/test/addPhone

Данные методы отличаются от метода POST /addPhones тем, что параметры передаются в строке запроса, а число поддерживаемых параметров ограничено.

предупреждение
Методы предназначены для добавления номеров в обзвоны из CRM-систем, в частности Битрикс24.

Параметры запроса

Метод поддерживает следующие параметры задания на обзвон:

  • phone — номер телефона абонента, обязательный параметр.
  • gmtZone — часовой пояс абонента, необязательный параметр.
подсказка
На формат часового пояса накладываются те же ограничения, что и для метода POST /addPhones.

Все другие параметры интерпретируются как дополнительные данные в параметре payload.

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

Повторные звонки на один и тот же номер игнорируются, если вы используете методы:

  • GET https://app.aimylogic.com/api/crmCalls/campaign/{token}/addPhone
  • POST https://app.aimylogic.com/api/crmCalls/campaign/{token}/addPhone

Подробнее об этих правилах читайте в основной статье.

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

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

curl --request POST 'https://app.aimylogic.com/api/crmCalls/campaign/8231.7056.1b131df1/addPhone?phone=79123456789&gmtZone=+03:30&name=Alex' \
--header 'Content-Type: application/x-www-form-urlencoded'

Ответом на такой запрос будет идентификатор созданного задания на обзвон в строковом формате.