Руководство пользователяАналитика электронной почты

Аналитика электронной почты

Автоматически классифицируйте входящие электронные письма, извлекайте данные документов с помощью AI и сопоставляйте электронные письма со счетами, предложениями и квитанциями.

Превратите общий почтовый ящик в папку входящих документов

Email Intelligence предоставляет вашей компании выделенный почтовый ящик, который отслеживает входящие сообщения, идентифицирует деловые документы, извлекает ключевые данные и предлагает ссылки на нужные записи в NomadBill. Он разработан с учетом того, как уже работают фрилансеры и небольшие команды: поставщики отправляют счета по электронной почте, клиенты отвечают на предложения, а подтверждения оплаты приходят в один и тот же почтовый ящик.

Почтовый ящик агента

Каждая компания получает один выделенный почтовый ящик агента в формате agent_name@agent.nomadbill.co. Если в вашей рабочей области используется собственный домен агента, вместо этого почтовый ящик использует этот домен.

Только владелец компании может предоставить почтовый ящик. Во время установки NomadBill нормализует имя агента в формат, безопасный для почтового ящика, преобразуя его в нижний регистр, заменяя пробелы дефисами и ограничивая длину фрагмента 40 символами.

После начала подготовки NomadBill:

  • создает почтовый грант с помощью Nylas — сохраняет подключение к почтовому ящику в записи company_email_accounts
  • регистрирует вебхук для событий входящей почты

Вебхук прослушивает следующие события:

  • message.created
  • message.updated
  • grant.expired

NomadBill регистрирует вебхук по адресу /api/public/nylas-webhook. Во время первоначального установления соединения веб-перехватчика обработчик GET возвращает параметр запроса challenge точно в том виде, в каком он был получен.

Как обрабатываются входящие электронные письма

Каждое новое сообщение следует одному и тому же процессу обработки, поэтому результаты остаются согласованными и исключается дублирование работы.

Получить событие вебхука

Nylas отправляет событие веб-перехватчика /api/public/nylas-webhook при создании или обновлении сообщения или по истечении срока действия гранта.

NomadBill может проверить заголовок x-nylas-signature с помощью HMAC-SHA256. Проверка подписи не является обязательной, но ее следует рассматривать как рекомендуемую производственную настройку.

Получить полное письмо

После поступления действительного события NomadBill извлекает полное содержимое электронного письма и метаданные из подключенного почтового ящика.

Система также защищает от дублирующей обработки. Если то же письмо уже было заполнено, пропущено или все еще обрабатывается в течение пяти минут, NomadBill не анализирует его снова.

Пропускать сообщения, которые не следует анализировать

NomadBill пропускает сообщения, отправленные из самого почтового ящика агента. Эта защита собственной электронной почты предотвращает образование петель и анализ почты, сгенерированной системой.

Исходящие или нерелевантные сообщения также могут быть исключены во время классификации, если они не представляют собой пригодный для использования бизнес-документ.

Загрузка вложений и содержимого сообщения

Перед выполнением анализа документа процессор собирает тело электронного письма и все доступные вложения.

Это дает классификатору достаточный контекст, чтобы распознать, содержит ли сообщение счет, квитанцию, предложение, подтверждение или другой тип документа.

Запустите классификацию и извлечение AI.

NomadBill отправляет содержимое электронной почты в конвейер AI, используя google/gemini-3.6-flash через шлюз Lovable AI.

Модель классифицирует документ и извлекает структурированные поля, такие как итоговые суммы, даты, имена и ссылочные номера, чтобы вы могли просматривать их внутри NomadBill вместо копирования данных вручную.

Вычислить соответствующие предложения

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

Каждому возможному совпадению присваивается балл. NomadBill сохраняет предложения, соответствующие минимальному порогу, и первым показывает самых сильных кандидатов.

Сохраните результат и сохраните свои решения

Окончательный анализ сохраняется вместе с записью электронной почты, включая извлеченные данные и предлагаемые ссылки.

Если вы уже связали или отклонили предложение, NomadBill сохранит это решение при последующем повторном анализе, а не сбрасывает вашу работу.

Классификация документов

Email Intelligence классифицирует каждое проанализированное сообщение к одному из следующих типов документов:

  • incoming_invoice
  • receipt
  • outgoing_invoice
  • quote
  • payment_confirmation
  • reminder
  • contract
  • other

Классификация помогает NomadBill решить, какие действия предложить дальше. Например, только электронные письма incoming_invoice и receipt можно преобразовать непосредственно в запись входящего счета.

