Підключення SendGrid для надсилання листів покупцям інтернет-магазину
Інтеграція із SendGrid допоможе автоматизувати надсилання електронних листів покупцям вашого інтернет-магазину після створення ними замовлення, що дозволить вам ефективніше комунікувати з вашими клієнтами. Електронний лист з деталями замовлення буде автоматично надіслано покупцю після створення замовлення на ту електронну адресу, яку він уведе в кошику в поле адреси ел. пошти.
Важливо: ця опція доступна лише на пробній та платних підписках.
Увага: перш ніж почати надсилати свої перші електронні листи за допомогою облікового запису SendGrid, вам потрібно створити ідентифікатор відправника (sender identity).
Ви можете авторизуватися у своєму акаунті на СендГрід або створити новий, перейшовши за цим посиланням.
Після авторизації, натисність на кнопку Settings (Налаштування) і далі у списці, що з’явиться нижче, необхідно вибрати пункт API Keys (АРІ-ключі):
Потім необхідно натиснути на кнопку Create API Key (Створити АРІ-ключ):
Далі потрібно вказати назву вашого API-ключа (довільна, латинськими літерами) у полі під назвою API Key Name ①, а потім вибрати варіант нижче, котрий називається Full Access (Повний доступ) та натиснути на кнопку Create & View (Створити та переглянути):
Важливо: має бути вибрано саме пункт “Full Access” для коректної роботи інтерації. За замовчуванням він є вибраним автоматично.
Готово, ваш API-ключ створено! Вам необхідно його скопіювати:
Примітка: ключ відобразиться тільки один раз, тому його необхідно відразу скопіювати. Проте у разі втрати цього ключа, ви можете просто створити новий, повторивши кроки вище.
Після того, як вищезазначений ключ скопійовано, натисність на кнопку Done (Готово).
Перейдіть у налаштування вашого сайту, у розділі Магазин відкрийте підрозділ Налаштування та перейдіть до вкладки Листи клієнтам:
Потім натисніть на кнопку Підключити праворуч у секції SendGrid.
Вставте раніше скопійований API-ключ у поле API-ключ ①:
У полі Ел. адреса відправника ② вкажіть адресу електронної пошти, яка буде відображатися як відправник у листах до покупців вашого інтернет-магазину.
Підказка: у листі відправник листа здебільшого зазначається у рядку від (from).
Натисніть на кнопку Зберегти у правому верхньому куті для збереження та активації інтеграції:
Важливо: листи надсилаються за івентом order_created, тобто в момент, коли покупець натискає на кнопку "Купити" в кошику. Це відбувається, навіть якщо покупець не здійснив оплату у підключеній до сайту платіжній системі.
Після підключення інтеграції листи до ваших покупців міститимуть стандартний текст за замовчуванням, який ви можете відредагувати або змінити на власний. Для цього:
У полі Тема листа ③ ви можете вказати власну тему листа до ваших покупців, наприклад, зазначити назву вашого магазину тощо:
Примітка: за замовчуванням у темі вказується текст Ми отримали ваше замовлення — {{instance.website_domain}}, де замість змінної {{instance.website_domain}} підставляється домен вашого сайту, наприклад, example.com.
У великому полі Шаблон листа ④ ви можете вказати текст вашого листа, який надсилатиметься покупцям після створення ними замовлення. Для відображення таблиці з переліком товарів та іншими деталями замовлення, у тексті розташована змінна {{{order.formatted.products_table_html}}} — на її місці у листі буде підставлена таблиця з деталями про замовлення (товари, сума замовлення тощо). Аналогічно нижче розташовані інші змінні, зокрема з відображенням деталей про покупця (те, що покупець увів у полях кошика) та інформація про вибраний метод доставки.
Підказка: ви можете персоналізувати текст і додати до нього ваш контактний номер телефону та назву своєї компанії (наприклад, на початку або ж наприкінці листа).
Нижче під полем для тексту листа ви можете натиснути на кнопку Показати змінні щоб відкрити модальне вікно з переліком змінних, які можна використовувати у тексті:
Якщо скопіювати певну змінну та додати до тексту, то у відправленому покупцеві листі замість змінної буде відображено (підставлено) необхідні вам дані. Наприклад, таким чином ви можете відобразити у тексті номер чи суму замовлення, домен вашого сайту тощо.
Примітка: змінні, які відповідають за короткі текстові значення, розташовані у подвійних фігурних дужках (наприклад, {{order.code}}). Але змінні, на місці яких будуть підставлятися блоки інформації, розташовані у потрійних дужках. Наприклад, вищезгадана змінна {{{order.formatted.products_table_html}}} — вона розташована всередині між трьома фігурними дужками з обох боків.
У полі Заголовок ⑤ нижче ви можете вказати для себе внутрішню назву цієї інтеграції. Вона відображатиметься у вкладці "Листи клієнтам" у налаштуваннях сайту — це може знадобитися у разі підключення кількох інтеграцій, щоб відрізняти їх між собою.
Важливо: на безкоштовному тарифі від SendGrid ви можете надсилати до 100 електронних листів на день. Якщо вам потрібно більше, цей ліміт є змога розширити. Докладнішу інформацію про це можна знайти тут.
Якщо у вас налаштовані методи оплати, то нижче у розділі Надсилати листи, якщо вибрано метод оплати синіми галочками можна відмітити ті платіжні методи, під час оплати якими будуть надсилатися листи:
За замовчуванням активовані усі платіжні методи, але якщо ви бажаєте, щоб під час оплати саме певним платіжним методом лист не надсилався, ви можете деактивувати цей платіжний метод.
Підказка: це може бути корисним, коли ви використовуєте платіжну систему, яка також автоматично надсилає листи вашим покупцям, наприклад, як WayForPay. Або ж якщо ви бажаєте налаштувати інтеграцію і текст листа в ній окремо для різних методів оплати (відповідно в одній інтеграції із SendGrid залишити ввімкнутими одні методи оплати, в іншій інтеграції — інші методи оплати).
Знизу налаштувань інтеграції у розділі Тестування листа ви можете натиснути на кнопку Надіслати, щоб ми надіслали вам тестовий лист на електронну пошту, яку ви використовуєте для входу в свій акаунт на Weblium:
Таким чином ви можете перевірити зовнішній вигляд листа та протестувати цей функціонал з боку отримувача листа.
Важливо: у кошику неодмінно має бути присутнє поле для уведення електронної адреси (і варто зробити його обов'язковим до заповнення), щоб система мала інформацію про те, куди надсилати справжній (не тестовий) лист. Детальніше щодо додавання полів у кошик можна дізнатися тут.
У разі потреби ви можете, не видаляючи, призупинити роботу цієї інтеграції. Для цього поверніться до вкладки Листи клієнтам та деактивуйте перемикач навпроти SendGrid:
Важливо: ця опція доступна лише на пробній та платних підписках.
Увага: перш ніж почати надсилати свої перші електронні листи за допомогою облікового запису SendGrid, вам потрібно створити ідентифікатор відправника (sender identity).
Отримання API-ключа на боці SendGrid
Ви можете авторизуватися у своєму акаунті на СендГрід або створити новий, перейшовши за цим посиланням.
Після авторизації, натисність на кнопку Settings (Налаштування) і далі у списці, що з’явиться нижче, необхідно вибрати пункт API Keys (АРІ-ключі):
Потім необхідно натиснути на кнопку Create API Key (Створити АРІ-ключ):
Далі потрібно вказати назву вашого API-ключа (довільна, латинськими літерами) у полі під назвою API Key Name ①, а потім вибрати варіант нижче, котрий називається Full Access (Повний доступ) та натиснути на кнопку Create & View (Створити та переглянути):
Важливо: має бути вибрано саме пункт “Full Access” для коректної роботи інтерації. За замовчуванням він є вибраним автоматично.
Готово, ваш API-ключ створено! Вам необхідно його скопіювати:
Примітка: ключ відобразиться тільки один раз, тому його необхідно відразу скопіювати. Проте у разі втрати цього ключа, ви можете просто створити новий, повторивши кроки вище.
Після того, як вищезазначений ключ скопійовано, натисність на кнопку Done (Готово).
Підключення SendGrid до інтернет-магазину на боці Weblium
Перейдіть у налаштування вашого сайту, у розділі Магазин відкрийте підрозділ Налаштування та перейдіть до вкладки Листи клієнтам:
Потім натисніть на кнопку Підключити праворуч у секції SendGrid.
Вставте раніше скопійований API-ключ у поле API-ключ ①:
У полі Ел. адреса відправника ② вкажіть адресу електронної пошти, яка буде відображатися як відправник у листах до покупців вашого інтернет-магазину.
Підказка: у листі відправник листа здебільшого зазначається у рядку від (from).
Натисніть на кнопку Зберегти у правому верхньому куті для збереження та активації інтеграції:
Важливо: листи надсилаються за івентом order_created, тобто в момент, коли покупець натискає на кнопку "Купити" в кошику. Це відбувається, навіть якщо покупець не здійснив оплату у підключеній до сайту платіжній системі.
Кастомізація теми та тексту листа
Після підключення інтеграції листи до ваших покупців міститимуть стандартний текст за замовчуванням, який ви можете відредагувати або змінити на власний. Для цього:
У полі Тема листа ③ ви можете вказати власну тему листа до ваших покупців, наприклад, зазначити назву вашого магазину тощо:
Примітка: за замовчуванням у темі вказується текст Ми отримали ваше замовлення — {{instance.website_domain}}, де замість змінної {{instance.website_domain}} підставляється домен вашого сайту, наприклад, example.com.
У великому полі Шаблон листа ④ ви можете вказати текст вашого листа, який надсилатиметься покупцям після створення ними замовлення. Для відображення таблиці з переліком товарів та іншими деталями замовлення, у тексті розташована змінна {{{order.formatted.products_table_html}}} — на її місці у листі буде підставлена таблиця з деталями про замовлення (товари, сума замовлення тощо). Аналогічно нижче розташовані інші змінні, зокрема з відображенням деталей про покупця (те, що покупець увів у полях кошика) та інформація про вибраний метод доставки.
Підказка: ви можете персоналізувати текст і додати до нього ваш контактний номер телефону та назву своєї компанії (наприклад, на початку або ж наприкінці листа).
Нижче під полем для тексту листа ви можете натиснути на кнопку Показати змінні щоб відкрити модальне вікно з переліком змінних, які можна використовувати у тексті:
Якщо скопіювати певну змінну та додати до тексту, то у відправленому покупцеві листі замість змінної буде відображено (підставлено) необхідні вам дані. Наприклад, таким чином ви можете відобразити у тексті номер чи суму замовлення, домен вашого сайту тощо.
Примітка: змінні, які відповідають за короткі текстові значення, розташовані у подвійних фігурних дужках (наприклад, {{order.code}}). Але змінні, на місці яких будуть підставлятися блоки інформації, розташовані у потрійних дужках. Наприклад, вищезгадана змінна {{{order.formatted.products_table_html}}} — вона розташована всередині між трьома фігурними дужками з обох боків.
У полі Заголовок ⑤ нижче ви можете вказати для себе внутрішню назву цієї інтеграції. Вона відображатиметься у вкладці "Листи клієнтам" у налаштуваннях сайту — це може знадобитися у разі підключення кількох інтеграцій, щоб відрізняти їх між собою.
Важливо: на безкоштовному тарифі від SendGrid ви можете надсилати до 100 електронних листів на день. Якщо вам потрібно більше, цей ліміт є змога розширити. Докладнішу інформацію про це можна знайти тут.
Додаткові налаштування
Відправка листів залежно від методу оплати
Якщо у вас налаштовані методи оплати, то нижче у розділі Надсилати листи, якщо вибрано метод оплати синіми галочками можна відмітити ті платіжні методи, під час оплати якими будуть надсилатися листи:
За замовчуванням активовані усі платіжні методи, але якщо ви бажаєте, щоб під час оплати саме певним платіжним методом лист не надсилався, ви можете деактивувати цей платіжний метод.
Підказка: це може бути корисним, коли ви використовуєте платіжну систему, яка також автоматично надсилає листи вашим покупцям, наприклад, як WayForPay. Або ж якщо ви бажаєте налаштувати інтеграцію і текст листа в ній окремо для різних методів оплати (відповідно в одній інтеграції із SendGrid залишити ввімкнутими одні методи оплати, в іншій інтеграції — інші методи оплати).
Надсилання тестового листа
Знизу налаштувань інтеграції у розділі Тестування листа ви можете натиснути на кнопку Надіслати, щоб ми надіслали вам тестовий лист на електронну пошту, яку ви використовуєте для входу в свій акаунт на Weblium:
Таким чином ви можете перевірити зовнішній вигляд листа та протестувати цей функціонал з боку отримувача листа.
Важливо: у кошику неодмінно має бути присутнє поле для уведення електронної адреси (і варто зробити його обов'язковим до заповнення), щоб система мала інформацію про те, куди надсилати справжній (не тестовий) лист. Детальніше щодо додавання полів у кошик можна дізнатися тут.
Деактивація інтеграції
У разі потреби ви можете, не видаляючи, призупинити роботу цієї інтеграції. Для цього поверніться до вкладки Листи клієнтам та деактивуйте перемикач навпроти SendGrid:
Оновлено: 27/09/2024
Дякуємо!