Приклад інтеграції Webitel (SPA) для обробки вхідних чатів

Owned by Olesya Tantsyura
Last updated: Aug 14, 2024
1 min read

1. Опис

Приклад інтеграції Webitel (SPA) для обробки вхідних чатів з різними системами.

Реалізована можливість спілкуватися в одному і більше чатах, відправляти та приймати файли та смайли. Також перевід прийнятого чату на попередньо створену схему.

Історія чатів буде доступна в вигляді дашборду. З описом дашборду можна ознайомитись за наступним посиланням: https://webitel.atlassian.net/wiki/spaces/WEB/pages/721195.

Основні пункти:

  1. Загальні налаштування інтеграції Webitel;

  2. Приклад використання Webitel-SDK;

  3. API для роботи зі списком операторів;

  4. API для роботи зі змінною статусів операторів;

  5. Бібліотека для інтеграції.

1.1. Загальні налаштування інтеграції Webitel

Для цілей інтеграції, вам потрібно зберегти на боці SPA наступні налаштування:

  • Кінцева точка Webitel REST API. Наприклад: https://cloud.webitel.com/api/

  • Кінцева точка Webitel Web Socket. Наприклад: wss://cloud.webitel.com/ws/

  • Токен інтеграції Webitel.

  • Домен користувачів Webitel. Внутрішній домен Webitel, наприклад: my-company.lo

1.2. Приклад використання Webitel-SDK

Приклад використання Webitel-SDK для управління чатами знаходиться за наступним посиланням:

https://git.webitel.com/projects/WEP/repos/vue-phone-example/browse.

Основну логіку для роботи з чатами та дзвінками можна подивитись у файлі src/ws.js.

Зміна статусу реалізована у вигляді списку, що випадає. Детальніше можна подивитись у файлі src/components/Agents.vue.

Приклад зроблений на Vue 2.

1.3. API для роботи зі списком операторів

API для роботи зі списком операторів знаходиться за наступним посиланням:

https://swagger.webitel.com/#/AgentService/SearchAgent

1.4. API для роботи зі змінною статусів операторів

API для роботи зі змінною статусів операторів знаходиться за наступним посиланням:

https://swagger.webitel.com/#/AgentService/UpdateAgentStatus

1.5. Бібліотека для інтеграції

Бібліотека для ознайомлення з інформацією, яка використовується при процесі налаштування інтеграції JavaScript + WebSocket. Зроблена на основі бібліотеки SDK.

Знаходиться за наступним посиланням:

https://webitel.github.io/webitel_sdk/classes/Client.html