Общая информация:

Для начала работы с любой из связок в Albato необходимо использовать специальную сущность, называемую "Триггер". Подробную информацию о триггерах можно найти здесь. Триггер может представлять собой либо API-запрос, либо webhook. Для приложения TWIN в Albato в настоящее время предоставлен только один тип webhook триггера, а именно "Результат звонка". Этот триггер получает информацию, содержащуюся в webhook, при возникновении события "CALL_ENDED" (подробное описание webhook).

Важно отметить, что другие события, такие как "CANDIDATE_CHANGED" и "CALL_REDIRECTED", будут проигнорированы системой и не вызовут срабатывания данного триггера.

Особенности работы триггера "Результат звонка":

Так как webhook в TWIN содержит динамичные поля (result, nps, initialVariables, markers и т.л.) и изменяется в зависимости от установленных пользователем переменных и результатов звонка, в триггере используется инструмент Albato - "Ловец хуков" (подробнее про ловца хуков). 
Данный инструмент требуется для получения списка всех полей получаемого webhook.
В связи с этой особенностью, при создании первой связки потребуется выполнить тестовый звонок (рекомендуем совершать его из системы TWIN). После успешного звонка, вы сможете использовать поля триггера при дальнейшем создании связки.    

Пример настройки триггера используя ловец хуков:

Шаг 1 - Создание связки:





В личном кабинете Albato. Открываем вкладку "Мои связки" (1) и нажимаем кнопку "Создать новую связку" (2).

 

Шаг 3 - Добавляем триггер:




Нажимаем на "+", для добавления триггера. 

Шаг 3 - Настраиваем триггер: 




В качестве сервиса выбираем "ТWIN" (1), выбираем триггер "Результат звонка" (2), выбираем подключение (3).

Шаг 4 - Запускаем ловца хуков:




Далее нажимаем кнопку "Ожидать вебхук".

Шаг 5 - Копируем адрес вебхука:




Копируем сгенерированную ссылку с адресом хука. 

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


Шаг 6 - Переходим в лк TWIN:



В новой вкладке браузера переходим в лк TWIN. В разделе "Телефония CIS", открываем "Задания на обзвон". Заполняем задание на обзвон. В выборе сценария (1) выбираем тот сценарий, который будет использоваться в связке Albato. 

Далее нажимаем на "Дополнительные параметры вызова" (2). 

Шаг 7 - Добавление вебухка Albato в тестовое задание:




В строку "Адрес вебхука" (1) вставляем скопированный адрес вебхука Albato из шага 5. Создаем задание на обзвон (2). 

Шаг 8 - Добавление кандидата и запуск задания: 

Добавляем кандидата на обзвон в созданное задание в шаге 7 и запускаем обзвон. Отвечаем боту на звонок. 

Шаг 9 - Возвращаемся к ловцу хуков:



Возвращаемся во вкладку в которой у нас открыт "ловец хуков". Ожидаем пока прейдёт хук (обычно приходит в течение 10-20 сек. после звонка).
Как только прейдёт хук вы увидите сообщение "Доступны новые поля". Данные поля вы сможете использовать в дальнейшем в своей связке. 

Шаг 10 - Добавляем поля в действия:



Теперь мы можем использовать результаты звонка в действиях. Для этого добавляем действия (в примере отправка сообщения в Telegram). 
Выбираем поле в которое мы хотим передать информацию из вебхука. Используя поиск по результату выбираем из какого поля вебхука требуется взять информацию. 

Шаг 11 - Продолжаем настройку связки

Далее мы можем продолжить настройку связки используя полученные поля. Подробная инструкция по настройке собственной связки - ссылка. 

Как понять какое поле мне нужно взять из вебхука?

{
  "event": "CALL_ENDED", # информация из поля будет содержаться в event
  "variables": {
    "age": "35"  # информация из поля будет содержаться в variables-age
  },
  "result": {
    "initialVariables": {
      "phone": "79991234567" # информация из поля будет содержаться в result-initialVariables-phone
    },
    "confirmation": "Подтверждение", # информация из поля будет содержаться в result-confirmation
    "nps": "NPS" # информация из поля будет содержаться в result-nps
  }
}