Інтеграція з E-chat
1. Мета проекту
Організувати автоматичну передачу переписок клієнтів з месенджерів Viber та Telegram через сервіс E-chat в систему 1С:УНФ+Автосервіс
2. Загальна схема інтеграції
Клієнт надсилає повідомлення в Viber/Telegram.
Повідомлення фіксується в E-chat.
E-chat формує подію (JSON) і надсилає її на веб-сервер компанії (webhook).
Веб-сервер приймає дані і передає їх в 1С через HTTP-сервіс «Отримання історії переписок від E-chat».
В 1С створюється запис в реєстрі відомостей «Історія переписок в месенджерах».
Документація АПІ E-chat https://help.e-chat.tech/ru/viber/ru-api
3. Методи API, які будемо використовувати
Viber:
POST/channel/connect - створення каналу
POST/channel/disconnect - відключення каналу
POST/link to your webhook for incoming message - отримання повідомлень
POST/link to your webhook for outgoing message status - отримання статусів вихідних повідомлень
Telegram:
POST/CreateChannel.php - створення каналу
POST/DisableChannel.php - відключення каналу
POST/:webhook [IncomingMessage] - отримання вихідних та вхідних повідомлень
POST/:webhook [OutgoingMessageStatus] - отримання статусів повідомлень
4. Група E-chat в інтерфейсі 1С
В розділі CRM зробити групу E-chat
В групі E-chat зробити Налаштування. В налаштуваннях пропоную розмістити API ключі для вайбера та телеграма і зробити кнопки з функціоналом двох перших методів API по підключенню/відключенню каналів. Відображати групу E-chat всім користувачам (Базові права УНФ). Налаштування показуємо тільки повним правам і вносити зміни в налаштування E-chat даємо тільки повним правам.
В цю ж групу вивести новий Реєстр відомостей «Історія переписок в месенджерах». Відображати тільки для повних прав.
5. Реєстр відомостей «Історія переписок в месенджерах»
питання до програміста: як архітектурно в 1С нам краще зберігати історію переписок в месенджерах - в одному реєстрі чи двох окремих? В подальшому історія переписки буде використовуватися для контролю комунікацій з клієнтами і виводитиметься в Замовлення-наряд на 2 окремі вкладки.
Створити новий Реєстр відомостей «Історія переписок в месенджерах».
Права на читання і зміну даємо тільки користувачам з повними правами.
5. Налаштування логування
«Включити логування обміну з E‑chat» (Так/Ні).
При включеному флагу:
При вимкненому флагу:
6. Вивести історію переписки в Замовлення-наряд
В документ замовлення-наряд на вкладці Комунікація додати 2 вкладки Viber та Telegram і на кожній вкладці виводити історію переписки відповідного месенджера. Повідомлення переписки відбираємо за 30 хв до дати створення і до дати фініша. Контрагента відбираємо по номерах телефону. Якщо дата фініша пуста, то по поточну дату. Доступ до вкладки даємо ролі Базові права УНФ.
6. HTTP-сервіс «Отримання історії переписок від E-chat»
Створити HTTP-сервіс в 1С, доступний по HTTPS.
Приймати дані методом POST в форматі JSON.
Валідовувати токен авторизації.
Обробляти вхідні дані:
Записувати повідомлення в реєстр «Історія переписок в месенджерах». В залежності від налаштування логування заповнюється логом