> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.weblium.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Подключение SendGrid для отправки писем покупателям интернет-магазина

Интеграция с **SendGrid** поможет автоматизировать отправку электронных писем покупателям вашего интернет-магазина после создания ими заказа, что позволит вам эффективнее коммуницировать с вашими клиентами. Электронное письмо с деталями заказа будет автоматически отправлено покупателю после создания заказа на тот электронный адрес, который он введёт в корзине в поле адреса эл. почты.

||| ${color}[#F97700](Важно:) эта опция доступна только на пробной и платных подписках.
||| ${color}[#F97700](Внимание:) прежде чем начать отправлять свои первые электронные письма с помощью учетной записи SendGrid, вам нужно создать [идентификатор отправителя (sender identity)](https://app.sendgrid.com/guide).

# Получение API-ключа на стороне SendGrid

1. Вы можете авторизоваться в своём аккаунте в СендГрид или создать новый, перейдя по [этой ссылке](https://login.sendgrid.com/login/identifier).

2. После авторизации нажмите на кнопку **Settings** (Настройки), а затем в появившемся ниже списке выберите пункт **API Keys** (API-ключи):
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/sendgrid-1_1961zt6.png)

3. Затем необходимо нажать на кнопку **Create API Key** (Создать API-ключ):
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/sendgrid-2_hqo4vy.png)

4. Далее нужно указать название вашего API-ключа (произвольное, латинскими буквами) в поле под названием **API Key Name** **①**, а затем выбрать вариант ниже, который называется **Full Access** (Полный доступ) и нажать на кнопку **Create & View** (Создать и просмотреть):
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/sendgrid-3_1k538if.png)

||| ${color}[#F97700](Важно:) для корректной работы интеграции должен быть выбран пункт “Full Access”. По умолчанию он выбирается автоматически.

5. Готово, ваш API-ключ создан!
Вам необходимо его скопировать:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/sendgrid-4_kp5kp2.png)

|| ${color}[#FFA800](Примечание:) ключ отобразится только один раз, поэтому его необходимо сразу скопировать. В случае потери этого ключа, вы можете просто создать новый, повторив шаги выше. 

После того, как вышеуказанный ключ скопирован, нажмите на кнопку **Done**.

# Подключение SendGrid к интернет-магазину на стороне Weblium

1. Перейдите в настройки вашего сайта, в разделе **Магазин** откройте подраздел **Настройки** и перейдите на вкладку **Письма клиентам**:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/sendgrid-2-ru-1_16d6zt9.png)

Далее нажмите на кнопку **Присоединить** справа в секции **SendGrid**.

2. Вставьте ранее скопированный API-ключ в поле **API-ключ** **①**:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/sendgrid-2-ru-2_1ae44xh.png)

3. В поле **Эл. адрес отправителя** **②** укажите адрес электронной почты, который будет отображаться как отправитель в письмах покупателям вашего интернет-магазина.

| ${color}[#1AA900](Подсказка:) в письме отправитель письма обычно указывается в строке `от` (`from`).

4. Нажмите кнопку **Сохранить** в правом верхнем углу для сохранения и активации интеграции:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/sendgrid-2-ru-3_10bxexe.png)

||| ${color}[#F97700](Важно:) письма отправляются за ивентом `order_created`, то есть в момент, когда покупатель нажимает на кнопку "Купить" в корзине. Это происходит, даже если покупатель не произвёл оплату в подключённой к сайту платёжной системе.

### Кастомизация темы и текста письма
После подключения интеграции письма вашим покупателям будут содержать стандартный текст по умолчанию, который вы можете отредактировать или заменить на собственный. Для этого:

1. В поле **Тема письма** **③** вы можете указать свою тему письма для ваших покупателей, например, указать название вашего магазина и так далее:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/sendgrid-2-ru-4_41r60.png)

