Интеграция с inSales

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

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

• подключить магазин 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-ключи личного кабинета Haskimail.

2. В блоке Выпустить новый ключ введите название, например «inSales», выберите срок действия и нажмите Выпустить ключ. Нужен именно API-ключ аккаунта — серверный ключ здесь не подойдёт.

3. Скопируйте значение — оно показывается сразу после выпуска.

Если у вас ещё нет аккаунта Haskimail, зарегистрируйтесь бесплатно.

Не публикуйте ключ и не передавайте его третьим лицам. Если срок действия ключа закончится или ключ отзовут, письма из inSales перестанут уходить — тогда выпустите новый ключ и подключите его по инструкции ниже.

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

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

   

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

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

   

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

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

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

   

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

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

   • Канал — канал отправки;

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

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

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

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

   

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

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

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

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

   

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

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

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

   

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

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

   

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

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

   • Ненастроенные теги будут отображаться в квадратных скобках, например [order_id].

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

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

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

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

   

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

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

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

   

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

Как сменить API-ключ

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

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

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

3. Введите новый API-ключ аккаунта. Как его выпустить — в статье «Как создать API-ключ для аккаунта?».

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

Важно

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

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

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

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

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

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