Короткие определения терминов, которые встречаются в личном кабинете, API и статьях базы знаний.
Устройство аккаунта
Аккаунт — ваша учётная запись в Haskimail. Объединяет серверы, домены, пользователей, тариф и оплату.
Сервер (SMTP-сервер) — рабочая область внутри аккаунта: проект, клиент или окружение. У каждого сервера свои каналы, шаблоны, API-ключи и настройки отслеживания. В аккаунте до 3 серверов — см. «Лимиты аккаунта».
Сервер «Песочница» — сервер, письма из которого проходят все проверки, но не доставляются получателям. Нужен для тестов — см. «Сервер «Песочница»».
Канал отправки — поток писем одного типа внутри сервера. Бывает транзакционным (письма одному получателю в ответ на его действие) и маркетинговым (одинаковые письма многим получателям). У каждого канала свои SMTP-реквизиты, статистика, стоп-лист и вебхуки — см. «Каналы отправки».
Входящий канал — канал, который принимает письма и передаёт их вашему приложению в виде JSON — см. «Как принимать входящие письма».
Отправители и домены
Адрес отправителя — адрес в поле «От кого». Отправлять можно с подтверждённого адреса или с любого адреса подтверждённого домена. В кабинете он называется «обратный адрес».
Подтверждение домена — добавление DKIM- и SPF-записей в DNS домена, после которого с него можно отправлять письма с любого адреса — см. «Как подтвердить домен».
DKIM, SPF, DMARC — стандарты, по которым почтовые сервисы проверяют, что письмо действительно отправлено с вашего домена. Подробнее: DKIM, SPF, DMARC.
Return-Path — служебный адрес, на который почтовые серверы возвращают сообщения о недоставке. По умолчанию Haskimail использует свой домен, чтобы обрабатывать возвраты.
Ключи и доступ
Серверный API-ключ — ключ для отправки писем и работы с данными одного сервера. Передаётся в заголовке X-Haskimail-Server-Token.
API-ключ аккаунта — ключ для операций со всем аккаунтом: серверы, домены, перенос шаблонов, MCP-сервер. Передаётся в заголовке X-Haskimail-Account-Token.
SMTP-реквизиты — логин и пароль канала для отправки по SMTP. По ним Haskimail понимает, через какой канал отправить письмо.
Подробнее — в статье «Типы ключей».
Письма и события
Тег — метка письма, например welcome или order. По тегам фильтруют статистику и события. Метаданные — произвольные пары «ключ — значение», привязанные к письму. См. «Теги и метаданные писем».
MessageID — уникальный идентификатор письма, который API возвращает при отправке. По нему письмо связывают с событиями.
Возврат (bounce) — сообщение сервера получателя о том, что письмо не доставлено: жёсткий, мягкий, блокировка или спам-блокировка — см. «Возвраты, блокировки и жалобы на спам».
Жалоба на спам — получатель отметил доставленное письмо как спам.
Стоп-лист — адреса, на которые письма канала больше не отправляются: после жёсткого возврата, жалобы, отписки или добавленные вручную. В кабинете — вкладка «Стоп-списки» канала.
Вебхук — HTTP-запрос, который Haskimail отправляет на ваш URL при событии с письмом — см. «Модульные вебхуки».
Лог активности — список писем канала с их статусами и событиями за последние 45 дней.
Прогрев — постепенное увеличение объёма отправки с нового домена или IP-адреса, чтобы почтовые сервисы накопили о нём положительную историю — см. «Как прогреть домен».