|| ${color}[#FFA800](Примечание:) по умолчанию в теме указывается текст `Мы получили ваш заказ — {{instance.website_domain}}`, где вместо переменной `{{instance.website_domain}}` подставляется домен вашего сайта, например, `example.com`.

2. В большом поле **Шаблон письма** **④** вы можете указать текст вашего письма, который будет отправляться покупателям после создания ими заказа. Для отображения таблицы с перечнем товаров и другими деталями заказа, в тексте расположена переменная `{{{order.formatted.products_table_html}}}` — на её месте в письме будет подставлена таблица с деталями о заказе (товары, сумма заказа и т.д.). Аналогично ниже расположены другие переменные, в частности с отображением деталей о покупателе (то, что покупатель ввёл в полях корзины) и информация о выбранном методе доставки.

| ${color}[#1AA900](Подсказка:) вы можете персонализировать текст и добавить в него ваш контактный номер телефона и название вашей компании (например, в начале или в конце письма).

3. Ниже под полем для текста письма вы можете нажать на кнопку **Показать переменные**, чтобы открыть модальное окно с перечнем переменных, которые можно использовать в тексте:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/sendgrid-2-ru-5_u4hpui.png)

Если скопировать переменную и добавить её в текст, то в отправленном покупателю письме вместо переменной будут отображены (подставлены) нужные вам данные. Например, таким образом вы можете отобразить в тексте номер или сумму заказа, домен вашего сайта и т.д.

|| ${color}[#FFA800](Примечание:) переменные, которые отвечают за короткие текстовые значения, размещены в двойных фигурных скобках (например, `{{order.code}}`). Однако переменные, на месте которых будут подставляться блоки информации, размещены в тройных фигурных скобках. Например, вышеупомянутая переменная `{{{order.formatted.products_table_html}}}` — она размещена внутри между тремя фигурными скобками с обеих сторон.

4. В поле **Заголовок** **⑤** ниже вы можете указать для себя внутреннее название этой интеграции. Она будет отображаться во вкладке "Письма клиентам" в настройках сайта — это может понадобиться в случае подключения нескольких интеграций, чтобы различать их между собой.

||| ${color}[#F97700](Важно:) на бесплатном тарифе от SendGrid вы можете отправлять до 100 электронных писем в день. Если вам нужно больше, данный лимит есть возможность расширить. Более подробную информацию об этом можно найти [здесь](https://app.sendgrid.com/guide).

### Дополнительные настройки

###### Отправка писем в зависимости от метода оплаты
Если у вас настроены методы оплаты, то ниже в разделе **Отправлять письма, если выбран метод оплаты** синими галочками можно отметить те платёжные методы, при оплате которыми будут отправляться письма:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/sendgrid-2-ru-7_atu5d5.png)

По умолчанию активированы все платёжные методы, но если вы хотите, чтобы при оплате определённым платёжным методом письмо не отправлялось, вы можете деактивировать этот платёжный метод.

| ${color}[#1AA900](Подсказка:) это может быть полезным, когда вы используете платёжную систему, которая также автоматически отправляет письма вашим покупателям, например, как [WayForPay](https://help.weblium.com/ru/article/podklyuchenie-wayforpay-v-kachestve-platyozhnogo-metoda-13m2uqo/). Либо если вы хотите настроить интеграцию и текст письма в ней отдельно для различных методов оплаты (соответственно в одной интеграции с SendGrid оставить включенными одни методы оплаты, в другой интеграции — другие методы оплаты).

###### Отправка тестового письма
Внизу настроек интеграции в разделе **Тестирование письма** вы можете нажать на кнопку **Отправить**, чтобы мы отправили вам тестовое письмо на электронную почту, которую вы используете для входа в свой аккаунт на Weblium: 
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/sendgrid-2-ru-6_kzobev.png)

Таким образом вы можете проверить внешний вид письма и протестировать этот функционал со стороны получателя письма.

||| ${color}[#F97700](Важно:) в корзине непременно должно присутствовать поле для ввода электронного адреса (и стоит сделать его обязательным к заполнению), чтобы система имела информацию о том, куда отправлять настоящее (не тестовое) письмо. Подробнее о добавлении полей в корзину можно узнать [здесь](https://help.weblium.com/ru/article/nastrojki-korziny-v-internet-magazine-rrd0ty/#1-nastrojki-korziny-v-internet-magazine).

###### Деактивация интеграции
В случае необходимости вы можете, не удаляя, приостановить работу этой интеграции. Для этого вернитесь на вкладку **Письма клиентам** и деактивируйте переключатель напротив **SendGrid**:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/sendgrid-2-ru-7_1x1jfew.png)