База Знаний CleverApp
  • Главная
  • Обзор платформы
    • Краткий обзор платформы CleverApp и создание первого бота
    • Автоподстановка переменных в текст бота
    • Валидация — проверка введенных данных
    • Основная информация контакта
    • Политика обработки персональных данных в боте
    • Работа с датами и временем
    • Арифметические операции в боте
    • Доступ к боту и проекту | Права и роли
    • Пополнение и списание баланса с внутреннего счета контакта
    • Массовое удаление контактов
    • Как удалить аккаунт с платформы CleverApp
  • Часто задаваемые вопросы
  • Тарифы и оплата
  • Партнерская программа платформы CleverApp
  • Создание чат-ботов (блоки платформы CleverApp)
    • Простые блоки
      • Блоки “Простое сообщение” и “Цепочка сообщений”
      • Блок “Назначить тег”
      • Блок “Удалить тег”
      • Блок “Заявка”
      • Блок “Сценарий”
      • Блок “Условие”
      • Блок “Переключатель”
      • Блоки “Этап сделки” и “Ответственный за сделку”
      • Блоки “Запрос номера телефона” и “Запрос Email”
      • Блок “Таймер”
      • Блок “Задержка”
      • Блок “Удалить переменную”
      • Блок “Старт”
    • Уведомления
      • Блок "Заявка"
      • Блок "Уведомление для контакта"
      • Блок "Отправить сообщение"
      • Блок "Отправить быстрое сообщение"
      • Блок "Письмо на Email"
    • Списки и таблицы
      • Блок “Чтение записей из списка”
      • Блок “Чтение записи из списка”
      • Блок “Добавление записи в список”
      • Блок “Проверка существования записи в списке”
      • Блок “Бронирование записи из списка”
      • Блок “Чтение строк из таблицы”
    • Платежи
    • Магазин
      • Блок "Чтение записей из списка"
      • Блок "Чтение записи из списка"
      • Блок “Корзина”
      • Блок “Список заказов”
    • Рассылка
    • Голосования
      • Блок “Регистрация участника голосования”
      • Блок “Голосование за участника”
      • Блок “Лидеры голосования”
    • Интеграции
      • Блок "Заказ на GetCourse"
      • Блок “Запись в Google Таблицу”
      • Блок “Проверка существования записи в Google Таблице”
      • Блок “Чтение списка из Клиентской Базы”
      • Блок “Чтение записи из Клиентской Базы”
      • Блок “Отправить контакт в группу JustClick”
      • Блок “Отправить контакт в группу Flowell”
      • Блок “HTTP запрос”
      • Блок “Исходящий Webhook”
    • Специальные
      • Блок “Назначить тег”
      • Блок “Удалить тег”
      • Блок “Сценарий”
      • Блок “Условие”
      • Блок “Переключатель”
      • Блок “Бронирование записи из списка”
      • Блоки “Запрос номера телефона” и “Запрос Email”
      • Блок "Письмо на Email"
      • Блок "Операция над переменной"
      • Блок “Удалить переменную”
      • Блок "A/B-тестирование"
      • Блок “Старт”
      • Блок "Удалить пользователя из бота"
      • Блок “Встроенный бот Телеграм”
      • Блок "Входящий Webhook"
      • Блок “HTTP запрос”
      • Блок “Интерпретатор JavaScript”
      • Блок “Исходящий Webhook”
      • Блок "Распределение по группам"
    • Enterprise блоки
    • Меню слева
      • Сценарий
      • Сообщения
      • Каналы
      • Авторассылки
      • Настройки
      • CRM
      • Списки
      • Бронирование
      • Статистика
  • Кнопки меню со встроенными ссылками
  • Меню в боте Telegram
  • Мессенджеры и соц. сети
    • Telegram
      • Создаем чат-бот и подключаем к каналу Telegram
      • Настройки в BotFather
      • Прямые ссылки на дополнительные сценарии в Телеграм
      • Инлайн-кнопки меню со встроенными ссылками
      • Инлайн-кнопки меню со встроенными ссылками на Web App приложение
      • Как передать права на Telegram-бота в @BotFather?
      • Подмена предыдущего сообщения в чате Telegram-бота
      • Business-аккаунт Telegram
      • Администрация канала или группы
    • Viber
      • Создаем чат-бот и подключаем к каналу Viber
      • Инлайн-кнопки меню со встроенными ссылками
    • WhatsApp
      • Создаем чат-бот и подключаем к каналу Whatsapp
      • Меню для WhatsApp
    • ВКонтакте
      • Создаем чат-бот и подключаем к каналу ВКонтакте
      • Инлайн-кнопки меню со встроенными ссылками
    • ТамТам
      • Создаем чат-бот и подключаем к каналу ТамТам
  • Авторассылки
    • Создание авторассылки
    • Гибкие фильтры авторассылок в CleverApp
    • Отложенная отправка сообщений
  • Магазин в Telegram
    • Импорт товаров в списки
    • Блоки “Чтение записей/записи из списка”
    • Постоплата и адрес доставки в корзине
    • Блок “Встроенный бот Телеграм” – Создание меню для магазина в Telegram
  • Аналитика
    • Встроенная CRM
    • UTM-метки
    • Статистика заявок и посетителей
    • Конверсии связей в сценариях
  • Интеграции
    • CRMCA
    • Клиентская база
    • amoCRM
    • Битрикс24
    • Платежные системы
      • Прием платежей и интеграция с ЮKassa
      • Прием платежей на ЮMoney
      • Прием платежей и интеграция с Robokassa
      • Прием платежей и интеграция с Cloudpayments
      • Прием платежей и интеграция c Prodamus
      • Прием платежей и интеграция с bePaid
      • Прием платежей и интеграция с LiqPay
      • Прием платежей и интеграция с JustClick
      • Прием платежей и интеграция с Flowell
      • Прием платежей и интеграция c Crypto Pay
    • Google Таблицы
    • SMS провайдеры
      • Интеграция с SMS.RU
      • Интеграция с SMS.to
      • Интеграция с SMSala
    • ERESH
    • GetCourse
    • YCLIENTS
    • Make
    • Integromat
    • Postback (постбек)
    • Интеграция CleverApp и ChatGPT
  • Конструктор Мини-лендингов
  • Форма "Захват телефона"
  • Конструктор Виджетов
  • Создание реферальной системы в Telegram
  • Создание бота с ChatGPT
  • JavaScript решения
  • Для разработчиков
    • Документация и работа с API
      • Основы
      • Аккаунт
      • Контакты
        • Счета
        • Счета в криптовалюте
        • Реферальная система
        • Теги
        • Пользовательские переменные
      • Списки
        • Элементы списка
      • Сообщения
      • Рассылка
      • Примеры реализации API интеграций
    • JavaScript API
      • Основы
      • Переменные
      • Функции
        • Пользовательские переменные
          • getContactVariable()
          • setContactVariable()
          • deleteContactVariable()
        • Теги
          • hasContactTag()
          • setContactTag()
          • deleteContactTag()
        • Глобальные переменные
          • getGlobalVariable()
          • setGlobalVariable()
          • deleteGlobalVariable()
        • Общие функции
          • sendMessage()
          • goToBlock()
          • disableContinue()
          • setContactById()
          • setContactByTelegramId()
          • setContactByViberId()
          • setContactByVkId()
          • setContactByWhatsAppPhone()
      • Блок "Входящий Webhook"
      • Блок "HTTP-запрос"
      • Блок "Интерпретатор JavaScript"
  • Полезное
    • Самозанятые
      • Как стать самозанятым?! Инструкция
    • Лайфхаки
      • Для Telegram
        • Гиперссылка в тексте бота
        • Скрытый текст в боте
  • Личный кабинет
  • Обновления платформы
  • Написать в поддержку
