Как подключить оповещения в Telegram и Max

Отправляйте уведомления о записях в мессенджеры Max и Telegram своим клиентам!

Вы можете отправлять клиентам уведомления в Telegram и Max.

Есть два режима:

• Наши боты — сообщения приходят от VivaCRM.

• Ваши боты — сообщения приходят от вашего бренда.

1

Активируйте ботов в глобальных настройках

1. Перейдите в раздел "Глобальные настройки"

2. Найдите блок "Способы отправки оповещений"

3. Выберите один из вариантов:

   • Наши боты (Max или Telegram) — уведомления будут приходить от VivaCRM.

   • Ваши боты — зарегистрируйте собственного бота. Уведомления будут от вашего бренда.

Выбор влияет только на то, от чьего имени клиент увидит сообщение. Логика доставки и каскад настраиваются отдельно.

Настройка Telegram

Настройка MAX

2

Как создать своего бота в Telegram (если выбрали «Ваши боты»)

Токен — это строка, которая авторизует бота в Telegram API. Это не пароль от вашего аккаунта Telegram.

1. Откройте в Telegram бота @BotFather

2. Выполните команду /newbot

3. Задайте:

   • название бота (любое)

   • username бота (должен оканчиваться на bot, например my_company_notify_bot)

4. Скопируйте токен, который выдаст BotFather

Пример токена:

4839574812:AAFD39kkdpWt3ywyRZergyOLMaJhac60qc

Храните токен как пароль. Не публикуйте его и не отправляйте в чаты. При утечке токен можно перевыпустить через BotFather.

Дальше вставьте токен в "Глобальные настройки" → блок "Оповещения в MAX и Telegram" → поле "API-ключ бота".

3

Настройте уведомления в разделе «Уведомления»

1. Перейдите в раздел "Уведомления"

2. Выберите канал "Мессенджеры (Telegram/Max)"

4

Настройте каскад (приоритеты доставки)

Разделяйте каскады для разных типов событий.

Коды входа / авторизации (OTP)

Рекомендуемый порядок:

1. Telegram Gateway

2. SMS от VivaCRM

3. E-mail

Почему так:

• Messenger (бот Telegram/Max) требует согласия клиента на уведомления.

• Если поставить Messenger первым, код может не дойти.

• Клиент сначала должен дать согласие в виджете.

Все остальные уведомления (записи, напоминания, статусы и т.д.)

Рекомендуемый порядок:

1. Мессенджеры (Telegram/Max)

2. E-mail

3. SMS

Важно про согласие клиента и логику доставки

После ваших настроек в виджете появится блок подключения Telegram/Max. Клиент должен сам дать согласие на оповещения. Только после согласия начнут приходить уведомления в мессенджеры.

Ключевые правила:

• Если клиент не подключил Telegram/Max, сообщения в мессенджеры не уйдут.

• Для кодов входа используйте каскад: Telegram Gateway → SMS (VivaCRM) → E-mail.

• Для обычных уведомлений используйте каскад: Мессенджеры → E-mail → SMS.

• После успешной авторизации мы проверяем, подключён ли у клиента Telegram или Max.

• Если не подключён, не дублируем запрос на подключение каждый раз. Иначе клиент будет постоянно видеть предложение подключить канал. Это раздражает. В этом случае доставка идёт в резервные каналы.

Такая схема с согласием клиента нужна для защиты от спама. Это стандартная практика подписок.

Активация бота клиентом (Telegram и Max)

1. Клиент открывает чат с ботом.

   • Если выбраны наши боты — это @vivacrmpush.

   • Если выбран ваш бот — это username вашего бота.

2. Напишите боту команду /start.

3. Бот ответит: «Привет! Чтобы активировать уведомления, разреши мне увидеть твой номер телефона».

4. Нажмите кнопку «Поделиться номером телефона».

5. После подтверждения клиент получит сообщение: «Всё отлично! Вы успешно подписались на уведомления».

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

Max: как это работает

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