AI-извлеченные данные

Результат анализа может включать следующие извлеченные поля.

doc_typestring
Required

Обнаруженный тип документа для электронного письма.

confidencenumber

Показатель достоверности модели для результата классификации.

summarystring

Краткое описание того, что содержится в электронном письме или вложении.

document_numberstring

Основной счет, квитанция, предложение или номер подтверждения, обнаруженные в документе.

reference_numbersarray

Дополнительные ссылочные идентификаторы, найденные в электронном письме или во вложении.

total_amountnumber

Общая валовая сумма, обнаруженная для документа.

net_amountnumber

Чистая сумма до НДС, когда она указана в документе.

vat_amountnumber

Сумма НДС, извлеченная из документа.

vat_percentagenumber

Скорость НДС, когда ее можно надежно идентифицировать.

currencystring

Обнаруженный код валюты для суммы документа.

document_datestring

Дата выдачи указана в документе.

due_datestring

Срок платежа, если таковой имеется.

vendor_namestring

Имя поставщика или отправителя, связанное с документом.

customer_namestring

Имя клиента, указанное в документе.

ibanstring

Номер банковского счета, обнаруженный в электронном письме или документе.

categorystring

Широкая категория, присваиваемая в ходе анализа.

ocr_textstring

Извлеченный текст документа, используемый для последующей классификации и сопоставления.

line_itemsarray

Обнаружены отдельные позиции из документа, если вложение содержит подробные сведения.

Сопоставление и предложения

После анализа NomadBill ищет связанные записи в вашем рабочем пространстве и оценивает каждого кандидата. Чтобы предложение появилось, оно должно набрать минимальный балл 0.35, и система возвращает до 12 предложений на одно электронное письмо.

Механизм сопоставления оценивает несколько типов записей:

  • счета-фактуры
  • коммерческие предложения
  • входящие счета
  • банковские операции
  • клиенты

Для счетов-фактур самыми сильными сигналами являются номер документа, сумма, получатель и личность клиента. Модель оценки добавляет баллы за:

  • найден номер: +0.55
  • сумма в пределах примерно ±0.5% или ±0.02: +0.30
  • соответствие валюты: +0.05
  • дата в течение 14 дней: +0.10
  • sent_to содержит адрес электронной почты отправителя: +0.25.
  • совпадение имени клиента: +0.15

Для банковских транзакций механизм фокусируется на доказательствах платежа и идентификации контрагента. Он добавляет баллы за:

  • соответствие суммы: +0.45
  • найден номер кандидата: +0.35
  • совпадение имени аналога: +0.20
  • дата в течение 30 дней: +0.10

Клиентам система пытается определить, кому принадлежит электронное письмо, прежде чем предлагать операционные записи. Он добавляет баллы за:

  • точное совпадение адреса электронной почты: +0.80
  • тот же домен: +0.50
  • совпадение имени: +0.30

Эти оценки суммируются, поэтому сильные совпадения обычно сочетают в себе несколько сигналов одновременно, а не зависят от одного поля.

Управление ссылками электронной почты

NomadBill отслеживает, как каждое электронное письмо связано с вашими записями. Ссылки могут находиться в одном из трех состояний:

  • Предлагается — NomadBill нашел вероятное совпадение и ждет вашего отзыва.
  • Связано — вы подтвердили, что электронное письмо принадлежит конкретному счету, предложению, квитанции, транзакции или клиенту.
  • Отклонено — вы отклонили предложение, и это решение сохраняется, если электронное письмо будет проанализировано еще раз.

Используйте карточку «Информация об электронной почте» в представлении электронной почты, чтобы просмотреть извлеченные поля, проверить предложения и подтвердить или отклонить совпадения. Если электронное письмо уже связано с записью, связанные действия с электронной почтой также отображаются с другой стороны на страницах счетов, предложений, квитанций, транзакций и сведений о клиенте.

Если тип документа — incoming_invoice или receipt, вы можете создать входящий счет прямо из электронного письма. Действие createReceiptFromEmail использует извлеченные данные документа для предварительного заполнения новой записи и позволяет избежать создания дубликатов, когда электронное письмо уже было обработано или намеренно пропущено.

Обновления Email Intelligence практически в реальном времени. NomadBill прослушивает активность почтового ящика через Supabase Realtime на company_email_accounts.last_event_at и при необходимости возвращается к 30-секундному циклу опроса.

Похожие руководства