Powered by GitBook
On this page
  1. Магазин в Telegram

Блоки “Чтение записей/записи из списка”

PreviousИмпорт товаров в спискиNextПостоплата и адрес доставки в корзине

Last updated 2 years ago

Данные блоки используются для того, чтобы выводить в бота информацию, сохраненную в виде списков (списки – это инструмент в конструкторе, аналогичный эксель таблице).

Настройки блоков состоят из: 1. Поле с выбором бота, в личном кабинете которого создан список 2. Поле с выбором нужного списка 3. Стандартный набор настроек (подробное описание каждой настройки можно посмотреть на примере блока "цепочка сообщений")

Чтобы начать использовать блоки “Вывод записей списка”, списки нужно для начала создать.

Для создания списка в настройках в левой части экрана нажимаем на кнопку “Списки”:

На данном экране выводятся все списки, имеющиеся в данном боте. У каждого бота есть список под названием “Контакты”. Этот список создается автоматически и в нем записываются все пользователи бота, которые хоть один раз перешли в бота. Список контактов можно просмотреть в любой момент (в нем содержаться данные о пользователе боте – имя, телефон, username, присвоенные теги, дата первого захода в бота) и выгрузить в виде excel таблицы.

Чтобы создать свой собственный список, нажимаем кнопку “Создать список”:

