Trigger on Mailhook

Описание узла

Mailhook — это триггер-узел, который запускает сценарий при получении письма на уникальный автоматически сгенерированный email-адрес. Он используется для автоматизации процессов на основе входящих писем — например, обработки уведомлений, сообщений от клиентов или системных оповещений.

Настройка узла

После добавления узла Mailhook автоматически генерируются два email-адреса:

Production Email — используется в опубликованном сценарии. Сценарий срабатывает каждый раз при получении письма. Остаётся активным, пока сценарий работает.
Development Email — используется для тестирования. Сценарий срабатывает один раз при получении письма, после чего автоматически останавливается.

Оба email-адреса отображаются в поле Path узла и могут быть скопированы для использования.

Использование

Чтобы запустить сценарий, просто отправьте письмо на один из адресов Mailhook.

Примеры:

Ручная отправка письма из почтового клиента, например Gmail или Outlook;
Получение автоматических email-уведомлений от сторонних сервисов;
Использование Mailhook как точки входа для коммуникации с клиентами.

Вход

Mailhook не принимает данные от предыдущих узлов. Он запускает сценарий исключительно на основе входящих писем.

Выход

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

Пример выходных данных:

{
  "headers": [
    {
      "key": "subject",
      "value": "Example Subject"
    },
    {
      "key": "from",
      "value": "Sender Name <[email protected]>"
    }
    // ...
  ],
  "from": {
    "address": "[email protected]",
    "name": "Sender Name"
  },
  "to": [
    {
      "address": "[email protected]",
      "name": ""
    }
  ],
  "subject": "Example Subject",
  "messageId": "<[email protected]>",
  "date": "2025-05-19T09:26:58.000Z",
  "html": "<div>Hello</div>",
  "text": "Hello",
  "attachments": [
    {
      "filename": "document.pdf",
      "mimeType": "application/pdf",
      "disposition": "attachment",
      "related": true,
      "contentId": "<unique-content-id>",
      "content": {}
    }
  ]
}

Описание полей:

headers — массив всех оригинальных заголовков письма (пары key/value).
from — имя и email-адрес отправителя.
to — список получателей (обычно только ваш адрес Mailhook).
subject — тема письма.
messageId — уникальный идентификатор письма.
date — дата и время отправки письма (формат ISO).
html — HTML-версия тела письма.
text — текстовая версия тела письма.
attachments — массив объектов файлов, прикреплённых к письму.

Поля объекта вложения:

filename — имя прикреплённого файла.
mimeType — MIME-тип файла.
disposition — обычно "attachment", может быть также "inline".
related — true, если это часть содержимого письма (например, встроенное изображение).
contentId — идентификатор для inline-ссылок (например, <image1@cid>).
content — содержимое файла.

Тестирование и отладка

Для отладки используйте Development Email адрес. Сценарий выполнится один раз и остановится, что позволяет безопасно тестировать логику и изучать структуру выходных данных.

На этой странице