Подключение оператора

Для подключения оператора согласно указанным параметрам:

  • Выберите категорию Operators
  • Выберите робот Connect Operator
  • Заполните параметры:
    • chatId - id чата, в который подключится оператор
    • type - тип параметра, которым будет указан оператор
    • phone - номер телефона оператора (для Add By Phone) | userId - id пользователя оператора (для Add By User Id)

Если в процесс автоматически поступают заявки от Sender, в них содержится данный параметр и необходимо оставить значение по умолчанию .

Для того, чтобы подключить любого свободного оператора:

  • Выберите категорию Operators
  • Выберите робот Smart Connect Operator
  • Укажите параметр:
    • chatId - id чата, в который подключится оператор

Если в процесс автоматически поступают заявки от Sender, в них содержится данный параметр и необходимо оставить значение по умолчанию .

Подключится оператор в статусе “онлайн” с наименьшим количеством активных диалогов.

Получение списка участников чата

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

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

Для получения списка участников:

  • Выберите категорию Chats
  • Выберите робот Chat Info
  • Укажите параметр:
    • chatId - id чата, для которого необходимо получить информацию

Для получения идентификатора чата, необходимо отправить в нем команду: /cmd:chat_info

В результате успешного выполнения будет получена информация о чате:

"chatInfo": {
        "state": "ok",
        "chatId": "<chatId>",
        "p2p": "true",
        "members": [ //список участников чата
            {
                "id": "<userId>",
                "role": "<role>"
            }
        ],
        "admins": []
    }

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

Для получения списка операторов компании:

  • Выберите категорию Operators
  • Выберите робот List Operators

В результате выполнения будет получен список операторов компании:

"listOperators": {
        "state": "ok",
        "operators": [
            {
                "userId": "<userId>", // id пользователя
                "phone": "<phone>", // номер телефона
                "name": "<name>", // имя пользователя
                "photo": "<photo>", // аватар
                "roleId": "<roleId>", // id роли в компании
                "roleName": "<roleName>" // наименование роли
            },
        ...
        ]
    }

Проверка статуса пользователя

Для получения статуса пользователя:

  • Выберите категорию Users
  • Выберите робот Check User Status
  • Укажите параметры:
    • type - тип параметра, которым указывается пользователь (Phone/User Id/SSO id)
    • val - значение параметра для идентификации пользователя (номер телефона/id/SSO id)

В результате выполнения, в заявке появится информация о статусе пользователя:

"checkStatus": {
        "state": "ok",
        "status": "userOnline", // статус пользователя
        "userId": "<userId>",
        "name": "<name>",
        "photo": "<photo>"
    }

Отправка текстового сообщения

Для настройки Action отправки текстового сообщения необходимо:

  • Выберите категорию Messages
  • Выберите робот Send Text Message
  • Укажите параметры:
    • type - тип параметра, которым указывается получатель (Send to phone/Send to user/Send to chat)
    • phone - номер телефона получателя (для Send to phone) | userId - id получателя (для Send to user) | chatId - id чата для отправки сообщения (для Send to chat)
    • text - текст сообщения или параметр заявки, в котором хранится текст (например, ``)