Задаем имя для списка.

Далее переходим к настройкам полей в списке:

  1. Выбираем тип информации – которая будет отражаться в поле №1. Если проводить аналогию с эксель таблицей, то поле в конструкторе – это как столбцы в эксель таблице.

На платформе мы можем выбрать тип информации, которая будет отображаться в поле.

  1. Имя – задаем имя для поля

  2. Ползунок “Обязательность заполнения поля” Когда мы начнем заполнять создаваемый нами список (т.е. заполнять таблицу данными), то данное поле (=данный столбец) будет являться обязательным для заполнения, если стоит включено

  3. Переключатель “Скрыть поле из интерфейса” – это поле для отображения будет доступно только через API

  4. Добавить еще одно поле (=столбец в таблицу) После того, как все поля созданы нажимаем “создать” список и переходим к заполнению списка

Создадим для примера список, в котором будет следующая информация:

1-ый столбец – название страны 2-ой столбец – столица этой страны 3-ий столбец – количество населения в стране 4-ый столбец – фотография флага

Создаем 1 поле (для данных по странам): – выбираем тип поля – “текст”, т.к. название страны – это текстовая информация – задаем имя для поля – например “Название страны”

Добавляем 2 поле (для данных по столицам): – выбираем тип поля – “текст”, т.к. название столицы – это текстовая информация – задаем имя для поля – например “Столица”

Добавляем 3 поле (для данных по населению): – выбираем тип поля – “число”, т.к. количество населения – это числовая информация – задаем имя для поля – например “Население”

Добавляем 4 поле (для флага): – выбираем тип поля – “картинка” – задаем имя для поля – например “Флаг”

Нажимаем кнопку “Создать” и список создается. Переходим в раздел со списками и видим новый созданный список.

Заходим с созданный список – он пустой, т.к. мы еще не добавляли записи.

Добавить записи можно 2му способами:

  1. Добавить записи по одной вручную, нажав кнопку “+добавить запись”

  2. Импортировать записи из excel файла

Добавим вручную, для примера. Нажимаем кнопку “+добавить запись” и попадаем в меню добавления записи в список.

Здесь необходимо заполнить четыре поля, которые мы с Вами задали ранее для этого списка и нажать кнопку “создать” после заполнения.

Таким образом, данные вносятся в список.

Давайте внесем 5 стран и посмотрим, как выводить эти данные в бота.

После добавление всех стран, список выглядит таким образом. Любую запись можно отредактировать/удалить или добавить новую запись в список

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

Например, мы решили, что хотим добавить в наш список еще поле – “президент”: Заходим в настройки списка, добавляем новое поле “президент” (с типом данных – “текст”). Не забываем заполнить поле “президент” у записей, которые уже существует (т.к. у них это поле будет пустым).

Еще решили добавить следующие поля:

  1. Добавить поле “ВВП страны”. Заходим в настройки списка, добавляем новое поле “ВВП” (с типом данных – “денежный”). Не забываем заполнить поле “ВВП” у записей, которые уже существует (т.к. у них это поле будет пустым)

  2. Добавить поле “О стране” – где будет краткая информация о стране Заходим в настройки списка, добавляем новое поле “о стране” (с типом данных – “текст”). Не забываем заполнить поле “о стране” у записей, которые уже существует (т.к. у них это поле будет пустым) После добавления всех данных – список обновляется, отображаются новые поля и показывается дата обновления списка.

Теперь данные из списка можно выводить в бота – для этого используются блоки “Чтение записей/записи из списка”.

Настройка блоков "Чтение записей/записи из списка"

