События Вконтакте

Интеграция по событиям Вконтакте позволяет получать в CRM клиентов, которые
- вступили в ваше сообщество,
- написали сообщение в ваше сообщество,
- оставили комментарий к посту в вашем сообществе.

ВАЖНО! Если вы хотите разместить наш календарь или расписание групп в вашем сообществе для записи учеников, используйте раздел CRM "Для сайта" и добавьте виджет. Подробнее в статьях Помощи "Интеграция с сайтом и Вконтакте: расписание, приложение Вк, формы для заявок".

Интеграция состоит из трех шагов:
- подготовка,
- создание ключа в сообществе,
- настройка интеграции в CRM.

Шаг 1. Подготовка

Для начала мы рекомендуем вам создать "служебную" группу - в нее будут попадать нужные вам клиенты. Это необязательный шаг, но так вам будет удобнее с ними работать. 

Для этого в CRM создайте программу "Лиды" или, например, "Прочие" или "Служебные группы". Тип у программы можно указать "Курс/групповые занятия", вид оплаты "Единой суммой/в рассрочку", цена - 0 р. В программе создайте группу с названием, например, "Из Вконтакте":

ВАЖНО! Мы рекомендуем отключить опции оповещения о записи в такую группу, отображение в виджетах и личном кабинете учеников, т.к. группа "служебная", то есть используется только для ваших внутренних нужд.

Вы можете создать несколько групп - каждая из них для своего события в сообществе. Например, с названиями "Вступили в сообщество", "Написали сообщение", "Оставили комментарий".
 

Шаг 2. Создание ключа

Перейдите в ваше сообщество Вконтакте, нажмите на "Управление":

Выберите раздел "Работа с API" и во вкладке "Ключи доступа" нажмите на "Создать ключ":

В окне создания ключа отметьте следующие опции:
- Разрешить приложению доступ к управлению сообществом
- Разрешить приложению доступ к сообщениям сообщества
- Разрешить приложению доступ к стене сообщества

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

После подтверждения ключ будет создан:

Не закрывайте вкладку, нам потребуется вернуться к ней далее.
 

Шаг 3. Настройка интеграции в CRM "Мой Класс"

Перейдите в раздел CRM "Настройки - Интеграции". Нажмите "+ Интеграция":

В селекторе "Выберите сервис" выберите "События Вконтакте":

Вы можете создавать несколько интеграций по событиям - каждая для своего сообщества. Поэтому в названии мы рекомендуем указывать, к какому сообществу относится данная интеграция, чтобы различать их в общем списке.

В поле "Адрес сообщества" вставьте адрес вашего сообщества, скопированный из браузера:

Теперь нам понадобится секретный ключ. Мы создавали его на шаге 1. Вернитесь к вкладке с ключами в вашем сообществе. Выделите ключ и скопируйте его:

Теперь вставьте его в поле "Секретный ключ" в окне настройки интеграции.

Нажмите "Проверить". Если все сделано верно, рядом с кнопкой появится зеленая галочка:

Если что-то не так, то красная:

В этом случае проверьте, что правильно вставлен адрес сообщества и секретный ключ.

ВАЖНО! Если вы закрыли вкладку в вашем сообществе, то при заходе в раздел Вконтакте "Управление сообществом - Работа с API" в списке ключей вы увидите ключ вот так:

Это сделано для безопасности. Не нужно копировать его со звездочками. Вам нужно увидеть ключ целиком. Нажмите на "Показать". Для показа ключа Вконтакте запросит подтверждение.

Вам придет уведомление на телефон - push или смс. Выполнив действие на телефоне или введя код из смс, вы сможете увидеть ключ целиком. Только тогда вам нужно его копировать.

Теперь в блоке окна интеграции в CRM "Настройка событий в сообществе" отметьте те действия пользователей в вашем сообществе в Вконтакте, в ответ на которые будет создаваться контакт в CRM "Мой Класс" и/или записываться в группу.

ВАЖНО! Вы должны выбрать как минимум одно событие, чтобы сохранить интеграцию. В противном случае она не будет иметь смысла.

При выборе любого события опция "Создавать контакт в CRM (если его еще нет в базе)" включается автоматически - иначе событие будет бесполезным.

При создании контакта согласно правилам Вконтакте мы можем получать в нашу CRM следующие данные:
- имя и фамилия пользователя,
- его id в сети Вконтакте (адрес страницы),
- дату рождения (если указана полностью),
- номер телефона (если он открыт самим пользователем).

Последнее означает, что номер телефона мы можем получать не всегда. А Email к передаче из Вконтакте вообще запрещен.

Проверка на уникальность при создании контакта выполняется по следующему алгоритму:
1) система проверяет базу в вашем аккаунте CRM на наличие адреса страницы клиента (он указывается в поле "Вконтакте" в признаках клиента в CRM). Если такой адрес найден, контакт не дублируется.
2) Если адрес не найден, система ищет в базе контакт по номеру телефона, если он открыт пользователем на своей странице Вконтакте. Если номер скрыт, то проверка на уникальность выполняется только по id Вконтакте (адресу его страницы).

ВАЖНО! Поэтому если у ваших текущих клиентов в базе не заполнен адрес Вконтакте, а номер телефона скрыт пользователем Вк, то у вас могут в системе появляться дубли контактов, т.е. разные контакты, по сути являющиеся одним и тем же клиентом. Избежать этого в указанных случаях нельзя.

При этом если контакт найден, то его данные дополняются данными из Вконтакте (день рождения и/или номер телефона, и/или адрес страницы Вк), если эти данные в клиенте в CRM не заполнены.

Вы можете не просто создавать контакт, а записывать его в группу. Для этого мы на этапе подготовки как раз создавали "служебную" группу. Отметим опцию "Записывать в группу" и выберем ее:

Теперь контакты будут автоматически попадать в группу, а вы будете получать информацию о записи. По таким клиентам можно вести отдельно работу - например, делать рассылки и вести комментарии.

При этом для каждого вида события, как мы говорили выше, вы можете создавать свою группу и записывать клиентов по группам отдельно. Так вы поймете, кто просто вступил в сообщество, а кто вам написал.

Осталось указать источник - "Откуда узнал" (по умолчанию) для таких клиентов и записей. Вы можете создать свой источник, чтобы в отчетах быстро находить всех таких клиентов. При этом "канал создания" (т.е. способ, которым создан клиент или заявка) останется отдельным системным полем - "События Вконтакте". Он тоже выводится в отчетах.

Сохраните интеграцию, нажав кнопку "Добавить":

Интеграция создана:

Клиенты из Вк теперь попадают в CRM:

ВАЖНО! Т.к. номер телефона открыт не всеми пользователями, а в карточке клиента в CRM он является обязательным, то если вам нужно отредактировать клиента, вам придется указать какой-то "свой" номер.