Часто задаваемые вопросы
Для доступа ко всем функциям VK CXhub зайдите с компьютера на платформу. Мобильная версия находится в разработке и не поддерживает все возможности сервиса. Мы рекомендуем использовать для работы браузер Google Chrome, как наиболее стабильный.
Для того, чтобы добавить или убрать кнопку «Начать», зайдите на страницу сообщества и перейдите в раздел «Управление». Затем в разделе «Сообщения» выберите пункт «Настройки для бота» и, при помощи галочки, выберите необходимое состояние кнопки.
Сервер необходим для обработки запросов из вашего сценария VK CXhub. Вам нужно выбрать сервер из предложенного списка или создать новый. Обратите внимание, что количество серверов для одного сообщества ограничивается 10.
При создании интеграции на платформе VK CXhub с использованием ключа доступа сообщества в списке автоматически создастся новый сервер, название которого будет начинаться с «CxHub». Выберите его и подтвердите изменения.
Бот, подключенный к сообществу, имеет доступ к событиям, связанным с сообществом и пользователями, взаимодействующими с ним. В зависимости от того, к каким событиям бот имеет доступ в конкретном сообществе, клиенты могут попадать в список после того, как вызывают то или иное событие. Например, подписка на сообщество или отправка сообщения. В этом случае пользователи в раздел Клиенты могут добавляться даже без запущенных сценариев в VK CXhub, но при наличии активной интеграции.
Вы можете настроить разрешения для бота в сообществе в разделе «Управление» → «Работа с API». На вкладке «Callback API» → «Типы событий».
Вы можете однократно настроить сценарий и создавать его копии, привязав каждую из них к необходимому сообществу. Для этого достаточно найти в списке сценариев необходимый, нажать на три точки в правой части и выбрать пункт «Создать копию».
После совершения указанных действий вы увидите в списке новый сценарий, название которого будет начинаться со слова «Копия», и вы сможете его отредактировать.
К одному сценарию можно подключить одну интеграцию. Но вы можете использовать внутри сценария внешние запросы в другие каналы. Для этого нужно предварительно настроить по шаблону или самостоятельно интеграции или запросы.
Вы можете, например, запустить каскадные рассылки Email, мессенджеры, SMS в рамках одного сценария. В VK CXhub вы можете найти готовый шаблон для такой рассылки. Он называется «Каскадная цепочка Email SMS».
Бот не сможет первым написать клиенту, это связано с ограничениями мессенджеров. Для того, чтобы запуск произошел, необходимо, чтобы клиент попал в сценарий, то есть совершил действие, которое выбрано в качестве шага входа в сценарии чат-бота.
Подробнее о первых шагах сценария вы можете узнать из инструкции: https://help.apicxhub.ru/perviy-shag-vhoda-v-stsenariy.
Вы можете загрузить базу с клиентами в виде CSV-файла, либо передать пользователей по API. Подробнее об этом вы можете прочитать в инструкции: https://help.apicxhub.ru/kak-importirovat-polzovateley. Но нужно учитывать, что для получения сообщений пользователь должен написать боту.
Запуск Email-рассылок возможен только для тех, кто дал согласие на их получение и на обработку персональных данных. Подробнее об этом можно узнать в инструкции: https://help.apicxhub.ru/soglasiya-na-rassilki.
1. Уточните запрос. Более точный запрос с большим количеством условий отрабатывает быстрее.
2. Удалите данные, которые не используете. Воспользуйтесь настройками автоудаления событий, чтобы сократить объем данных по которым выполняется поиск, это позволит снизить нагрузку. Учтите, что автоудаление событий происходит 1 раз в сутки, обычно в ночное время.
3. Упростите поиск по справочникам. При необходимости поиска по справочникам — используйте поиск по ID элемента справочника. Это существенно сократит время выполнения запроса. Для поиска по идентификатору нажмите на название переменной, в которой хранится связь со справочником, не раскрывая списка переменных справочника. Укажите Внешний ID тех элементов, по которым необходимо осуществить поиск.
4. Используете более точные условия. Некоторые операторы фильтров работают быстрее, чем другие. Например, быстрее отработают операторы «Равно» или «Любой из», если их использовать вместо «Содержит», «Начинается с», «Заканчивается на».
Вам необходимо выбрать, каким образом бот будет запускаться. Чаще всего применяется запуск по любому слову или по ключевым словам. Подробнее узнать о первых шагах вы можете в инструкции: https://help.apicxhub.ru/perviy-shag-vhoda-v-stsenariy.
Также можно создать ссылку с utm-меткой. Метка, содержащаяся в ссылке может влиять на сценарий бота, а также позволит вам получать информацию о разных источниках трафика. Подробнее об этом можно узнать, ознакомившись с инструкцией: https://help.apicxhub.ru/otsledit-perehod-v-chat-bot-po-utm-metke.
Если вам необходимо, чтобы определенный сценарий чат-бота запускался по конкретному слову или фразе, вы можете настроить это ограничение для бота, используя фильтр проверки на соответствие кодовому слову.
Например, вы можете запустить в сообществе чат-бота, выдающего промокоды. И установить его запуск по слову «Промокод». Для подобных фильтров используйте оператор «Любой из»: в нем через запятую вводите все возможные варианты написания ключевого слова. Клиенты могут писать сообщение со строчной или прописной буквы, могут использовать кавычки. Фильтр чувствителен к регистру и к каждому введенному символу, поэтому стоит заранее учитывать это при создании условий фильтрации.
Таким образом вы можете общаться с клиентами в сообществе, и бот не вмешается в диалог, пока клиент не напишет ключевое слово.
Скопируйте ссылку на группу, в которой находится ваш чат-бот, например: https://vk.com/cxhub. Чтобы сделать из этой ссылки ссылку на сообщения в группу, то есть на сообщения в чат-боте, замените com на me: https://vk.me/cxhub
Проверьте, нет ли в вашем сценарии ошибок с помощью инструкции: https://help.apicxhub.ru/ponyat-gde-oshibka-v-stsenarii.
Если вы подключили бота к сообществу ВК, пожалуйста, проверьте, что настройки сообщества соответствуют описанным в данной инструкции: https://help.apicxhub.ru/kak-podklyuchit-stsenariy-k-soobshchestvu-v-vk.
В случае, если вы всё проверили, не обнаружили ошибок, но бот все равно не отвечает, рекомендуем удалить интеграцию и создать ее заново. Если вы интегрировали сценарий чат-бота в сообщество ВКонтакте, удалите ключ, который вводили при интеграции, а затем создайте новый. После этого проверьте, что все поля в шагах сценария заполнены, интеграция подключена и запустите сценарий.
Если вы используете VK CXhub со стандартными функциями (без самостоятельно созданных внешних запросов), то ограничение ВКонтакте по количеству кнопок в сообщении: 6 кнопок (по 1 кнопке в строке, всего 6 строк с кнопками).
Если вам нужно использовать большее количество кнопок, то рекомендуем разделить их на несколько сообщений, при этом проверку можно делать после всех (основываясь на сообщении клиента). Иначе сообщение бота пользователь не получит, будет ошибка сценария.
Кнопки бывают привязаны к сообщению (inline), а бывают закреплены внизу (reply). Боты в разных мессенджерах имеют разные ограничения. Это проявляется и в настройках кнопок чат-бота.
Чтобы больше узнать об особенностях кнопок в мессенджерах, ознакомьтесь с документацией:
• VK Мессенджер
https://vk.cc/cAE8JQ
• Telegram
https://core.telegram.org/bots/api#replykeyboardmarkup
https://core.telegram.org/bots/api#inlinekeyboardmarkup
Если вы хотите, чтобы бот, подключенный к сообществу в ВКонтакте отвечал только новым клиентам и игнорировал сообщения от старых, вы можете воспользоваться дополнительным фильтром. Для реализации этой функции выполните следующие действия:
Сначала пройдите сценарий тестовым пользователем без использования фильтра для того, чтобы получить данные прохождения шагов.
Затем, на втором шаге сценария установите фильтр. В условиях выберите «Данные шагов» → «Реальные данные». В списке шагов найдите шаг с первым сообщением клиента и нажмите на него.
Перейдите в «raw_data» → «object» → «message»
В списке переменных найдите «conversation_message_id» и нажмите на него. В условиях фильтрации выберите «Целое число», «Равно» и в значение поставьте цифру 1.
Таким образом фильтр не будет пропускать в сценарий клиентов, которые писали ранее.
Для того, чтобы чат-бот не срабатывал на входящее сообщение клиента из чата, а только в чат-бот, подключенный к сообществу, настройте фильтр по данным шагов:
Сообщение клиента.raw_data.object.message.peer_id меньше 2000000000
Вы можете запросить данные из профиля клиента ВКонтакте, используя шаг «Получить данные клиента из VK профиля» и «Обновление переменной клиента». Для этого выполните: зайдите в Действия → Выполнить исходящий запрос → Сообщество ВКонтакте → Получить данные клиента из VK профиля.
Внутри шага выберите интеграцию — Аккаунт VK Groups, сразу добавится текстовое поле с VK ID пользователя. На этом шаге больше ничего заполнять не нужно.
Затем запустите сценарий и пройдите его тестовым клиентом. После этого добавьте шаг «Обновить переменные».
Войдите в шаг и выберите необходимые переменные из раскрывающегося списка (здесь возможен мультивыбор сразу нескольких переменных).
Нажмите на поле ввода, перейдите в «Реальные данные» и выберите VK ID тестового клиента.
Пройдите по пути, показанному на скриншоте ниже, чтобы посмотреть, какие данные клиента приходят в ответ на исходящий запрос.
Вы увидите список данных из профиля клиента VK. Найдите нужную переменную и нажмите на нее. Она автоматически добавится в поле ввода.
Если пользователь скрыл информацию на своей странице, ее в списке не будет.
Например, переменная «first_name», содержащая имя клиента, будет заполнена всегда. А, например, переменная «city» → «title», содержащая название города, заполнена не всегда (может быть приватной или незаполнена). Поэтому в этих случаях, при прохождении сценария пользователем, могут возникать ошибки.
Чтобы их избежать, добавьте в переменную проверку на пустое значение. Нажмите на значок в виде фигурных скобок около поля ввода. Вы увидите полный текст переменной. Добавьте в самый её конец параметр | df(" ")
