Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Операторы

if

Оператор if управляет условным ветвлением.

Code Block
    {
        "if": {
            "expression": "${myVar} == '1'",
            "then": [],
            "else": []
        }
    }

switch

Операторы switch и case помогают управлять сложными условными операциями и операциями ветвления.

Code Block
  {
    "switch": {
      "variable": "${getIvrDigit}",
      "case": {
        "1": [],
        "2": [],
        "3": [],
        "default": []
      }
    }
  }

Триггеры

disconnected

Выполняет набор приложений после завершение основного скрипта. Объявляется единожды вначале скрипта

while

Логика работы такая же, как и в языках программирования. Первый раз аппликейшены в блоке [do] выполняются без проверки условия. Последующие разы выполняются только если условие истинно.

Code Block
  {
    "triggerwhile": {
        "disconnectedcondition": []"${myVar} < 10",
     } }

Функции

function

Объединить набор приложений в именную функцию. Объявляется вначале скрипта.

Code Block
{     "functionmaxSteps": {"1000",
        "namedo": "myFunction",[
        "actions": []     } }

execute

Выполнение предварительно объявленной функции по имени.

Code Block
{
     "execute": {          "namelog": "myFunction"log is ${myVar}"
   } }

Переменные

set

Назначение переменных на канал.

Code Block
{     "set": {  },
      "hangup_after_bridge": "true",     {
   "ivrLang": "en"     } }

export

Экспорт переменных на сторону оператора, а также в статистику.

Code Block
    {  "js": {
     "export": [                "reverted_caller_id_number""data": "+${myVar} + 1",
         ]     },

unSet

Разустанавливает переменную.

Code Block
{      "unSetsetVar": ["myVar"
         "reverted_caller_id_number"      ]
}

Служебные приложения

calendar

Приложение позволяет проверить текущее время с рабочим календарем. Значение сохраняется в переменную.

Code Block
{ }
        "calendar": {   }
     "extended": false,         "name": "WorkDay",]
         "setVar": "isWorkDay"
   }
}

httpRequest

Выполнение HTTP REST запроса и обработка результата (get JSON)

