Плагин Haskimail для WordPress отправляет письма через Haskimail в ответ на события сайта и магазина на WooCommerce: регистрацию, вход, новый комментарий, оформление заказа и другие.

С плагином можно:

* настроить отправку письма на нужное событие WordPress или WooCommerce;
* выбрать шаблон письма;
* отправить тестовое письмо и посмотреть, как его увидит получатель;
* посмотреть журнал отправленных писем.

Чтобы настроить отправку, пройдите семь шагов:

1. Установите плагин.
2. Подключите аккаунт Haskimail.
3. Проверьте серверы.
4. Создайте правило отправки.
5. Настройте теги шаблона.
6. Проверьте письмо.
7. Проверьте отправку в журнале.

## Перед началом работы

Подготовьте:

* **Аккаунт Haskimail.** Если его ещё нет, [зарегистрируйтесь бесплатно](https://lk.haskimail.ru/registration.php?source=wordpress).
* **API-ключ.** В кабинете Haskimail откройте **Аккаунт → API-ключи** или перейдите по [ссылке](https://lk.haskimail.ru/?page=account&action=api_tokens).
* **SMTP-сервер, канал отправки и шаблон письма** в аккаунте Haskimail. Метки в шаблоне записываются в двойных фигурных скобках, например `{{name}}`. Подробнее — в статье «[Использование шаблонов в Haskimail](https://help.haskimail.ru/hc/haskimail/articles/1768996255-ispolzovanie-shablonov-v-haskimail)».

WooCommerce устанавливать не обязательно: события WordPress работают и без магазина. Письма о заказах отправляются, только если WooCommerce установлен.

## Шаг 1. Установите плагин

1. Установите и активируйте плагин в разделе **Плагины**.
2. Откройте пункт **Haskimail** в меню слева.

## Шаг 2. Подключите аккаунт

1. Вставьте API-ключ в поле **API-токен Haskimail**.
2. Нажмите **Подключить**.

Чтобы сменить ключ, откройте раздел **SMTP** и нажмите **Сменить токен**. Чтобы отключить аккаунт, нажмите **Отключить Haskimail**.

## Шаг 3. Проверьте серверы

Откройте раздел **SMTP**. Здесь показаны серверы аккаунта: имя, статус, SMTP API, открытия и переходы.

Если список пуст, проверьте API-ключ или создайте SMTP-сервер в кабинете Haskimail.

## Шаг 4. Создайте правило отправки

Правило определяет, какое письмо, через какой сервер и канал отправится после события на сайте.

1. Откройте раздел **Отправки** и нажмите **Создать правило**.
2. Заполните поля:
   * **Сервер** — SMTP-сервер Haskimail.
   * **Канал** — канал отправки этого сервера. Список каналов появится после выбора сервера.
   * **Событие** — после чего отправлять письмо. Сначала в списке идут события WordPress, затем — WooCommerce.
   * **Шаблон** — шаблон из выбранного канала.
   * **От кого** — адрес отправителя, например `shop@example.ru`.
3. Нажмите **Сохранить правило**.

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

### Кому уходит письмо

Письмо получает участник события:

| Событие | Получатель |
| --- | --- |
| Регистрация, вход, выход, сброс пароля, изменение профиля, удаление пользователя | Этот пользователь |
| Новый комментарий | Автор комментария |
| Публикация записи | Автор записи |
| Создание заказа, изменение заказа | Покупатель, указанный в заказе |

### Какие события поддерживаются

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

Из событий WooCommerce плагин отправляет письма при создании и изменении заказа. Остальные события магазина тоже есть в списке — отдельной группой.

## Шаг 5. Настройте теги шаблона

Теги связывают метки `{{...}}` в шаблоне с данными события.

1. В карточке правила нажмите **Теги**.
2. Для каждой метки выберите поле события. Если выбрать **Не подставлять**, тег останется без данных.
3. Если нужно, выберите формат даты.
4. Нажмите **Сохранить теги**.

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

## Шаг 6. Проверьте письмо

1. Нажмите **Предпросмотр** в карточке правила или на странице тегов.
2. Проверьте отправителя, тему и текст письма.
3. Введите свой адрес в поле **Тестовый email** и нажмите **Отправить тестовое письмо**.

## Шаг 7. Проверьте отправку в журнале

В разделе **Журнал** видно, отправлено письмо или нет.

Если у события не было адреса получателя, письмо не уйдёт, а в журнале появится ошибка «В событии нет email получателя».