В кейсе мы рассказали историю, как к нам пришел наш клиент с проблемой, и мы решили ее с помощью веб-хуков на CoreApp.

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

Для реализации понадобится:

Аккаунт с платным тарифом и запущенным курсом на CoreApp
Аккаунт Unisender
20 минут времени

Как добавить пользователя в список рассылки

В общих чертах, принцип работы веб-хуков на CoreApp такой: нужно создать веб-хук для курса и выбрать событие, и метод. В поле «Запрашиваемый URL», вставить URL, это адрес куда будет отправляться информация по достижению события, в нашем случае Unisender (пример ниже).

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

Ниже пример запрашиваемого URL, в нем используется метод «Subscribe». Этот метод добавляет email адрес в один или несколько списков рассылки.

Для чего он нужен и куда вставлять этот URL, смотрите ниже.


https://api.unisender.com/ru/api/subscribe?format=json&api_key=**API_KEY**&list_ids=**LIST_ID**&fields[email]={{user_email}}&fields[Name]={{user_name}}&double_optin=3

API_KEY — ключ API вашего аккаунта Unisender.

Чтобы его найти нажмите на кнопку в правом верхнем углу → «Настройки» → «Интеграция и API». В поле «Доступ к API», нажмите «Показать полностью» и скопируйте его.

LIST_ID — id списка (ов) рассылки, который уже создан в Unisender. В него будут добавлены все участники курса.

Чтобы его найти откройте «Контакты» → «Списки». Нужный номер в столбце «ID списка».

Так «Запрашиваемый URL» должен выглядеть в готовом виде


https://api.unisender.com/ru/api/subscribe?format=json&api_key=**API_KEY_вставьте_сюда**&list_ids=143&fields[email]={{user_email}}&fields[Name]={{user_name}}&double_optin=3

API_KEY — вставьте ваш ключ в URL вместо «API_KEY_вставьте_сюда»
LIST_ID — 143

Как добавить веб-хук на CoreApp

Чтобы добавить веб-хук, откройте вкладку «Курсы» → выберите курс → «Веб-хуки» → «Добавить веб-хук».

Далее необходимо выбрать событие, метод и вставить URL с API_KEY и LIST_ID в поле «Запрашиваемый URL».

Событие: «Ученик присоединился к курсу» — в список рассылки будут добавляться все новые ученики курса. Если в вашем курсе уже были ученики, тут разобрали как добавить их в список рассылки.

Метод: GET/POST.
Запрашиваемый URL: выше из примера, с вашим API_KEY и LIST_ID.

Обязательно сохраните веб-хук, нажав «Сохранить». Отлично! Теперь при достижении этого события, ученик будет добавлен в список рассылки.

Отправка писем

Метод «sendEmail» позволит нам отправлять e-mail письма. «Запрашиваемый URL» в общем виде:


https://api.unisender.com/ru/api/sendEmail?format=json&api_key=KEY &email
=TONAME <EMAILTO>&sender_name=
FROMNAME&sender_email=FROMMAIL&subject=SUBJECT
&body=HTMLBODY&list_id=X&attachments[filename1]=FILE1&attachments
[filename2]=FILE2&lang=LANG&error_checking=1&metadata[meta1]=
value1&metadata[meta2]=value2

API_KEY — ключ API вашего аккаунта Unisender.
LIST_ID — id списка рассылки, который уже создан в Unisender. В него будут добавлены все участники курса.
SENDER_NAME — имя отправителя письма.
SENDER_EMAIL — email отправителя письма.
SUBJECT — тема письма.
BODY — текст письма в формате html.

«Запрашиваемый URL» с подставленными данными:


https://api.unisender.com/ru/api/sendEmail?format=json&api_key=6wtfarp8t7ykddb56b7egd8z9xds3jx8ajorjcdo&email={{user_email}}&sender_name=Школа Фотографии&sender_email=m.ananikyan@coreapp.ai&subject=Учитель проверил задание!&body=<body>Учитель проверил твое задание! Скорее переходи в курс и смотри!<br><p><a href="https://coreapp.ai/app/player/course/65311e05b119d7167s79124d">Ссылка на курс</a></p></br></body>&list_id=143&lang=ru

В «Тело запроса» веб-хука на CoreApp, можно прописать ID конкретного урока. Тогда уведомления будут приходить только из данного урока. Если не добавлять эту переменную, то уведомления будут приходить из всех уроков курса.


{ 
"{{lesson_id}}": "LESSON_ID"
 }

Как будет выглядеть письмо

Потратив 20 минут своего времени, вы можете самостоятельно реализовать этот сценарий, и значительно повысить активность учеников в вашем курсе.

Полезные материалы

Сбор базы контактов и рассылка по ней
История нашего клиента: «Как собрать базу контактов и сделать по ней рассылку с минимальными вложениями»
Веб-хуки на CoreApp
Метод «Subscribe» на Unisender
Метод «sendEmail» на Unisender