Интеграция с 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 - cоздание канала
POSТ/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.
Валидировать токен авторизации.
Обрабатывать входящие данные:
Записывать сообщение в регистр «История переписок в мессенджерах». В зависимости от настройки логирования заполняется логом
