Телеграм

Данный раздел доступен на всех тарифах. Кроме того, раздел доступен только владельцу квест-кампании — если вы вошли как администратор, пункта «Интеграции» не будет вообще, независимо от тарифа.
Все интеграции настраиваются отдельно для каждого квеста — сначала нужно выбрать квест в выпадающем списке, а затем нажать кнопку «Настроить» в соответствующей интеграции.

Настройки интеграции

  • Переключатель «Статус интеграции»: Выключена / Включена;
  • «Токен бота (Bot Token)» — получается у официального бота @BotFather в Telegram;
  • «ID чата (Chat ID)» — числовой ID чата (см. далее);
  • «Кому отправлять отчёты (ссылки через @, через запятую)» — здесь указываются руководители кампании (!), которые ежедневно и еженедельно будут получать подробные отчёты.


Кнопки: «💾 Сохранить настройки», «🔔 Отправить тест» (проверочное сообщение — убедиться, что токен/ID верны), «🚀 Проверить рассылку» (моментальный ручной запуск отправки отчётов).
Для того, чтобы кнопки «🔔 Отправить тест» и «🚀 Проверить рассылку» прислали тестовые сообщения, сначала необходимо сохранить настройки tg-интеграции кнопкой «💾 Сохранить настройки».

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

1. Для того, чтобы настроить интеграцию, выберите в выпадающем списке статуса интеграции «Включена»;
2. Перейди в telegram, откройте @BotFather (официальный инструмент для создания ботов в телеграме) и введите команду /start (либо просто нажмите кнопку «Старт»);
3. После первого сообщения от бота, введите команду /newbot;
4. Далее введите название вашего бота;
5. После этого введите ссылку на вашего бота (должна быть уникальной и заканчиваться на _bot);
6. Скопируйте токен, который получите от BotFather (просто нажмите на токен и он скопируется);
7. Вставьте скопированный токен в поле «Токен бота (Bot Token):»;
8. Создайте telegram-чат, в который будут приходить брони (если такой чат у вас уже есть, вы можете использовать его, — в таком случае новый чат создавать не нужно);
9. Добавьте в этот чат вашего бота (по ссылке, которую вы создали в п.5);
10. Добавьте в ваш чат бота @Getmyid_bot (он даст уникальный id чата, который нужно будет вставить в «ID чата (Chat ID):» в настройках интеграции);
11. Как только бот из п. 10 будет добавлен в ваш чат, он сразу пришлёт сообщение с ID данного чата (сообщение может прийти несколько раз, это нормально);
12. Скопируйте ID чата, который получили от бота (просто нажмите на строку с ID чата, она будет второй);
13. Вставьте скопированное значение в поле «ID чата (Chat ID):» в настройках интеграции;
Обратите внимание, что ID чата прописывается со знаком «-» в начале, его нужно вставлять именно в таком виде.
14. В поле «Кому отправлять отчеты (ссылки через запятую):» вы вставляете ссылку на ваш личный telegram-аккаунт (вкладка «Настройки»), ссылка задаётся в формате через @ (см. пример ниже);
Вы также можете добавить (через запятую) ссылки на других пользователей (напр, на совладельца кампании) и отчёты будут приходить каждому из вас.

Если уникальная ссылка (юзернейм) в вашем аккаунте не задана, её нужно создать
Обязательно перейдите в вашего бота (созданного в п. 5) и нажмите кнопку «СТАРТ» — это нужно для того, чтобы бот запомнил вас. Если этого не сделать, бот не будет присылать отчёты. Если вы хотите, чтобы отчёты получали несколько пользователей, каждый должен перейти в вашего бота и нажать кнопку «СТАРТ».
Обязательно нажмите кнопку «Сохранить настройки», чтобы интеграция сохранилась.
Вы также можете протестировать интеграцию:
  • «Отправить тест» — тестовое сообщение должно прийти в ваш чат с бронированиями (если пришло — интеграция настроена верно);
  • «Проверить рассылку» — тестовое сообщение должно прийти в личные сообщения аккаунтам, указанным в поле «Кому отправлять отчеты» (если пришло — интеграция настроена верно).

Частота уведомлений и отчётов

  • Сообщения о бронированиях приходят в чат моментально (как только клиент забронировал);
  • Для руководителей предусмотрено 2 вида отчетов:
  1. Ежедневные: Статистика за вчерашний день и её сравнение с позавчерашним;
  2. Еженедельные: Итоги за прошедшие 7 дней и сравнение их с предыдущей неделей.

Настройка разных квестов

Если у вас больше 1 квеста, создавать нового бота под каждый из них не нужно. Бот, созданный для одного квеста, может работать аналогично со всеми вашими квестами. ID чатов для бронирований могут быть уникальными (напр, если у вас разные филиалы и вы не хотите чтобы бронирования пересекались), но поле «Токен бота (Bot Token)» вы можете использовать одинаковый для каждого из своих квестов (как и поле поле «Кому отправлять отчеты»).

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

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

⚠️ Для компаний из РФ:
Интеграция с Telegram и 152-ФЗ

Обратите внимание: при активации данной интеграции система автоматически передает в Telegram данные о бронировании, включая персональные данные ваших клиентов (имя, номер телефона).

Согласно законодательству РФ, Telegram признан иностранным мессенджером, и такая пересылка расценивается как трансграничная передача данных. Включая эту функцию, вы берете на себя полную юридическую ответственность за соблюдение 152-ФЗ.

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