FAQ для работы с QUICKSPEAK

Загрузка диалога из гугл-таблиц

Формат CSV предназначен только для опытных пользователей, использующих автоматизации в сборке интерактивных проектов, или собственные скрипты.

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

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

Пример диалога в гугл-таблицах

Структура таблицы равна структуре конечного диалога и располагает следующим набором столбцов: branch, question, answer, k1, s1, k2, s2, k3, s3, input, service, output.

Разберем каждый столбец:

branch - ветка диалога. Этот элемент не виден пользователям квика и используется для уникализации варианта ответа.

question - вопрос. Это видимая часть навигации диалога. Вместе с branch они образуют уникальный идентификатор.

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

k-1, 2, 3 - это видимая часть вопросов. То, что появляется в качестве текста на кнопках.

s-1, 2, 3 - это ветки вопросов, образующие вместе с k-1, 2, 3 уникальные идентификаторы для навигации пользователя по диалогу.

input - используется для особых свойств диалога.

service - вызывает в варианте ответа дополнительный функционал. Например, если добавить в service команду "keyboard", то вызовется форма обратной связи, если добавить команду link:ваша ссылка, то в реплике появится таймер на 5 секунд, по завершению которого пользователь будет переадресован из диалога по заданной вами ссылке.

output - дополнительное поле, схожее по своим возможностям с полем answer. Введенный в поле output контент появляется в дополнительном блоке (блок слева в десктоп-версии сайта) и блок по клику на аватарке в варианте ответа в мобильной версии сайта.

КвикСпик

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

Ссылка на первый вопрос может иметь следующие параметры: s1 = начало k1 = подробнее. и соответственно, ответ запроса будет иметь вид branch = начало, question = подробнее.

Если вы снова хотите использовать конструкцию "Подробнее", или любую другую, что использовалась ранее, обозначьте новую ветку. Например - s1 = продукт, k2 = подробнее, и ответ запроса branch = продукт, quiestion = подробнее.

В одной итерации диалога вы можете использовать до трех вариантов ответа (k1-3, s1-3), или не использовать ни один из них, если например, вариант диалога завел на сервисную часть, где вы не хотите давать пользователю свободы действий.

Для сборки интерактивов в таблицах рекомендуем использовать бесплатный редактор Google Таблицы, который уже есть у вас в браузере. После сборки своего интерактива, выберите ФАЙЛ -> СКАЧАТЬ -> CSV ФАЙЛ.

Сохраненный файл загрузите в ваш кабинет.

КвикСпик

Мы работаем над тем, чтобы сборка интерактивов с помощью таблиц была максимально простой и комфортной.

Например, чтобы вставить слайдер, или картинку в вариант ответа, вам не обязательно использовать соответствующий HTML-тег, достаточно вставить ссылку на изображение, имеющие формат JPG или PNG. Сервис автоматически преобразует ссылку в изображение, а если ссылок на изображение несколько, то создаст на их основе слайдер.

При работе с CSV-форматом, вы можете допустить ряд ошибок, которые не пропустит валидатор. Для большинства ошибок предусмотрены подсказки на уровне проверки диалога, но пробежимся по основным моментам, чтобы вы реже искали причины проблем.

Недостающие столбцы

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

Ошибка в кодировке и разделителе

Если вы используете для валидации наш телеграм-бот, убедитесь, что сохранили файл в кодировке 1251 и разделителем ;, или в кодировке UTF-8 и разделителем ,.

В противном случае, считывания CSV-файла не произойдет. Но если вы используете Google Таблицы, это проблема вас не коснется.

Вариант ответа без созданного элемента диалога

Убедитесь, что для всех вариантов ответа существуют необходимые элементы диалога. Если создали вариант ответа, но забыли по его названию создать элемент - интерактив будет работать некорретно и не сможет пройти валидацию. Аналогично - элемент диалога, на который ничто в диалоге не ссылается, приведет к ошибке. Такие случаи могут допускаться из-за несоответствия веток варианта ответа с созданным элементом. Например, вы создали ссылку на вариант ответа с названием "товары", "Что у вас можно купить?", а сам вариант обозначили как "магазин", "Что у вас можно купить?". Различие в ветках равносильно созданию двух независящих друг от друга элементов.

Применили HTML-верстку и допустили ошибки

Наши диалоги позволяют использовать ряд возможностей HTML-верстки. Помните ее правила - если открыли тег, то не забудьте его закрыть.

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