...

С помощью этого бота вы сможете создавать задания на обзвон, добавлятьв них кандидатов, и запускать эти задания.  

...

...

...

Для создания бота для старта звонков в телеграм на

...

м потребуется выполнить эти шаги:

...

1. В начале сценария следует создать блок "Вопрос

...

1. " с текстом "Как будет называться задание на обзвон". И после него блок "Результат"

...

1. .
   Далее указать следующие настройки стрелки из

...

охранить ответ", а также дать переменной имя {название}

• В блоке вопроса будет вопрос о том, какое название будет у задания на обзвон. 

Image Removed

...

1. блока "Вопрос"

...

1. :
   1. Поставить галочку Сохранить ответ,
   2. Задать имя переменной "название",
   3. Тип выходных данных Ветка по умолчанию
      Image Added
      

1. В следующем блоке "Результат" нужно обозначить обязательные переменные, которые требуются для создания задания на обзвон:
   

...

1. Image Added
   

   Название переменной	Значение переменной
   task_name	Название задания на обзвон, которое вводится пользователем в начале

...

1. диалога с ботом, в сценарии задаётся через переменную {название}
   cidType	Определяемый номер

...

1. (АОН). Принимает значения: default

...

1. –Номер по умолчанию для транка. Используется только при интеграции со сторонней телефонией) gornum

...

1. – Один номер

...

1. pool

...

1. – Группа номеров

...

1. cidData	id сущности, выбранной в cidType.

...

1. Актуально для gornum и pool Если номер один, используется id

...

1. АОНа Информация title Как найти айди АОНа В личном кабинете перейдите в Телефония CIS – Управление номерами и скопируйте айди нужного АОНа из его карточки. Если группа номеров, то используется id группы Информация title Как найти айди группы АОНов В личном кабинете перейдите в Телефония CIS – Пулы CallerId номеров и скопируйте айди нужной группы из её карточки.
   email	Электронная почта для входа в личный кабинет
   password	Пароль для входа в личный кабинет
   bot_id	id сценария, который будет воспроизводиться в звонке

...

1. Информация title Как найти айди сценария В личном кабинете

...

1. перейдите в Сценарии – Сценарии и скопируйте айди нужного сценария из столбца ID.

   ⠀
