Документация

Электронная почта

Входящая электронная почта (IMAP) и исходящая. Сохранение цепочек, разбор вложений.

Электронная почта

Канал электронной почты принимает ваши входящие письма и позволяет pipeline отвечать, пересылать или создавать задачи ниже по цепочке.

Модель

Два взаимодополняющих модуля:

  • email_inbound — приём (IMAP)
  • email_outbound — отправка (настроенный оператор или ретрансляция через ваш SMTP)

Они независимы: вы можете использовать только модуль входящей почты (для сортировки без ответа) или только модуль исходящей почты (для отправки уведомлений из pipeline, запущенного иным способом).

Настройка

  1. Администрирование → Электронная почта → Почтовые ящики — подключите почтовый ящик IMAP с его учётными данными.
  2. Сопоставьте почтовый ящик с целевым pipeline.
  3. (Опционально) Настройте отправителя (SMTP) для ответа.

Для архитектур, которым необходимо сохранять контроль над своими почтовыми серверами, betool не заменяет ваш MTA: мы читаем и записываем через стандартные IMAP / SMTP.

Что получает pipeline

Для каждого входящего письма создаётся новый exchange со следующими данными:

  • exchange.user_message — тело письма (HTML → нормализованный текст)
  • exchange.email.subject — строка темы
  • exchange.email.from — нормализованный отправитель
  • exchange.email.thread_id — идентификатор цепочки (полезен для многоходового контекста)
  • exchange.email.attachments — список FileMetadata (разобранные вложения)

Вложения

Вложения передаются в узел file_transform для извлечения (обычный текст, OCR для отсканированных PDF, структурированный разбор для CSV / Excel). Начиная с этого момента ваш агент может работать с ними так, как если бы это был исходный текст.

Цепочки и многоходовой контекст

Когда клиент отвечает на предыдущий ответ, betool распознаёт thread_id и восстанавливает историю цепочки в контексте агента. Для проектирования pipeline это прозрачно.

Известные ограничения

  • Пока нет нативной поддержки MS Exchange EWS (вы можете предоставить Exchange по IMAP).
  • Нет поддержки Microsoft Graph для Office 365 (в дорожной карте).
  • Разбор очень старых писем (вложенный RTF Outlook 2003) может потерять часть форматирования.