Code Block{

condition - условие, написанное с учетом синтаксиса js;

maxSteps -глобальный параметр отвечает за максимальное количество шагов в непосредственно блоке (сделано для того чтобы если где-то дальше например в конце схемы цикл будет снова вызван из goto то схема не зациклилась) если не указывать по умолчанию будет 1000;

do – массив аппликейшенов, которые будут выполняться в цикле.

Триггеры

disconnected

Выполняет набор приложений после завершение основного скрипта. Объявляется единожды вначале скрипта.

Code Block
{
   "httpRequesttrigger": {
    
       "urldisconnected": "https://sales.bpmonline.com/${id}/dataservice/json/reply/SelectQuery",[]
       }
}

commands

Commands влиять пока только на все recvMessage в схеме, если будет выполнена команда, тогда recvMessage таймаут обновляется.

Code Block
{
        "methodtrigger": "POST",{
            "timeoutcommands": 1000,
			"insecureSkipVerify": false,{
                "parser/queue": "application/json",[
             "responseCode": "http_response_code",      {
      "headers": {                 "Content-TypesendText": "application/json",queue"
                   "Cookie": "${my_cookie}"}
                }],
                "path/show map": [
{                  "id": 0 {
           },             "datasendText": "map"
{                 "Name": "Supervisor",   }
                ],
  "UserID": "Supervisor"             },"press button 1": [
         "exportVariables": {          {
      "effective_caller_id_name": "callerIdName",                 "owner_caller_id_numbersendText": "callerIdOwnerbutton"
            }        }
}

js

Выполнение произвольного JavaScript кода с возвращением результата в переменную

Code Block
{
        "js": {      "data": "var time = LocalDate(); time.setDate(time.getDate() + (+${dpd}*-1)); return time.getMonth() + '-' + time.getDate() + '-' + time.getFullYear()", ]
            },
            "setVardisconnected": "myVar"[
         } }

math

Приложение для работы с математическими функциями

Code Block
{     "math": {
      "data": "${caller_id_array}",       "setVar": "new_random_caller_id",      "dump": true
                }
            ]
  "fn": "random"     }
}

fn

  • random: returns a random number from array
  • min and max: can be used to find the lowest or highest value in a list of arguments
  • round: rounds a number to the nearest integer
  • ceil: rounds a number up to the nearest integer
  • floor: rounds a number down to the nearest integer

JavaScript Math

string

Приложение для работы со строкой.

Code Block
    },
    {
        "sendText": "start"
    },
    {
        "recvMessage": {
    "string": {        "dataset": "${caller_id_number}текст",
       "fn": "replace",    "timeout": 20
  "setVar": "reverted_caller_id_number",
  		"args": [
      }
    },
   

Функции

function

Объединить набор приложений в именную функцию. Объявляется вначале скрипта.

Code Block
{
    "/^0/function",: {
          "name": "+84myFunction",
        ],"actions": []
      }
}

fn

  • length: returns the length of a string
  • indexOf and lastIndexOf: returns the index of (the position of) the first or last occurrence of a specified text in a string
  • search: searches a string for a specified value and returns the position of the match
  • slice: extracts a part of a string and returns the extracted part in a new string
  • substring: is similar to slice. The difference is that substring cannot accept negative indexes.
  • substr: is similar to slice. The difference is that the second parameter specifies the length of the extracted part.
  • replace: replaces a specified value with another value in a string
  • toUpperCase or toLowerCase: A string is converted to upper case or to lower case
  • charAt: returns the character at a specified index (position) in a string
  • charCodeAt: returns the unicode of the character at a specified index in a string
  • split: A string can be converted to an array with the split function
  • reverse: Reverse the provided string
  • base64: base64 encoder / decoder
  • MD5: Computes a digest from a string using MD5 algorithm
  • SHA-256: Computes a digest from a string using SHA-256 algorithm
  • SHA-512: Computes a digest from a string using SHA-512 algorithm

JavaScript String

markIVR

Позволяет сохранить массив значений в переменную, которая будет доступна в истории

Code Block{ "markIVR": {

execute

Выполнение предварительно объявленной функции по имени.

Code Block
{
     "execute": {
         "name": "myFunction"
     }
}

Переменные

set

Назначение переменных на канал.

Code Block
{
    "set": {
        "hangup_after_bridge": "true",
        "ivrLang": "en"
    }
}

export

Экспорт переменных на сторону оператора, а также в статистику.

Code Block
    {
        "export": [
            "reverted_caller_id_number"
        ]
    },

unSet

Разустанавливает переменную.

Code Block
{
     "unSet": [
        "reverted_caller_id_number"
     ]
}

Служебные приложения

calendar

Приложение позволяет проверить текущее время с рабочим календарем. Значение сохраняется в переменную.

Code Block
{
    "calendar": {
        "extended": false,
        "name": "WorkDay",
        "setVar": "isWorkDay"
   }
}

cache

Приложение позволяет работать с данными в памяти либо Redis сервере.

Code Block
[
    {
        "cache": {
            "action": "set",
            "set": {
                "data": {
                    "key": "value"
                },
                "ttl": "10000"
            },
            "type": "memory"
        }
    },
    {
        "cache": {
            "action": "get",
            "get": {
                "myVar": "key"
            },
            "type": "redis"
        }
    },
    {
        "cache": {
            "action": "delete",
            "delete": {
                "keys": [
                    "key",
                    "key1"
                ]
            },
            "type": "redis"
        }
    }
]

httpRequest

Выполнение HTTP REST запроса и обработка результата (get JSON)

Code Block
{
    "httpRequest": {
            "url": "https://sales.bpmonline.com/${id}/dataservice/json/reply/SelectQuery",
            "method": "POST",
            "timeout": 1000,
			"insecureSkipVerify": false,
            "parser": "application/json",
            "cacheCookie": false,
            "responseCode": "http_response_code",
            "headers": {
                "Content-Type":"application/json",
                "Cookie": "${my_cookie}"
            },
            "path": {
                "id": 0
            },
            "data": {
                "Name": "Supervisor",
                "UserID": "Supervisor"
            },
            "exportVariables": {
                "effective_caller_id_name": "callerIdName",
                "owner_caller_id_number": "callerIdOwner"
            }
    }
}

js

Выполнение произвольного JavaScript кода с возвращением результата в переменную

Code Block
{
   "js": {
     "data": "var time = LocalDate(); time.setDate(time.getDate() + (+${dpd}*-1)); return time.getMonth() + '-' + time.getDate() + '-' + time.getFullYear()",
     "setVar": "myVar"
   }
}

joinAgent

Постановка абонента в личную очередь оператора. Работает только для звонков.

Code Block
{
    "joinAgent": {
      "agent": {
        "extension": "1008"
      },
      "processing": {
        "sec": 30,
        "form": {
          "id": 604
        },
        "enabled": true,
        "renewal_sec": 10
      },
      "queue_name": "${cc_queue_name}",
      "cancel_distribute": false
    }
  }

processing.form.id -  идентификатор формы. Если пусто, или 0 - без формы.

joinAgentToTask

Возможность из схемы оператору назначить таску (join task новая очередь task)

Code Block
{
        "joinAgentToTask": {
            "agent": {
                "extension": "1008",
                "id": "OR AGENT ID"
            },
            "communication": {
                "description": "bla bla bla description",
                "destination": "bla bla",
                "type": {
                    "id": 1
                }
            },
            "processing": {
                "enabled": true,
                "form": {
                    "id": 604
                },
                "renewal_sec": 10,
                "sec": 30
            },
            "queue_name": "Igor test queue",
            "timeout": 20
        }
    }

Работает для всех типов схем.

  • agent.id or agent.extension - обязательные поля, на какого оператора нужно назначить задачу;
  • communication.description - не обязательно, описание типа связи (см. Абоненты);
  • communication.destination - не обязательно, номер или любой текст типа связи (см. Абоненты);
  • communication.type.id - ид типа связи (Swagger UI здесь список);
  • processing - настройки постобработки:
    • enabled - включена или выключена постобработка;
    • form.id - ид формы (не обязательно);
    • sec - время в секундах постобработки в секундах;
    • renewal_sec - время возможности добавить постобработку;
  • queue_name - название очереди
  • timeout - время в секундах сколько ожидать ответа оператора (по умолчанию включено автоподнятие, поэтому этот параметр нужен больше для случаев, когда оператор не в Workspace).

math

Приложение для работы с математическими функциями

Code Block
{
    "math": {
      "data": "${caller_id_array}",
      "setVar": "new_random_caller_id",
      "fn": "random"
    }
}

fn

  • random: returns a random number from array
  • min and max: can be used to find the lowest or highest value in a list of arguments
  • round: rounds a number to the nearest integer
  • ceil: rounds a number up to the nearest integer
  • floor: rounds a number down to the nearest integer

JavaScript Math

string

Приложение для работы со строкой.

Code Block
{
    "string": {
       "data": "${caller_id_number}",
       "fn": "replace",
       "setVar": "reverted_caller_id_number",
  		"args": [
            "/^0/",
            "+84"
        ],
     }
}

fn

  • length: returns the length of a string
  • indexOf and lastIndexOf: returns the index of (the position of) the first or last occurrence of a specified text in a string
  • search: searches a string for a specified value and returns the position of the match
  • slice: extracts a part of a string and returns the extracted part in a new string
  • substring: is similar to slice. The difference is that substring cannot accept negative indexes.
  • substr: is similar to slice. The difference is that the second parameter specifies the length of the extracted part.
  • replace: replaces a specified value with another value in a string
  • toUpperCase or toLowerCase: A string is converted to upper case or to lower case
  • charAt: returns the character at a specified index (position) in a string
  • charCodeAt: returns the unicode of the character at a specified index in a string
  • split: A string can be converted to an array with the split function
  • reverse: Reverse the provided string
  • base64: base64 encoder / decoder
  • MD5: Computes a digest from a string using MD5 algorithm
  • SHA-256: Computes a digest from a string using SHA-256 algorithm
  • SHA-512: Computes a digest from a string using SHA-512 algorithm

JavaScript String

markIVR

Позволяет сохранить массив значений в переменную, которая будет доступна в истории

Code Block
{
    "markIVR": {
        "name": "Log",
        "value": "Входящий звонок"
    }
}

topicExtraction

Для определение тематики полученного сообщения: сообщение в чате, speech-to-text на IVR

Code Block
 {
        "topicExtraction": {
            "connection": "http://10.10.10.222:3333/extract_topics/",
            "limit": 2,
            "messages": [
                {
                    "message": "интересует ли вас покупка авто?",
                    "sender": "operator"
                },
                {
                    "message": "Вы мне надоели, я же сказал так",
                    "sender": "user"
                }
            ],
            "possibleTopics": [
                "заинтересованный",
                "не заинтересованный",
                "неудобно говорить"
            ],
            "definedTopic": "topicResponse",
            "score": "confidenceResponse"
        }
    }

где,

limit - не обязательно, по умолчанию 4, это последние сообщения из чата или из распознавания в звонке

definedTopic - в какую переменную записать ответ (topic)

score - в какую переменную записать сonfidence

messages - используется только для всех типов кроме chat / call

userInfo

Приложение позволяет получить значение из объекта пользователя по номеру телефона

Code Block
{
    "userInfo": {
        "set": {
            "usrId": "id",
            "email": "email",
            "mob": "variables.fwd_mob",
            "out": "variables.out_cid"
        },
        "user": {
            "extension": "${ext}"
        }
    }
}

setGrantee

Передать права на канал пользователю с идентификатором указанным в id 

Code Block
{
   "setGrantee": {
       "id": 10
    }
}

schema

Выполнить внешнюю схему по идентификатору

Code Block
{
    "schema": {
        "id": 1
    }
}

softSleep

Пауза выполнения скрипта в миллисекундах 

Code Block
{
    "softSleep": 1000
}

sql

Приложение доступно исключительно для выделенных либо собственных серверов Webitel, позволяет выполнить запрос в базу данных и вернуть результат в переменную

Code Block
[
    {
        "sql": {
            "dns": "admin:123Webitel4@tcp(database-1.cluster-cnvuzqnsxvyv.eu-central-1.rds.amazonaws.com:3306)/mysql",
            "driver": "mysql",
            "params": [
                "db"
            ],
            "query": "select 1 as tst_number, true as tst_bool, table_name, last_update from mysql.innodb_index_stats where table_name = ? order by rand() limit 1"
        }
    },
    {
        "sql": {
            "dns": "user=webitel password=webitel host=10.9.8.111 dbname=webitel sslmode=disable",
            "driver": "postgres",
            "params": [
                12
            ],
            "namequery": "Log",select user_id from call_center.cc_agent where id = $1",
            "valuetimeout": "Входящий звонок"5000
        }
}

userInfo

Приложение позволяет получить значение из объекта пользователя по номеру телефона

Code Block
{     "userInfo": },   
	{
        "setsql": {
            "usrIddns": "id/opt/DataGripProjects/default/identifier.sqlite",
            "mobdriver": "variables.fwd_mobsqlite3",
            "outquery": "variables.out_cid"
        },
        "user": {
select count(*) as ss from storage where key like 'mph_%'",
            "extensiontimeout": "${ext}"5000
        }
    }
}]
setGrantee

list

Передать права на канал пользователю с идентификатором указанным в id 

Проверка на наличие абонента в списке с выполнением действий

Code Block
{
    "setGranteelist": {
       "id": 10
    }
}

schema

Выполнить внешнюю схему по идентификатору

Code Block
{
        "schemaname": {"StopList_Chat_bot",
        "iddestination": 1"${user}",
    }
}

softSleep

Пауза выполнения скрипта в миллисекундах 

Code Block
{     "softSleep": 1000
}

sql

Приложение доступно исключительно для выделенных либо собственных серверов Webitel, позволяет выполнить запрос в базу данных и вернуть результат в переменную

Code Block
[actions": [
     {       {
 "sql": {             "dnssendText": "admin:123Webitel4@tcp(database-1.cluster-cnvuzqnsxvyv.eu-central-1.rds.amazonaws.com:3306)/mysqlBAN: ${from} ⛔️",
                "driverbreak": "mysql",true
            }
  "params": [     ]
    }
} 

listAdd

Добавить абонента в список

Code Block
{
     "dblistAdd": {
           ]"destination": "${caller_id_number}",
         "description": "${caller_id_name}",
	 	 "queryexpireAt": "select 1 as tst_number, true as tst_bool, table_name, last_update from mysql.innodb_index_stats where table_name = ? order by rand() limit 1"
   ${expired_at}",
         "list": {
              "id": 16
    }     },
    {   }
}

log

Вывод дополнительной информации в лог файл приложений

Code Block
{
     "sqllog": {" >> ${Hold}    <<<"
}

goto

Перейти к именной метке

Code Block
{
      "dnsgoto": "user=webitel password=webitel host=10.9.8.111 dbname=webitel sslmode=disable",
 tagName"
}

monoPay

Перейти к именной метке

Code Block
{
   "monoPay":{
      "driverinvoice": "postgres",{
            "paramsaction":"create",
[         "body":{
       12             ]"amount":"1",
            "querypaymentType": "select user_id from call_center.cc_agent where id = $1"debit",
            "timeoutsetVar": 5000"monoInvoice",
            }"validity":"3600"
      } ]

log

Вывод дополнительной информации в лог файл приложений

Code Block
{  }
   "log": " >> ${Hold},
<<<" }

goto

Перейти к именной метке

Code Block
{     "gototoken": "tagNameuLRpgdn9yE5JP11NuXVqdvWpKk6TbSiQnquzS2BxtiCw"
}

Параметры приложений

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

tag

Установить именную метку в скрипте

Code Block
{
    "tag": "tagName"
}

async

Выполнение приложения без блокировки

Code Block
 {
     "async": true
 }

break

Прерывает выполнение скрипта

Code Block
 {
     "break": true
 }

limit

Позволяет прерывать цикл после прохождения количества указанного в атрибуте max. Выход осуществляется в именную метку, указанную в атрибуте failover.

Code Block
 {
    "limit": {
     "max": 5,
     "failover": "anotherTag"
  }
}


Table of Contents