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

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

Как подключить бота к сообществу ВКонтакте

1. Добавьте глобальный интент $TEXT

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

Перейдите на вкладку Сценарий вашего бота.

В любом месте сценария кликните + ДОБАВИТЬ ЭКРАН и добавьте блок Интенты.



Кликните Создать интент.



Скопируйте и вставьте в поле интента:

$TEXT

Обязательно поставьте галочку Сделать доступным из любой точки сценария.



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

Нажмите Сохранить.

Далее, сделайте связь $TEXT со стартовым экраном:



А остальные примеры фраз можете связать с соответствующими экранами:



Предскажите все варианты реакции

Если вы будете добавлять блок Интенты на другие экраны сценария, убедитесь, что на всех экранах у вас связана с чем-либо Любая другая фраза. Также, можете на другие экраны добавлять НЕглобальный интент $TEXT и использовать его вместо "Любая другая фраза".

Зачем это нужно?

Допустим, на стартовом экране у вас есть глобальный блок интентов, содержащий переменную $TEXT. "Глобальный блок" означает, что он подцепляет запрос с любого места сценария, если сообщение не попадает в "местные" интенты. Если в другом месте сценария у вас есть блок интентов, содержащий фразы "Сделать заказ" и "Получить помощь", а пользователь пишет что-то совершенно другое, то ввод пользователя попадает в глобальный блок интентов, и пользователь будет перенаправлен на стартовый экран к самому началу сценария.

Поэтому, если вы добавляете на любой экран сценария блок интентов, обязательно связывайте с чем-то вариант "Любая другая фраза", иначе ввод попадёт в глобальный $TEXT.



2. Включите сообщения и возможности ботов

Перейдите в ваше сообщество Вконтакте. Перейдите в Управление - Настройки - Сообщения сообщества -> Включены. И нажмите Сохранить.

В поле Приветствие вы можете поместить приветствие или инструкцию по взаимодействию с ботом.



Пользователь увидит этот текст, когда нажмёт на кнопку "Написать сообщение".



Также этот текст может быть отправлен пользователю, если доступ к боту был совершён по ссылке на диалог (см. пункт 6 данной инструкции). Либо, если пользователь нажал Написать сообщение, а затем Перейти к диалогу с сообществом.

3. Включите возможности ботов

Перейдите на вкладку Настройки для бота - Возможности ботов -> Включены.



Поставьте галочку напротив пункта Добавить кнопку "Начать"



Тогда пользователи, впервые открывшие диалог с сообществом, увидят кнопку "Начать":



Зачем нужна эта кнопка?

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

Чтобы кнопка работала, не забудьте добавить в сценарий бота глобальный интент $TEXT - см. пункт 1 данной статьи.

ВАЖНО: Если вы включаете параметр "сообщения сообщества" в первый раз - обязательно примите дисклеймер ВКонтакте о правилах использования ботов.

4. Получите ключ доступа

Откройте раздел Управление - Настройки - выберите вкладку Работа с API и нажмите Создать ключ.



Выберите разрешения как показано на рисунке и нажмите кнопку Создать. Если не поставить галочку напротив "фотографий", то изображения не будут работать в сценарии.



Скопируйте полученный ключ доступа.



Рекомендуем скопировать этот ключ в блокнот, так как для повторного получения ключа вам снова нужно будет получать смс. К тому же, ключ может понадобится вам для выполнения уроков, в которых нужно использовать API ВК.



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



Убедитесь, что следующие права были выданы:
управление сообществом
сообщения сообщества
фотографии

Если вам в дальнейшем понадобится снова получить ключ, вы можете нажать Показать:



Также, вы можете удалить ключ, чтобы пересоздать его:



5. Подключите канал VK в Aimylogic

Перейдите в сценарий вашего бота в Aimylogic и нажмите на вкладку Каналы:



Нажмите на кнопку ВКонтакте:



В появившемся окне вставьте скопированный ранее токен в поле Ключ.

Вы также можете добавить название группы/сообщества в поле Имя.

Затем, нажмите Подключить.



6. Как сделать доступ к диалогу с сообществом по прямой ссылке?

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

Вернитесь к шагу №2 данной инструкции и убедитесь, что вы разместили приветственное сообщение в настройках сообщества.

Затем сгенерируйте ссылку на диалог. Ссылка должна выглядеть так: https://vk.com/im?sel=-NNN, где NNN - id вашего сообщества. Вы можете получить эту ссылку, кликнув правой кнопкой мыши на кнопке "Написать сообщение" на главной странице сообщества, и затем выбрать "Копировать адрес ссылки".



Далее всё будет зависеть от того, как пользователь найдёт бота. Если вы разместите ссылку на сообщение сообществу и новые пользователи воспользуются ей, то они увидят приветственное сообщение от бота:



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



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

Уроки Aimylogic
Продвинутые инструменты

В случае трудностей

Если бот отвечает "Извините, непонятно", обратитесь к этой статье.

Если вам не удается подключить канал ВК, либо бот не отвечает на сообщения, обратитесь к этой статье.
Была ли эта статья полезна?
отменить
Спасибо!