Грамотная интеграция ВКонтакте с GetCourse

Суть «грамотной интеграции» в том, что, создавая заказ из ВК (или по любому другому событию), вы можете попросить у подписчика правильный email. Вместо [email protected] (как это стандартно в Геткурсе). И не терять таким образом важный канал связи.

Общая настройка интеграции

• Откройте раздел Сообщества;

• Подключите нужное (если еще не) на вкладке «Все, где я админ»;
• Нажмите на «Настройки» в карточке сообщества;
• В GetCourse введите после домена вашего аккаунта адрес: /saas/account/api и перейдите по нему. Там вы найдете «имя аккаунта» (Account name) и «секретный ключ».
• Заполните поле Имя аккаунта в GetCourse. Обычно это поддомен сайта getcourse.ru. Например, если базовый домен skyjoom.getcourse.ru, то имя аккаунта: skyjoom. Найти можно в поддоменах, или на на странице с секретным ключом.
• Заполните поле Секретный ключ GetCourse API. Перейдя по адресу /saas/account/api сгенерируйте «секретный ключ» с правами на чтение и запись и скопируйте его в это поле.

После этого заработают действия:

• «Зарегистрировать в GetCourse» — создаст пользователя и, если нужно, добавит его в группу.
• «Создать заказ в GetCourse» — создаст пользователя (если такого нет), добавит его в группу (опционально), а также создаст заказ. По какому именно предложению создавать заказ GetCourse поймет по названию и цене или по уникальному коду предложения. Подробнее ниже.

Подписчики (основы интеграции)

На данный момент GetCourse дает возможность управлять по API привязкой профиля соцсети к профилю Геткурса для возможных рассылок в будущем (поле «Подключен VK». Важно! Это не привязка ссылки к карточке для возможной авторизации!).

Значение этого поля можно получать потом в процессах в виде переменной {object.vk_id} или {object.user.vk_id}.

Но я рекомендую также настроить дополнительное поле (для надежности и возможности вручную этим управлять). Добавление и настройка дополнительного поля делается так:

• Захóдите в раздел «Пользователи» (…/pl/user/user/index);
• В правом верхнем углу списка есть ссылка «Дополнительные поля»;
• Переходите туда, нажимаете «Добавить поле» → «Строка» (число может отрабатывать неправильно!).

• И в его «Заголовке» обязательно прописываете vk_uid.
  Советую именно скопировать;
• Все. Осталось нажать «Сохранить» в конце страницы и готово.

Это поле (в заполненном виде) вам будет необходимо для отправки запросов в Автопилот. А также сам Автопилот будет автоматически прописывать в него ID профиля подписчика в ВК при отправке запросов в Геткурс.

Что делать, если понадобиться прописать этот ID вручную. Лучший вариант:

• Открыть карточку подписчика (профиль);
• Найти подписчика в ВК по имени, фамилии, почте, переписке и другим признакам.
• В блоке «Уточнение о соц. сетях» (карточки профиля в GetCourse) в поле Vkontakte вставить ссылку на профиль подписчика в ВК.
  И Сохранить профиль.
• После сохранения: 1) подписчик нажимая «Войти через ВКонтакте» на странице входа в GetCourse будет попадать на свой профиль; 2) в левой колонке у вас появится много полезной информации с ВК. В первую очередь id.
• Вот значение этого id отсюда максимально удобно скопировать и вставить во вторую колонку в уже созданное доп. поле vk_uid.

Интеграция на стороне Автопилота

Речь о том, как хранятся данные подписчика. В Автопилоте просто в Базе Данных в табличке «Пользователи» хранятся: email, id VK и другие поля.

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

Благодаря этому можно даже не прописывая vk_uid и не подключая ВК, запускать события в Автопилоте для подписчиков по их email (если конечно он сохранен в Автопилоте).

Также второй важный пункт — если email пользователя сохранен, то Автопилот больше не будет просить его «отправить почту», а будет использовать сохраненную.

Группы подписчиков

Подписка на группу Геткурса возможна из обоих вариантов действий. Достаточно всего лишь прописать нужные группы в поле «Названия групп подписчиков» через запятую. Пробел после запятой не нужен.

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

Заказы — Вариант 1 — По названию и цене

Из-за особенностей работы API GetCourse (упомянутых выше), для корректной работы интеграции, согласно этому варианту, нужно придерживаться следующих правил:

• Название продукта должно быть точно такое же как название предложения! На 100%.
• Если вы создаете заказ по сообщению из раздела товары в ВК и используете переменные в действии «Создать заказ в GetCourse», то это же название должно быть прописано и в ВК.
• Цена в действии (или в разделе товары) должна быть точно такой же как и в предложении. При этом в предложении не должно быть скидок и прочего, влияющего на цену. Или будет создано новое предложение.
• Также в предложении должен быть выбран всего один продукт! Тот что с таким же названием, как в предложении. Ну или GetCourse сам позаботится о том, чтобы заказ выдал доступ только к нему.

