Каналы связи

Перед началом работы необходимо настроить каналы коммуникации (ВК, MAX, Telegram и email), через которые ваши клиенты смогут зарегистрироваться в системе лояльности, получать уведомления и рассылки.

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

Бот VK

1. Откройте веб-версию ВКонтакте.
2. Перейдите в сообщество, в котором будет настроен бот.
3. В меню сообщества откройте раздел «Управление».
4. Перейдите во вкладку «Дополнительно».
5. Выберите пункт «Работа с API».
6. Нажмите «Создать ключ» и скопируйте его.

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

• Разрешить приложению доступ к сообщениям сообщества
• Разрешить приложению доступ к фотографиям сообщества

⚠️ Важно: если не выдать эти разрешения, рассылка работать не будет.

7. Откройте платформу bonus-bot.
8. Перейдите в раздел «Каналы» → «Бот VK».
9. Вставьте ранее скопированный ключ в поле «Ключ доступа сообщества (токен бота)».
10. Скопируйте URL для Callback API.

11. Вернитесь во ВКонтакте (Callback API) и вставьте URL в поле «Адрес».
12. Найдите строку «Строка, которую должен вернуть сервер» и скопируйте её значение (на скриншоте выглядит так: 998a880f).

13. Вернитесь в bonus-bot и вставьте значение в поле «Строка подтверждения».
14. Нажмите «Сохранить».

15. Вернитесь во ВКонтакте и нажмите «Подтвердить».

Если всё сделано правильно — появится сообщение об успешном подтверждении.
Если возникла ошибка — проверьте каждый шаг и повторите настройку.

16. Перейдите во вкладку «Типы событий» и отметьте:

• Входящее сообщение
• Исходящее сообщение
• Редактирование сообщения
• Действия с сообщениями

17. Перейдите в раздел «Сообщения» → «Настройки для бота».
18. Для строки Возможности ботов выберите Включены и отметьте чек-бокс «Добавить кнопку “Начать”».

⚠️ Важно: Убедитесь, что на платформе bonus-bot в разделе «Магазин» → «Профиль» → «Контакты» указана ссылка на то сообщество ВКонтакте, которое настраивали в качестве канала связи.

Бот Telegram

Временно недоступен

Бот MAX

Если у вас ещё нет бота в MAX, создайте его по инструкции

После создания бота:

1. Получите токен бота (информация есть в инструкции)
2. Перейдите в раздел Каналы → Бот MAX.
3. Вставьте токен в поле «Токен бота».
4. Нажмите «Сохранить».

Уведомления по почте

1. Создайте новый или используйте существующий почтовый ящик для отправки уведомлений (рекомендуется Яндекс Почта).

2. Создайте пароль приложения:

• Перейдите в профиль Яндекса
• Откройте «Настройки»
• Перейдите в раздел «Почтовые программы»
• Отметьте доступ: IMAP (imap.yandex.ru)

• Перейдите в раздел «Безопасность»
• Нажмите «Создать пароль приложения»
• Выберите доступ «Почта»
• Укажите имя пароля
• Скопируйте сгенерированный пароль

3. Откройте платформу b.bonus-bot → Каналы → Почта.

4. Заполните настройки:

• Логин — адрес электронной почты
• Пароль — пароль приложения (скопированный ранее)
• SMTP-сервер — smtp.yandex.ru
• Порт — 465

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

Проверка настроек

• В поле «Проверка настроек» укажите альтернативный email
• Нажмите «Отправить»

Если всё настроено правильно — вы получите тестовое письмо.

Админ ВК для сотрудников

Этот бот подключается опционально. Через админ-бот можно выполнять основные операции с бонусами прямо из чата ВКонтакте.

Он полезен, если:

• нестабильный мобильный интернет
• доступ разрешён только к «белому списку» сайтов
• нет возможности работать через админку в браузере

Админ-бот работает в отдельном сообществе. Для него необходимо:

1. Создать отдельное закрытое сообщество в ВК
2. На платформе перейти в раздел Каналы → ВК Админ для сотрудников
3. Включить переключатель «Включить админ-бот»
4. Выполнить аналогичные настройки, как для клиентского бота (см. инструкцию Бот VK),
   но во вкладке «ВК Админ для сотрудников»

⚠️ Важно: сообщество, созданное для админ-бота, не следует добавлять в контакты магазина — оно предназначено только для служебного пользования.

⚠️ Важно: клиентский и админ-бот — это разные системы.
Они используют разные токены и разные адреса сервера и не пересекаются.

Добавление сотрудников в Админ ВК

После настройки необходимо добавить сотрудников в белый список VK ID.

1. Попросите сотрудника открыть диалог с сообществом и нажать «Начать»
2. Бот сообщит об отсутствии прав и отобразит VK ID сотрудника
3. Скопируйте этот ID

Далее:

1. Перейдите в раздел Каналы → ВК Админ для сотрудников
2. Найдите поле «Белый список VK ID»
3. Вставьте ID сотрудника
4. При необходимости добавьте комментарий
5. Нажмите «Добавить», затем «Сохранить»

После этого сотрудник сможет:

• искать клиентов (например, по последним 4 цифрам телефона)
• начислять и списывать бонусы

💡 Бот работает со всей клиентской базой, а не только с пользователями ВКонтакте.

Включение каналов связи

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

1. Перейдите в раздел «Магазин»
2. Откройте вкладку «Вход и регистрация»
3. Включите нужные каналы

⚠️ Важно: Убедитесь, что в разделе «Магазин» → «Профиль» → «Контакты» указана ссылка на то сообщество ВКонтакте, которое настраивали в качестве канала связи.