Page Comparison

Операторы

if

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

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

switch

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

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

while

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

Code Block
{ "while": { "condition": "${myVar} < 10", "maxSteps": "1000", "do": [ { "log": "log is ${myVar}" }, { "js": { "data": "+${myVar} + 1", "setVar": "myVar" } } ] } }

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

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

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

Триггеры

disconnected

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

Code Block
{ "trigger": { "disconnected": [] } }

commands

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

Code Block

{
        "trigger": {
            "commands": {
                "/queue": [
                    {
                        "sendText": "queue"
                    }
                ],
                "/show map": [
                    {
                        "sendText": "map"
                    }
                ],
                "press button 1": [
                    {
                        "sendText": "button"
                    }
                ]
            },
            "disconnected": [
                {
                    "dump": true
                }
            ]
        }
    },
    {
        "sendText": "start"
    },
    {
        "recvMessage": {
            "set": "текст",
            "timeout": 20
        }
    },

Функции

function

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

Code Block
{ "function": { "name": "myFunction", "actions": [] } }

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" } }

math

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

joinAgent

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

Code Block
{ "mathjoinAgent": { "dataagent": "${caller_id_array}",{ "setVarextension": "new_random_caller_id"1008" }, "fnprocessing": { "randomsec": 30, } }

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

{     "form": {
          "id": 604
        },
        "enabled": true,
        "stringrenewal_sec": {
 10
      },
      "dataqueue_name": "${callercc_idqueue_numbername}",

      "fncancel_distribute": "replace",false
    }
  "setVar": "reverted_caller_id_number",
  		"args": [}

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

joinAgentToTask

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

Code Block
{ "joinAgentToTask": { "/^0/agent": { "extension": "1008", "+84 "id": "OR AGENT ID" ], }, } }

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

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

 "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
{ "markIVRschema": { "nameid": "Log",1 } }

softSleep

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

Code Block
{ "valuesoftSleep": "Входящий звонок" } }

userInfo

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

Code Block
{ "userInfo":1000 }

sql

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

Code Block

[
    {
        "setsql": {
            "usrIddns": "id",
            "emailadmin:123Webitel4@tcp(database-1.cluster-cnvuzqnsxvyv.eu-central-1.rds.amazonaws.com:3306)/mysql",
            "driver": "emailmysql",
                 "mobparams": "variables.fwd_mob",[
                "outdb": "variables.out_cid"
            }],
            "userquery": {"select 1 as tst_number, true as tst_bool, table_name, last_update from mysql.innodb_index_stats where table_name = ? order by  "extension": "${ext}rand() limit 1"
        }
    }
}

setGrantee

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

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

schema

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

Code Block
{ "schemadriver": { "postgres", "idparams": 1[ } }

softSleep

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

Code Block
{ "softSleep": 1000 }

sql

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

Code Block

[  12
  {         "sql": { ],
            "dnsquery": "admin:123Webitel4@tcp(database-1.cluster-cnvuzqnsxvyv.eu-central-1.rds.amazonaws.com:3306)/mysqlselect user_id from call_center.cc_agent where id = $1",
            "drivertimeout": "mysql",5000
        }
   "params": [ },   
	{
        "sql": {
  "db"             ]"dns": "/opt/DataGripProjects/default/identifier.sqlite",
            "querydriver": "select 1 as tst_numbersqlite3",
true as tst_bool, table_name, last_update from mysql.innodb_index_stats where table_name = ? order by rand() limit 1"query"
        }
    }: "select count(*) as ss from storage where key like 'mph_%'",
    {         "sqltimeout": 5000
{        }
    "dns": "user=webitel password=webitel host=10.9.8.111 dbname=webitel sslmode=disable",
 }
]

list

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

Code Block

{
    "list": {
          "drivername": "postgresStopList_Chat_bot",
        "destination": "${user}",
        "paramsactions": [
            {
   12             ],
 "sendText": "BAN: ${from} ⛔️",
          "query": "select user_id from call_center.cc_agent where id = $1","break": true
            "timeout":}
5000        ]
}    }
} ]

list

listAdd

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

Code Block

{
     "listlistAdd": {
         "namedestination": "StopList${caller_Chatid_botnumber}",
         "destinationdescription": "${usercaller_id_name}",
	 	       "actions"expireAt": [
            {
     "${expired_at}",
         "sendText": list"BAN: ${from}
⛔️",              "id": 16
 "break": true       }
     }
}

log

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

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

goto

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

Code Block
{ ] }"goto": "tagName" }

listAdd

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

monoPay

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

Code Block

{
   "monoPay":{
      "listAddinvoice": {
         "destinationaction": "${caller_id_number}"create",
         "descriptionbody": "${caller_id_name}",
	 	 "expireAt": "${expired_at}",{
            "amount":"1",
            "listpaymentType":"debit",
{            "setVar":"monoInvoice",
  "id": 16         "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

Page Comparison

Versions Compared

Old Version 16

New Version Current

Key

Операторы

if

switch

while

Триггеры

disconnected

commands

Функции

function

execute

Переменные

set

export

unSet

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

calendar

cache

httpRequest

js

math

joinAgent

string

joinAgentToTask

markIVR

math

string

markIVR

topicExtraction

userInfo

setGrantee

schema

softSleep

userInfo

sql

setGrantee

schema

softSleep

sql

list

listAdd

log

goto

listAdd

monoPay

log

goto

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

tag

async

break

limit