Приложение **Haskimail для inSales** автоматически отправляет письма через[ Haskimail](https://haskimail.ru/) по событиям интернет-магазина на платформе[ inSales](https://www.insales.ru/).

Интеграция позволяет:

* подключить магазин inSales к аккаунту Haskimail с помощью API-токена;

* просматривать SMTP-серверы Haskimail;

* создавать правила отправки по схеме «событие → канал → шаблон → отправитель»;

* настраивать теги шаблона на основе данных webhook;

* просматривать письмо перед отправкой;

* отправлять тестовые сообщения;

* принимать webhook от inSales и автоматически отправлять письма;

* просматривать журнал отправок в приложении.

Письма можно отправлять по следующим событиям:

* создание заказа;

* изменение заказа;

* удаление заказа;

* создание товара;

* изменение товара;

* создание клиента;

* изменение клиента.

Чтобы настроить интеграцию, выполните следующие шаги.

---

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

1. Войдите в кабинет **inSales** с правами администратора.

2. Перейдите в раздел **Расширения → Каталог расширений**.

3. Найдите приложение **Haskimail для inSales** и нажмите **Установить**.

4. Дождитесь завершения установки.

5. Откройте Haskimail в списке установленных расширений.

---

## **Шаг 2. Подтвердите доступ приложения**

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

2. Подтвердите доступ.

3. После успешной авторизации откроется интерфейс приложения Haskimail.

---

## **Шаг 3. Получите API-токен Haskimail**

1. Перейдите в раздел[ Аккаунт → API-ключи](https://lk.haskimail.ru/?page=account&action=api_tokens) личного кабинета Haskimail.

2. Создайте новый или скопируйте существующий **API-токен аккаунта**.

3. Если у вас ещё нет аккаунта Haskimail,[ зарегистрируйтесь бесплатно](https://lk.haskimail.ru/registration.php?ref=&source=insales).

Не публикуйте API-токен и не передавайте его третьим лицам.

---

## **Шаг 4. Авторизуйтесь в приложении**

1. На странице **Подключение Haskimail** вставьте токен в поле **API-токен Haskimail**.

   \
   ![](https://chat.dashamail.ru/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdFpPIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--d2ea2d5134dbcb0e1587e64399db68860cd02c78/1.png)

   

2. Нажмите **Подключить**.

3. После успешной авторизации откроется раздел **SMTP** со списком доступных серверов.

   ![](https://chat.dashamail.ru/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdGRPIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--31e1138e0b059d5a17c261d600a2f2228d7d30b5/2.png)

   

---

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

1. Перейдите в раздел **Отправки → Настройка отправки**.

2. Нажмите **+ Создать правило**.

   ![](https://chat.dashamail.ru/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdGhPIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--a9980cd6a26b9ac1cfbfe84e7281f15753d1c15c/3.png)

   
   

3. Заполните параметры правила:

   * **Сервер** — SMTP-сервер Haskimail;

   * **Канал** — канал отправки (Message Stream);

   * **Событие** — webhook-событие inSales, например «Создание заказа»;

   * **Шаблон** — шаблон письма, созданный в Haskimail;

   * **От кого** — адрес отправителя.

4. Нажмите **Сохранить правило**.

   ![](https://chat.dashamail.ru/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdHRPIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--351ef91bc4601f2e22b5be0958335d15994aa67b/4.png)

5. Созданное правило появится в общем списке. Его можно включить или отключить с помощью переключателя **Отправка**.

---

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

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

1. В карточке правила нажмите **Настроить теги**. Если соответствия ещё не сохранены, кнопка может называться **Теги не заданы**.

   ![](https://chat.dashamail.ru/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdHhPIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--d1c857f3440957ca348cf511592f1ab27ad80cc5/5.png)

   

2. Для каждого тега шаблона выберите соответствующее поле webhook, например email клиента или ID заказа.

3. Для значений даты при необходимости выберите формат, например дд.мм.гггг.

4. Нажмите **Сохранить**.

   ![](https://chat.dashamail.ru/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdDlPIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--ed062f6fc37d3e072302e8a2d210c92754eebca9/6.png)

   

---

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

1. В карточке правила нажмите **Предпросмотр письма**.

   ![](https://chat.dashamail.ru/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdUJPIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--980a80ef185c119438595b43aa075c101522d48d/7.png)

   

2. Проверьте тему и содержимое письма.

   * Для настроенных тегов будут показаны названия сохранённых параметров.

   * Ненастроенные теги будут отображаться в формате [tag].

3. Введите тестовый email в нижней части окна.

4. Нажмите **Отправить тестовое письмо**.

5. Проверьте полученное письмо.

6. Закройте окно предпросмотра с помощью кнопки **×** или нажатием на затемнённую область.

   ![](https://chat.dashamail.ru/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdUZPIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--4ee26d00e5f20642ebccea2d06b282b286b696c4/8.png)

   

---

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

1. Перейдите в раздел **Логи**.

2. Проверьте статусы отправок, темы webhook и ответы API.

   ![](https://chat.dashamail.ru/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdUpPIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--42e9e09cddde7762d5335edd8d5b8fa0bd1d817e/9.png)

   

Более подробная информация доступна в личном кабинете Haskimail. Откройте настройки нужного канала отправки и перейдите в раздел **Лог активности**.

---

## **Шаг 9. Смените API-токен**

Если необходимо подключить другой аккаунт или заменить токен:

1. Откройте раздел **SMTP**.

2. Нажмите **Сменить токен**.

3. Введите новый API-токен.

4. Повторно подключите аккаунт Haskimail.

---

## **Важно**

* Для работы приложения необходим аккаунт Haskimail с настроенным доменом отправителя и созданными шаблонами писем.

* На одно webhook-событие рекомендуется создавать одно активное правило.

* После сохранения правила приложение автоматически регистрирует соответствующий webhook в inSales.

* Если тестовое письмо не отправляется, проверьте адрес отправителя, выбранный канал и журнал отправок.

* Подробные данные об отправке также можно посмотреть в разделе **Лог активности** личного кабинета Haskimail.

После выполнения этих шагов Haskimail будет автоматически отправлять письма по выбранным событиям интернет-магазина inSales.