1. В разделе настроек, обозначенных на скриншоте цифрой 1: - в поле "бот" - выбираете бот, в личном кабинете которого был создан список (можно выбрать список из любого бота в личном кабинете Вашего конструктора) - с поле "список" - выбирается список, данные из которого Вы хотите вывести в бота

-“Поле для поиска” – если пользователь отправляет боту команды текстом (а не нажимает на кнопки в телеграм боте) – то в данном поле выбирается то поле, по которому осуществляется поиск в списке.

Например: мы выбрали в “Поле для поиска” – столица. Пользователь бота ввел слово “Париж”. Бот находит в поле “Столица” (в столбце) ту запись, у которой столица равна “Париж” и выводит данные из этой строки. Т.е. в нашем случае, если пользователь введет слово “Париж” бот отправит ему информацию из строки про Францию.

  1. Дополнительные фильтры:

Вы можете задать дополнительные фильтры для выборки по указанному списку. И/ИЛИ: используется только, если задано несколько фильтров. при “и” – и один и второй фильтр должны выполняться при “или” – или один, или второй фильтр должны выполняться

Выбор поля (фильтра) для отображения : выбираем поле, по которому будет идти фильтрация (проверка) значений Оператор сравнения: стандартные математические символы (равно, больше, меньше и т.д.)

Значение, с которым сравнивается: значение для фильтрации.

3. Сортировка Сортировка выводимых данных Поле - выбор поля (столбца) по которому будет происходить сортировка По возрастанию/по убыванию

4. Шаблон цепочки сообщений Здесь настраивается, какие именно значения из списка и в каком порядке, бот будет выводить.

5. Сообщение перед/после отправки списка Здесь можно задать сообщения, которые бот выведет пользователю бота перед тем, как выведет все данные из списка. И после того, как выведет все данные из списка Эти поля можно оставлять пустыми.

Так же в них можно писать информационные сообщения для пользователя, например: для перехода на нужную страница отправьте боту “Страница n”, где n – номер страницы.

6. Настройки

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

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

  3. Шаблон команды выбора страницы Чтобы переключаться между выводимыми страницами, боту нужно отправить команду. Здесь задается шаблон команды, где {n} это номер страницы В данном случае, если пользователь отправить боту фразу “Страница 5” – бот выведет пятую страницу

  4. Имя кнопки выбора элемента списка При выводе всех записей их списка, рядом с каждой записью выводится кнопка, по которой можно посмотреть подробности данной записи. В этом поле задается текст данной кнопки.

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

Остальные настройки блока – стандартные для блоков

Стандартный набор настроек (подробное описание каждой настройки можно посмотреть на примере блока “цепочка сообщений”)

Теперь наконец-то посмотрим, как данные из созданных списков выводить в бота:

Стартовый блок – это обычный текстовый блок “цепочка сообщений” с одной кнопкой. Эта кнопка соединяется с блоком “чтение записей из списка”. В настройках блока “чтение записей из списка” выбираем:

  1. Выбираем своего бота, в личном кабинете которого создавался список

  2. Выбираем созданный нами список, данные из которого мы хотим выводить

  3. “Поле для поиска” пока можно не заполнять

  4. Функции фильтры и сортировка – пока тоже не трогаем

  5. В “шаблоне цепочки сообщений” задаем шаблон сообщения, которое мы хотим получить от бота с выводом информации из списка. В данном случае мы выбрали – “название страны” (просто нажав на кнопку под текстовым полем и переменная сама подтягивается в текст).

Написали обычным текстом “столица:” и подтянули переменную “столица”. Тоже самое с населением.

Далее:

Создаем блок “Чтение записи из списка” и соединяем с кнопкой “любая другая фраза” из блока “Чтение записей из списка”.

В настройках блока “чтение записи из списка” выбираем:

  1. Выбираем своего бота, в личном кабинете которого создавался список

  2. Выбираем созданный нами список, данные из которого мы хотим выводить

  3. “Поле для поиска” – выбираете поле, по которому будет происходить поиск, если пользователь отправит боту команду текстом (а не нажмет на кнопки в телеграм боте). Когда у Вас большие списки с данными, Вы можете задавать и фильтрацию и сортировку одновременно, в зависимость от того, что пользователь хочет видеть в боте.

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