Робот класса JsonRobotLogic

{  
   "states": {  
      "start": State,
      "state1": State,
      ...
   },
   "errors": {  
      "unrecognized_response": Error,
      "error1": Error,
      ...
   },
   "general_properties": {  
      "steps_header": String,
      "steps_template": String,
      "message_if_no_operators_online": String
   }
}

State

Состояние (вершина графа) описывает текущее состояние робота: его название, действия, шаги в другие состояния.

Формат:

{  
   "title": String,
   "actions": [  
      action1,
      ...
   ],
   "steps": [  
      step1,
      ...
   ]
}

steps может не быть в состояниях, которые в конечном итоге переводят чат на оператора. Если явный переход на оператора не осуществлен, но в состоянии не описаны steps, состояние считается тупиковым и чат переводится на оператора.

Обязательно описывается состояние "start" — с этого состояния начинается любой диалог с роботом.

Action

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

Формат:

{  
   "type": String,
   "parameters": {
      "parameter1": String,
      ...
   }
}

При необходимости добавления новых методов для новых, еще не реализованных actions, в класс JsonRobotLogic следует добавить метод вида:

def on_action_ACTION_NAME(self, parameter1, ...):
    ...

Step

Описывает возможный переход от текущего состояния к другому состоянию.

Формат:

{  
   "keyword": String,
   "step_id": String
}

Error

Штатная ошибка при общении с роботом. При ее возникновении выполняются связанные с ней action.

Формат:

{  
   "actions":[  
      "action1",
      ...
   ]
}

Обязательно должна быть описана ошибка "unrecognized_response" — возникает в случае, когда визитор не ввел ключевое слово, а ввел что-то непонятное. Другие ошибки пока не реализованы, но если возникнет такая необходимость, их можно будет добавить.

• Запросить список операторов через API.
• Открыть профиль этого оператора и скопировать его id в системе — число в конце URL-адреса открытой страницы. К примеру, если профиль оператора находится по адресу https://test.webim.ru/operator/operator.php?operatorid=123456, то нужно взять именно число 123456.

Далее Ваши действия зависят от сетевой конфигурации. Если у Вас облачная конфигурация (в большинстве случаев это так), то Вам нужно прислать файл в нашу поддержку через чат или по e-mail (support@webim.ru), также сообщив id оператора.

Если же у Вас локальная конфигурация, следует выполнить ещё несколько шагов (если на каком-либо этапе у Вас возникнут затруднения, следует обратиться к Вашему системному администратору):

1. Воспользуйтесь нашим скриптом, который осуществляет глубокую проверку добавляемого JSON-файла. Это файл json_robot_config_check.py, который необходимо запустить отдельно со следующими параметрами:

1. Имя аккаунта, в уникальной папке которого лежит JSON-файл.
2. Имя JSON-файла.

Скрипт выведет ошибки файла, если таковые найдутся.

2. Выложите файл на хост, в папку account-specific/ACCOUNT_NAME/configs, где ACCOUNT_NAME — имя Вашего аккаунта.

3. В настройку конфигурации "robots" следует внести информацию следующего вида:

{  
   "OPERATOR_ID": {  
      "type": "json",
      "logic_descriptor_filename": String
   },
   ...
}

4. Выполните flush.