Пример подходящего предложения вы сможете увидеть на скриншоте ниже. Если GetCourse не найдет подходящего предложения или продукта, то он создаст их сам! Со стандартными настройками. Это и преимущество и недостаток (в зависимости от задач).

Заказы — Вариант 2 — По уникальному коду предложения

Вариант поинтереснее, так как имеет минимум ограничений. Единственное, что вам нужно контролировать — это цену.

Почти все настройки предложения останутся теми же, что установили вы (Например, название и продукты). Только цена будет взята из параметров действия Автопилота (или из переменной).

Уникальный код приложения необходимо прописывать вручную. Поле для этого находится в предложении на вкладке «Настройки».

Другими словами это «второе название» (только спрятанное), поэтому там допустимы почти любые символы. Хотя лично я, все же, для надежности рекомендую испол. числа. Например, удобно туда прописать ID товара в ВК.

100% нельзя использовать кавычки: ' или ''. Тогда Геткурс не найдет предложения и вернет ошибку!

Для универсальности вы можете переменную %vk_product_title% переместить из поля «название» в поле «универсальный код» (в действии Автопилота). А в GetCourse в настройках предложения в поле «Универсальный код предложения» прописать названия продуктов из раздела товары в ВК.

Тогда заказ товара из ВК будет вызывать именно конкретное предложение, с нужными продуктами и названиями, только с ценой указанной в ВК.

Заявки

Заявкой в GetCourse называется заказ с нулевой ценой. Вроде все просто и классно, можно запускать произвольные процессы, используя скрытую заявку и делать вообще что угодно. Или просто выдавать доступ к бонусу.

Но с заявками в API GetCourse есть особенности. При создании заказа по API покупка для этого заказа не создается в автоматическом режиме, соответственно не выдаются права доступа к тренингу/группе для пользователя.

Чтобы это исправить можно передавать заказы в аккаунт со статусом «В работе» и далее с помощью настроенного процесса автоматически переводить такой заказ в статус «Завершён». После этого для заказа будет создана покупка, доступ будет выдан. В предложении при этом лучше отключить галочку «Завершать заказ автоматически при получении оплаты»

Хотя для «запуска произвольных процессов» можно статус и на «Отменен» менять. Все равно от этого нужна только возможность многоразового повтора простого события.

Для тех, кто захочет покреативить и решит запускать произвольный процесс по пользователю, если он попал в группу (а в самом процессе удалять оттуда, чтобы можно было добавить повторно). Предупреждаю сразу, я так делал, сработает только для первого раза. Для следующих нужно будет удалить «задачи» перед повторным запуском.

Важно

Тут правила диктует GetCourse. Поэтому если вам кажется, что можно было бы сделать круче, например просто по ID предложения, то пишите это, пожалуйста им (в техподдержку Геткурса или его разработчикам).

Готовим команду

Не менее важный пункт это то, с каким email Автопилот зарегистрирует подписчика. Чтобы корректно попросить у него почту, стоит к секции события добавить условие «Есть email». И не забыть в условие добавить «Реакцию на невыполнение» (под кнопочкой Еще в блоке условия). Пример ниже:

Примечание: даже если подписчик не отправит в ответ почту сразу, а напишет вопрос и админ с ним пообщается (сколько угодно времени), то как только он все-таки отправит свой email, ему тут же будет создан заказ.

Если вы не добавите это условие, то будет создан подписчик с примерочным нерабочим email [email protected] (где 00000 — id подписчика в ВК). Да, так же, как и при стандартной интеграции GetCourse с VK.

То есть, да, у вас есть возможность даже не просить у подписчика корректную почту, если для вашей модели бизнеса не важен канал общения «по email».

Заказ можно создавать используя событие «Написал сообщение» (в том числе и для раздела «Товары» вашего сообщества).

Переменные и возвращаемые данные

В действиях, которые в команде расположены по порядку после запроса к GetCourse, доступны некоторые полезные переменные.

Оба типа действий GetCourse в первую очередь возвращают ID подписчика в GetCourse для которого был выполнен запрос. Его можно использовать в других действиях (например, уведомлениях админу) благодаря переменной %api_subs_id%.

Например, ссылка на карточку подписчика в GetCourse:
https://account.getcourse.ru/user/control/user/update/id/%api_subs_id%
Не забудьте поменять ↑ домен аккаунта на свой!

Для заказов доступны еще 2 полезные переменные. ID заказа: %api_deal_id%, например, для формирования ссылки на заказ администратору:
https://account.getcourse.ru/sales/control/deal/update/id/%api_deal_id%

А также готовая ссылка на страницу оплаты заказа: %payment_link%.

Пример настроенных действий команды заказа:

Если у вас осталось много вопросов или вам сложно во всем этом разбираться, можете заказать у нас консультацию или настройку интеграции под ключ в разделе товары сообщества Автопилота. Также по уточняющим (и вообще любым) вопросам можно писать в сообщения сообщества.

P. S. Более подробное описание вместе с видео будет добавлено позже.

P. P. S. В Геткурсе еще много интересного в плане интеграции. Например доп. поля или UTM. Это все есть в планах, но будет реализовано немного потом. После серии других более приоритетных задач.