Викибот

Omnidesk

Подключите бота к Omnidesk и начните обрабатывать обращения пользователей

Вы можете самостоятельно настроить интеграцию с Omnidesk и начать обрабатывать обращения пользователей с использованием нашего бота.

Добавьте новую метку в Omnidesk по пути: аккаунт администратора → раздел «Каналы» → подраздел «Метки» → кнопка «Добавить метку». Wikibot будет обрабатывать только те обращения, которые содержат эту метку. После перевода на оператора, эта метка снимается с помощью запросов в адрес API Омнидеска. Image

На портале перейдите в раздел Подключения своего бота и включите интеграцию Omnidesk. Заполните API секцию:

  • Домен – Ваш домен Omnidesk.
  • Почта – почта сотрудника в Omnidesk.
  • API ключ – создаётся по пути: аккаунт администратора → раздел «Настройки» → подраздел «API»
    (на странице https://<ваш_домен>.omnidesk.ru/admin/settings/api/#).

Если все три параметра заполнены верно, появится возможность выбрать агента и метку:

  • Агент – сотрудник, на которого будут переводиться обращения, в случае если бот не нашел ответа, либо пользователь позвал оператора.
  • Метка – выберите метку, созданную на первом шаге.

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

Нажмите Добавить, чтобы сохранить интеграцию.

В настройках интеграции скопируйте в буфер обмена Webhook URL Вашего бота.
Image

В Омнидеске добавьте правило для входящих обращений по пути: аккаунт администратора → раздел «Каналы» → подраздел «Правила» → вкладка «входящие обращения» → кнопка «Добавить правило» или на странице https://<ваш_домен>.omnidesk.ru/admin/channels/rules.

Нужно задать условие выполнения:

  • Статус — равен — открытое. Image

Необходимо добавить два действия:

  • Выполнить вебхук – укажите URL, скопированный на предыдущем шаге. Укажите метод POST и формат JSON.

Галочками отметьте поля id обращения, изначальный текст обращения и ID пользователя.

  • Добавить метку - укажите метку, созданную на первом шаге.

Боту будут передаваться входящие обращения и исходящие, созданные сотрудниками.

В Омнидеске добавьте правило для изменённых по пути: аккаунт администратора → раздел «Каналы» → подраздел «Правила» → вкладка «изменённые обращения» → кнопка «Добавить правило» (на странице https://<ваш_домен>.omnidesk.ru/admin/channels/rules). Image
Нужно задать два условия выполнения в блоке «ВСЕ заданных условия»:

  • Изменения выполнены пользователем.
  • Метки содержат метку, созданную на первом шаге.

Необходимо добавить одно действие:

  • Выполнить вебхук – укажите Webhook URL, а также метод POST и формат JSON.

Галочками отметьте поля id обращения, текст последнего ответа и ID пользователя.

Если бот не сможет ответить на обращение, то оно будет переведено на сотрудника. При закрытии обращения и повторном его открытии по инициативе пользователя, обращение попадет снова на бота.

Ваш чат-бот для обработки обращений готов! Проверьте его работу в любом из каналов Omnidesk.

Если у вас остались вопросы по интеграции, напишите нам.