2. Далее добавьте Запрос к серверу для авторизации в личном кабинете со следующими параметрами как показано на скриншоте:

   Image Removed

   ...

   1. 1. Тип авторизации: Отсутствует
      2. Тип запроса: POST
      3. URL:https://iam.twin24.ai/api/v1/auth/login

   ...

   1. 1. Тип содержимого:  JSON
      2. email

   ...

   1. 1. : {email}
      2. password

   ...

   1. 1. : {password}
         

   ...

   1. 1. Image Added
         
   2. Из блока

   ...

   1. запрос к серверу

   ...

   1. укажите две стрелки:

   ...

   1. По умолчанию

   ...

   1. и Результат.
      
      1. Стрелка По умолчанию 

   ...

   1. 1. идёт в блок информации с

   ...

   1. 1. текстом "Произошла ошибка при получении токена"
      2. Стрелка Результат идет в следующий блок "Результат"

   ...

   1. 1. 1. В

   ...

   1. 1. 1. этой стрелке необходимо присвоить переменной token

   ...

   1. 1. 1. значение result.token, для записи авторизационного токена в переменную для дальнейшего использования в сценарии
            Image Added⠀
   2. В следующем

   ...

   1. блоке "

   ...

   1. Результат" присвойте переменной token1 значение Bearer {token}

   ...

   1. , для приведения токена к нужному формату для

   ...

   1. создания задания на обзвон через BPL-выражение в следующем блоке.
      Image Added⠀
   2. Далее добавьте блок "Арифметическая операция" установите тип на "Произвольный тип", и в

   Image Removed

   3)В следующем блоке арифметики используется BPL-выражение для создания здания на обзвон

   • Для использования BPL-выражений в блоке арифметики нужно выбрать тип "Произвольный тип" и в поле "BPL-выражение" ввести выражение, затем нажать "преобразовать BPL в AST"

   Image Removed

   ...

   1. поле "BPL-выражение" вставьте следующий код:
      

      Блок кода
      language php theme DJango title BPL-выражение
      $json = {"name":$task_name,"defaultExec":"robot","defaultExecData":$bot_id,"secondExec":"end","cidType":$cidType,"cidData":$cidData,"startType":"manual","cps":1.01,"taskComment":$taskComment,"additionalOptions":{"fullListMethod":"reject","fullListTime":0,"useTr":false,"allowCallTimeFrom":0,"allowCallTimeTo":86399,"recordCall":true,"recTrimLeft":0,"detectRobot":false},"redialStrategyOptions":{"redialStrategyEn":false,"busy":{"redial":false,"time":1,"count":1},"noAnswer":{"redial":false,"time":1,"count":1},"answerMash":{"redial":false,"time":1,"count":1},"congestion":{"redial":false,"time":1,"count":1},"answerNoList":{"redial":false,"time":1,"count":1}}} $response = http.request("https://cis.twin24.ai/api/v1/telephony/autoCall", "POST", $json). header("Authorization", $token1).send() $code = $response.statusCode sys.sleep(2_000_000)

   4)Далее идёт блок "условие", от которого отходит 2 ветки, ветка по умолчанию уходит в блок с информацией об ошибке, вторая ветка с условием:

   Image Removed

   В условии происходит проверка статус кода ответа от сервера {code} = 200, если запрос был успешным и сервер вернул код 200, то бот перейдёт по этой ветке

   5)В следующем блоке используется BPL-выражение:

   Image Removed

   1. 
      После этого нажмите кнопку "Преобразовать BPL в AST"
      

      Информация
      В данном коде выполняется запрос к серверу на создание задания на обзвон. Для формирования такого запроса нужно указать много параметров, которые неудобно указывать через блок запрос к серверу, поэтому используется BPL-выражение с предустановленными значениями, куда переменными подставляются ваши значения из блока результат, установленного в начале сценария.

      Image Added⠀
   2. Далее добавьте блок "Условие", и укажите из него стрелки с типом По умолчанию и И:
      1. Стрелка По умолчанию идёт в блок информации с текстом "Произошла ошибка при создании задания на обзвон"
      2. Стрелка И идет в следующий блок "Арифметическая операция" и имеет условие {code} = 200. Таким образом проверяется на успешность код, который вернуло BPL-выражение
         Image Added⠀
   3. В следующий блок "Арифметическая операция" вставьте следующий код

   ...

   1. :
      

      Блок кода
      language php theme DJango title BPL-выражение
      $id = $response.body.get('id').get('identity')

   ...

   6)Далее идёт конструкция определения номера через блок "Вопрос" и ветки от него:

   Image Removed

   Первая ветка из блока "Вопрос" идёт ветка с сохранением ответа пользователя и типом выходных данных "Номер телефона"

   Вторая ветка из блока "Вопрос" идёт в блок "Информация", в котором будет информация о том, что номер введён неверно, затем в блок "Информация", в котором будет просьба ввести номер корректно, а затем ветка уйдёт обратно в вопрос для определения номера

   7)После определения номера, при помощи блока "Запрос к серверу" происходит добавление кандидата в задание на обзвон

   ...

   1. 
      После этого нажмите кнопку "Преобразовать BPL в AST"
      

      Информация
      С помощью этого кода мы записываем в переменную id идентификатор созданного задания на обзвон

   ...

   1. , который нам понадобится далее в сценарии.

      
      Далее добавьте блок "Информация" с текстом "Задание создано! Его айди: {id}. Теперь введите номер кандидата для обзвона"
      Image Added⠀
   2. Далее добавьте блок "Вопрос" для определения номера кандидата на обзвон. Для этого укажите из блока стрелки с типом "Номер телефона" и "Ошибка определения номера телефона": 
      1. Для стрелки Номер телефона укажите параметры как показано на скриншоте И соедините её со следующим блоком "Информация" с текстом "Добавляю кандидата в задание..."
      2. Стрелку Ошибка определения номера телефона соедините со следующим блоком "Информация" с текстом "Ошибка в номере телефона". Далее зациклите фрагмент как показано на скриншоте
         Image Added⠀
   3. Далее добавьте блок "Запрос к серверу" и соедините его с предыдущим блоком "Информация". Далее укажите следующие параметры как показано на скриншоте:
   1. 1. Тип авторизации: Bearer
      2. Значение ключа: {token}

   ...

   1. 1. Тип запроса: POST
      2. URL: https://cis.twin24.ai/api/v1/telephony/autoCallCandidate/batch

   Тело запроса:

   ...

   1. 1. Тип содержимого: JSON
      2. batch.0.autoCallId

   ...

   1. 1. : {id}
      2. batch.0.phone.0

   ...

   1. 1. : 7{number}

   ...

   8)После добавления кандидатов, в блоке "Информация" задаётся вопрос: "Хотите добавить ещё кандидатов?", после чего ставится блок "Вопрос", от которого идут следующие ветки:

   Image Removed

   ...

   1. 1. 
         Image Added
         
   2. Из блока "Запрос к серверу" укажите две стрелки: По умолчанию и Результат.
      
      1. Стрелка По умолчанию идёт в блок информации с текстом "Произошла ошибка при добавлении кандидата"
      2. Стрелка Результат идет в следующий блок "Информация" с текстом "Кандидат добавлен! Добавить еще одного?"
   3. Далее добавьте блок "Вопрос" и соедините его с предыдущим блоком "Информация". После этого укажите из блока "Вопрос" стрелки с параметрами как на скриншотах ниже
      

      Подсказка
      Установите остальные блоки в соответствии со скриншотом ниже

      Image Added
      

      Номер ветки	Название ветки	Описание ветки
      1	Определение номера	Тип выходных данных: "Номер телефона", ответ пользователя сохраняется в переменную number
      2	Согласие	Тип выходных данных: "Ключевые слова", согласие определяется при помощи

   ...

   1. ключевых слов, по типу "Да" и других на выбор,

   ...

   1. а также при помощи кнопки с вариантом ответа "Да".

   ...

   1. 3

      Отказ

      Тип выходных данных: "Ключевые слова", согласие определяется при помощи

   ...

   1. ключевых слов, по типу "Нет" и других на выбор,

   ...

   1. а также при помощи кнопки с вариантом ответа "Нет".

   ...

   1. 4	Ветка по умолчанию

   ...

   1. Тип выходных данных: "По умолчанию", уходит в "Пустой блок

   ...

                           Настройки ветки с согласием:

   1. " и затем в вопрос о старте задания.

   2.  Далее добавьте блок "Вопрос", соедините его с предыдущим блоком "Информация" как показано на скриншоте. И укажите две стрелки с кнопками аналогично стрелкам на предыдущем шаге.
      1. Стрелка Отказ идет в блок "Информация" с текстом "Запуск отменен"
      2. Стрелка Согласие идет в блок "Арифметическая операция"
         Image Added⠀
   3. Далее для блока "Арифметическая операция" установите настройки согласно скриншоту. И вставьте следующий код в поле BPL-выражение:
      

      Блок кода
      language php theme DJango title BPL-выражение
      sys.sleep(1_000_000)

      
      После этого нажмите кнопку "Преобразовать BPL в AST"
      

      Информация
      Этот код необходим для создания секундной задержки перед запуском задания. Чтобы данные успели синхронизироваться

      
      Image Added⠀
   4. Далее добавьте блок "Запрос к серверу" со следующими настройками:
      1. Тип авторизации: Заголовок
      2. Тип авторизации: Bearer
      3. Значение ключа: {token}
      4. Тип запроса: POST
      5. URL:https://cis.twin24.ai/api/v1/telephony/autoCall/{id}/play
         
         Image Added⠀
   5.  Готово! Запустите бота в любом мессенджере и проверьте работу сценария. 
      

      Примечание
      title Внимание!
      Данный бот не будет работать из редактора сценария. Так как в его работе используются BPL-выражения, которые не поддерживаются из редактора.  Для тестирования запустите этого бота в любом из чатов

   Добавление кандидатов в существующее задание на обзвон

   
   Вместо 5 этапа, создайте блок вопроса и в выходящей из него стрелкеукажите названиепеременной id и поставьте галочку Сохранить ответ
   
   Image Added

   Далее добавьте блок "Запрос к серверу" со следующими настройками:

   • Тип авторизации: Заголовок
   • Тип авторизации: Bearer
   • Значение ключа: {token}
   • Тип запроса: GET
   • URL: https://cis.twin24.ai/api/v1/telephony/autoCall/{id}
     
     Так же добавьте выходящий блок информации, где при неверно введённом идентификаторе покажет ошибку, что поможет распознать причину сбоя на этом этапе.
     
     

   Image Added
   Затем добавляем стрелку со следующими настройками 
         • Тип: Результат
         • Успешность запроса: Успешно 
         • Код ответа: 200
         • Присвоить переменные при выборе ветки:  status = result.status
   
   Image Added
   Далее мы добавляем блок с условием и выходящим из него блоком информации в котором вы узнаете, что задание уже запущено.

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

   ...

   В  выходящей стрелке мы указываем следующие настройки:
          Тип: Условие "ИЛИ"
           Условия: {status} = READY (Готово к запуску)
   

                          

   ...

   {status} = BLANK (Пустое задание (обзвон не возможен))
            

   ...

                

   ...

   {status} = PAUSED (Приостановлено)
                          

   ...

   {status} = DONE (Обзвон завершен)
   Если статус совпадает с условием, то значит в задание можно добавить нового кандидата на обзвон.
   
   Image Added
   После чего в выходящем блоке информации, мы указываем переменную {status}, чтобы во время добавления нового кандидата, мы могли увидеть статус обзвона.
   
   Image Added
   После заполнения вы можете возвращаться в 9 этап и следовать его описанию.