Боты программы лояльности

Инструкция по подключению бота лояльности

Оглавление

• 1. Что нужно от вас
• 2. Получение токена Telegram-бота
• 3. Получение токена MAX-бота (необязательно)
• 4. Что дальше
• 5. Глоссарий

1. Что нужно от владельца магазина

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

1. ИНН организации — по нему мы самостоятельно найдём organization_id.
2. Токен Telegram-бота — как получить, см. раздел 2.
3. Токен MAX-бота — необязательно; как получить, см. раздел 3.

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

 Важно
Учётная запись БИФИТ Касса, от имени которой будет работать бот, должна иметь максимальное количество прав — право создавать, редактировать и удалять документы, справочники, клиентов и карты лояльности.

2. Получение токена Telegram-бота

1. Откройте мессенджер Telegram.
2. Найдите бота @BotFather и откройте с ним чат.
3. Отправьте команду /newbot.
4. Следуйте подсказкам BotFather: введите имя бота и его уникальный адрес (username), который заканчивается на bot, например my_shop_loyalty_bot.
5. После создания BotFather выдаст токен вида 123456:ABC-DEF123....

Скопируйте этот токен и передайте его нам. Это единственное, что нужно сделать в Telegram.

 Обратите внимание
Токен выдаётся только один раз при создании бота. Сохраните его в надёжном месте — это ключ доступа к вашему боту.

Дополнительно вы получите прямую ссылку на бота вида https://t.me/имя_бота. Её нужно будет разместить в зоне видимости покупателя в виде QR-кода (мы поможем это настроить).

3. Получение токена MAX-бота (необязательно)

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

1. Войдите на портал MAX (или API-платформу MAX) под учётной записью организации.
2. Зарегистрируйте нового бота в соответствии с правилами платформы MAX.
3. Получите токен MAX-бота и, при необходимости, логин, пароль и другие параметры доступа, которые запросит платформа.

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

 Примечание
Если токен MAX-бота не передан — магазин будет обслуживаться только ботом в Telegram. MAX-канал подключается только при наличии токена.

Также вы получите прямую ссылку на MAX-бота — её разместят в зоне видимости покупателя в виде QR-кода.

4. Что дальше

После того как вы передали нам ИНН организации и токены ботов:

• мы найдём organization_id по ИНН;
• настроим и запустим бота;
• пришлём вам QR-коды для размещения в зоне продажи.

Ваши покупатели смогут делиться контактом, получить идентификационный QR-код, смотреть баланс и историю покупок.

5. Глоссарий

• Покупатель — конечный участник программы лояльности; работает в боте.
• Программа лояльности (ПЛ) — сущность API БИФИТ Касса (типы: DISCOUNT — скидка, SCORING — баллы). Бот работает с типами DISCOUNT и SCORING.
• Идентификационный QR — QR-код со значением номера карты лояльности, который покупатель предъявляет продавцу.
• Токен бота — ключ доступа, который подтверждает право управлять ботом.