📊 Работа с Google Sheets

Подробная инструкция по заполнению таблицы контента

🎥 Видеоурок

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

Что такое таблица контента?

Таблица Google Sheets — это "сценарий" вашего бота. В ней описывается вся структура экскурсии: какие сообщения, в каком порядке и с каким контентом получит турист.

Каждая строка таблицы — это один элемент контента (текст, аудио, фото, кнопка). Несколько строк с одинаковым block_id образуют блок, который отправляется пользователю как единое сообщение.

Структура таблицы

В таблице есть следующие столбцы. Важно: заголовки столбцов изменять нельзя — по ним загружаются данные в базу.

Столбцы таблицы

Столбец Описание Советы
block_id Идентификатор блока. Несколько строк с одинаковым block_id = один блок сообщений Только латиница и цифры, без пробелов. Примеры: start, PushkinaStreet10, TrafalgarSquare
protected 0 = доступен всем, 1 = требуется пароль Достаточно указать в первой строке блока
order Порядок элементов внутри блока Нумерация с 1, без пропусков. Кнопки всегда в конце
type Тип контента text, audio, image, video, document, location, button
text Текст сообщения Используется для типа text
caption Подпись к медиа или текст кнопки Помогает пользователю ориентироваться
button_action Действие кнопки next_block, enter_password, contact_guide
button_target Куда ведёт кнопка Укажите block_id целевого блока
latitude, longitude Координаты для геолокации Скопируйте с карты
file name Имя файла медиа Точное имя файла: 05_Meeting_point.mp3

Типы контента

text - Текстовое сообщение

Обычное текстовое сообщение, которое получит пользователь.

Заполните: столбец text с вашим текстом

audio - Аудиофайл

Аудиозапись вашего рассказа. Пронумеруйте файлы по порядку и дайте понятные названия.

Заполните: file name (например: 05_Meeting_point.mp3), caption (подпись к аудио)

image - Изображение

Фотография или иллюстрация к точке маршрута.

Заполните: file name (например: 03_Cathedral.jpg), caption (подпись к фото)

document - Документ (PDF)

Дополнительные материалы для пользователей (карты, бонусы).

Заполните: file name или URL, caption

location - Геолокация

Точка на карте, куда должен прийти пользователь.

Заполните: latitude, longitude (скопируйте с Google Maps), caption

button - Кнопка навигации

Кнопка для перехода к следующему блоку или другого действия.

Заполните:

  • caption - текст на кнопке (например: "Дальше", "Связаться с гидом")
  • button_action:
    • next_block - переход к другому блоку
    • enter_password - запрос пароля
    • contact_guide - ссылка на чат с вами
  • button_target - для next_block укажите block_id куда вести
⚠️ Важно: Кнопки всегда идут в конце блока (с максимальным order_num)

Что такое блоки?

Блок — это набор сообщений, которые отправляются пользователю одновременно. Например, блок может включать:

  • Фотографию достопримечательности
  • Аудио с рассказом о ней
  • Текст с дополнительной информацией
  • Кнопку "Дальше" для перехода к следующей точке

Все эти элементы будут иметь одинаковый block_id, но разные order (порядок отправки). Исключение: галерея картинок (до 10) или кнопки в 1 ряд (до 8, рекомендовано 2-3)

💡 Совет: Начните с блока start (приветствие), затем intro (знакомство), затем точки маршрута: point_1, point_2 и так далее

Группировка элементов

Галерея изображений

Несколько изображений с одинаковым order отправляются одним сообщением-галереей (до 10 изображений).

Подпись (caption): берётся из первой строки группы изображений.

⚠️ Важно: Если галерея изображений идёт последней в блоке (перед кнопками), бот автоматически добавит эмодзи со стрелкой вниз 👇, так как Telegram не позволяет прикреплять кнопки напрямую к галерее.

Пример: 3 фото собора с одним order=2 отправятся как альбом

Группировка кнопок

Несколько кнопок с одинаковым order отправляются в один ряд (до 8 кнопок).

💡 Рекомендация: Если на кнопках текстовые заголовки, используйте не больше 2-3 кнопок в ряду для удобства чтения

Пример: Кнопки "◀️ Назад" и "Вперёд ▶️" с одним order=5 будут в одной строке

Примеры заполнения

Пример 1: Приветственный блок

block_id protected order type text caption button_action button_target file name
start 0 1 image Добро пожаловать! 01_welcome.jpg
start 2 text Привет! Я ваш гид...
start 3 button Начать экскурсию next_block intro

Пример 2: Точка маршрута с аудио и фото

block_id protected order type caption button_action button_target file name
point_1 1 1 image Красная площадь 05_red_square.jpg
point_1 2 audio История площади 05_red_square.mp3
point_1 3 button Следующая точка next_block point_2

⚠️ Частые ошибки

  • Кириллица в названиях файлов — используйте только латиницу
  • Пробелы в названиях — замените на подчёркивание: red_square.jpg
  • Повторяющиеся order внутри блока — проверьте, что нумерация идёт подряд: 1, 2, 3..., за исключением группировки картиной в галерею и кнопок в один ряд
  • Кнопки в середине блока — кнопки всегда должны быть последними (максимальный order)
  • Неправильный block_id в button_target — убедитесь, что блок с таким id существует
  • Забыли указать protected=1 для защищённых блоков — проверьте первую строку каждого блока
  • Точное имя файла не совпадает — скопируйте имя файла полностью, включая расширение
💡 Совет: После заполнения таблицы проверьте её построчно. Убедитесь, что все block_id корректны, файлы названы правильно, а кнопки ведут на существующие блоки

📋 Скачать шаблон

Используйте готовый шаблон для создания структуры своей экскурсии:

📋 Открыть шаблон (пустой) 📝 Открыть образец (заполненный)

💡 Совет: Откройте шаблон и нажмите Файл → Создать копию, чтобы таблица появилась в вашем Google Drive