Входящие сообщения
Раздел Входящие сообщения (/incoming-messages) — это единый «почтовый ящик» Orbita: сюда попадают письма с подключённого email-ящика и сообщения Telegram-бота, прежде чем превратиться в запись какой-либо сущности (заявку, обращение и т.д.).
Откуда берутся сообщения
| Канал | Источник |
|---|---|
| Письма из входящего ящика, подключённого по IMAP (настраивается на вкладке IMAP в Настройках) | |
| Telegram | Сообщения боту, подключённому на вкладке Telegram в Настройках — через вебхук или long polling |
Почта проверяется автоматически по расписанию; письма, которые уже были загружены, повторно не импортируются. Кнопка «Собрать почту сейчас» на вкладке IMAP настроек запускает проверку вручную, без ожидания расписания.
Список входящих сообщений
Таблица показывает все полученные сообщения независимо от канала:
| Колонка | Описание |
|---|---|
| ID | Внутренний номер сообщения |
| От кого | Имя и адрес отправителя (email) или идентификатор чата (Telegram); рядом — цветной бейдж канала |
| Тема | Тема письма (для Telegram — автоматически сформированная строка) и короткий фрагмент текста |
| Получено | Дата и время поступления |
| Статус | Новое или Обработано |
| Действия | Кнопки доступных действий для конкретного сообщения (см. ниже) |
Сверху — строка поиска по таблице и кнопка Обновить.
Статусы сообщения
- Новое — сообщение получено, но ещё не превращено ни в одну запись.
- Обработано — по сообщению было выполнено действие (вручную или автоматически); кнопки действий для него больше не показываются.
Просмотр сообщения
- Кликните на строку сообщения в таблице
- Справа откроется панель предпросмотра: отправитель, канал, дата получения, тема и тело сообщения (HTML-письма отображаются в безопасном изолированном окне, простой текст — как есть)
- Закрыть панель — кнопка с крестиком в её заголовке
В панели предпросмотра доступны те же кнопки действий, что и в таблице, если сообщение ещё не обработано.
Превращение сообщения в запись
Если для канала сообщения настроено хотя бы одно действие (правило), рядом с сообщением появляются кнопки с подписями, заданными администратором (например, «Создать заявку»). Список и поведение этих правил настраиваются на отдельном экране — Действия для входящих.
Нажатие кнопки действия:
- Запрашивает у сервера подготовленные данные — поля, которые удалось собрать из сообщения по правилам маппинга
- Помечает сообщение как Обработано
- Открывает форму создания записи нужной сущности с уже заполненными полями — администратору или оператору остаётся проверить и сохранить запись
Если для канала сообщения не настроено ни одного действия, кнопки не показываются — сообщение можно только просмотреть.
Повторная обработка
Каждое нажатие кнопки действия открывает новую форму создания записи. Отдельной функции «отменить обработку» или автоматического связывания ответа с уже существующей записью в интерфейсе нет — повторные письма по той же теме создают новую запись, если правило не написано так, чтобы находить и обновлять существующую (см. Действия для входящих).
Вложения
Вложения email-сообщений (файлы из письма) сохраняются на сервере и доступны по ссылке из исходного сообщения; при создании записи их можно прикрепить к ней вручную либо это может делать сценарий действия.