Question 1

Создайте и опубликуйте первый QR-код

Accepted Answer

Выберите тип содержимого, берите динамический режим, если нет причин не брать, оформите код, опубликуйте его, а затем отсканируйте настоящий экспорт настоящим телефоном — до того, как он куда-то уйдёт.

Question 2

Статический или динамический: что выбрать

Accepted Answer

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

Question 3

Проверьте QR-код, прежде чем на него полагаться

Accepted Answer

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

Question 4

Коды на ссылки и app links

Accepted Answer

Код-ссылка несёт веб-адрес. App link несёт адрес, который мобильная ОС распознаёт как принадлежащий установленному приложению и который открывает веб, когда приложения нет.

Question 5

QR-коды для Wi-Fi

Accepted Answer

Код Wi-Fi несёт название сети, тип защиты и пароль, и телефон предлагает подключиться сразу после сканирования. Поскольку данные лежат внутри матрицы, каждый, кто сфотографировал код, имеет пароль.

Question 6

Коды на PDF, vCard и текст

Accepted Answer

Код PDF ведёт на размещённый документ, vCard несёт контактные данные, которые телефон сохранит напрямую, а текстовый код показывает короткое сообщение, которое никуда не ведёт. Сеть нужна только для PDF.

Question 7

Измените адрес уже напечатанного кода

Accepted Answer

Откройте динамический код в workspace, измените адрес и опубликуйте изменение. Напечатанная матрица остаётся нетронутой — она ведёт на управляемый адрес Mosaqo, и изменилось только то, что этот адрес отдаёт.

Question 8

Как работает перенаправление Mosaqo

Accepted Answer

Матрица кодирует короткий адрес Mosaqo. Сканирование открывает его, Mosaqo фиксирует сканирование и отвечает перенаправлением на текущий адрес, а телефон его выполняет. Всё, что вы можете изменить, живёт на стороне Mosaqo.

Question 9

Публикация, архивирование и восстановление кода

Accepted Answer

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

Question 10

Добавьте логотип, не сломав код

Accepted Answer

У QR-кода есть коррекция ошибок, и логотип её расходует. Держите логотип по центру, держите его малым относительно матрицы и проверяйте после каждого изменения — граница, за которой код перестаёт сканироваться, наступает внезапно.

Question 11

Контраст и quiet zone

Accepted Answer

Модули должны быть тёмными на светлом фоне, с реальным контрастом между ними, а самому коду нужны пустые поля со всех четырёх сторон. Инвертированные коды и захламлённые поля — две самые частые причины того, что код не читается.

Question 12

Фреймы, призывы к действию и стикеры

Accepted Answer

Голый код на стене собирает меньше сканирований, чем тот же код с тремя словами под ним. Фреймы и стикеры дают эту подсказку — пока остаются за пределами quiet zone.

Question 13

PNG, SVG или PDF: какой экспорт брать

Accepted Answer

Для всего, что пойдёт в печать, берите SVG или PDF — это вектор, он остаётся чётким в любом размере. PNG берите для экранов. Растянутый под постер PNG — самая частая причина размытого нечитаемого кода.

Question 14

Каким по размеру должен быть код

Accepted Answer

Чем дальше стоит читатель, тем больше должен быть код. Рабочее правило — десятая часть дистанции сканирования: код, который читают с метра, хочет около десяти сантиметров, а код на билборде — значительно больше, чем ожидает дизайнер.

Question 15

Глянец, изгибы, ткань и фольга

Accepted Answer

Всё, что отражает, гнётся или тянется, стоит попыток сканирования. Глянец даёт блик, изогнутая упаковка искажает сетку, ткань и фольга смещают модули. Лечение — больший размер, больший контраст и физическая проба, а не больший логотип.

Question 16

Total scans и unique scans

Accepted Answer

Total считает каждое событие сканирования. Unique считает устройство один раз в пределах окна агрегации. Один человек, отсканировавший трижды, добавляет три к первому числу и единицу ко второму — поэтому они никогда не совпадают.

Question 17

Почему у статического кода нет аналитики

Accepted Answer

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

Question 18

Экспорт CSV и параметры кампаний

Accepted Answer

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

Question 19

Запустите первую кампанию фидбека

Accepted Answer

Кампания держит цель и форму, точка — это одно напечатанное место со своим QR, а публикация выводит всё трое в эфир одной операцией. Настройка ведёт семью шагами по порядку и не публикует, пока код не просканируют настоящим телефоном в тестовом окне.

Question 20

Когда поставили низкую оценку

Accepted Answer

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

Question 21

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

Accepted Answer

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

Question 22

Роли и что позволяет каждая из них

Accepted Answer

В workspace Mosaqo пять ролей — owner, admin, editor, analyst и viewer — от полного контроля до режима чтения. Давайте самую узкую роль, которой хватает для работы, а owner оставляйте тому человеку, который отвечает за пространство.

Question 23

Пригласите кого-то в workspace

Accepted Answer

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

Question 24

Работа больше чем в одном workspace

Accepted Answer

Workspace — это граница для кодов, шаблонов, assets, участников и API-ключей. Отдельные пространства держат отдельную работу порознь; между ними не переходит ничего, включая ключи.

Question 25

Личные и общие шаблоны

Accepted Answer

Шаблон сохраняет готовый вид — цвета, логотип, фрейм, стиль модулей — поэтому следующий код начинается с утверждённого, а не с пустого. Шаблон workspace видит команда, личный — нет.

Question 26

Brand kit

Accepted Answer

Brand kit держит цвета и логотипы, которыми workspace имеет право пользоваться, поэтому код, сделанный человеком, никогда не видевшим брендбука, всё равно выходит в стиле бренда.

Question 27

Управление логотипами, изображениями и стикерами

Accepted Answer

Assets — это логотипы, изображения и стикеры, которые workspace использует повторно. Именно хранение их в общей библиотеке, а не на отдельных ноутбуках, делает шаблоны воспроизводимыми.

Question 28

Подготовьте CSV для массовой генерации

Accepted Answer

Экспортируйте в UTF-8, держите одну строку на код, оставьте строку заголовков неизменной и проверьте несколько строк, прежде чем выгружать тысячи. Большинство сбоев массовой генерации — это кодировка или колонки, а не Mosaqo.

Question 29

Чтение ошибок превью и валидации

Accepted Answer

Валидация сообщает строку и то, что с ней не так. Исправляйте исходную таблицу, а не экспортированный файл, чтобы правка пережила следующий экспорт.

Question 30

Перезапустите массовое задание без дублирования всего

Accepted Answer

Повторный запуск всего файла после частичного сбоя — именно так в workspace появляются тысячи дубликатов. Подавайте только строки, которые не прошли, а управляя массовой работой через API, используйте idempotency key, чтобы повтор не создал всё второй раз.

Question 31

Создайте API-ключ и выберите его scopes

Accepted Answer

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

Question 32

Диагностика 401, 403, 422 и 429

Accepted Answer

401 означает, что ключ вообще не приняли. 403 означает, что ключ приняли, но операция не разрешена. 422 означает, что запрос поняли, а payload оказался неправильным. 429 означает превышение rate limit: нужна пауза, а не немедленный повтор.

Question 33

Постраничный обход и соблюдение лимитов

Accepted Answer

Списки отдаются страницами по курсору, а не по офсету, поэтому идите за курсором из ответа, а не вычисляйте его сами. Следите за заголовками rate limit и используйте `updatedSince` для опроса вместо повторного чтения всего.

Question 34

Проверьте подпись webhook

Accepted Answer

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

Question 35

Подключение Make, Zapier и n8n

Accepted Answer

Mosaqo интегрируется с платформами автоматизации через свой HTTP API и webhooks, а не через опубликованный коннектор в маркетплейсе. У каждого из этих инструментов есть универсальный HTTP-модуль — именно им вы и пользуетесь.

Question 36

Подписанные ссылки для Airtable, Notion и Sheets

Accepted Answer

Чтобы показать изображение кода в инструменте, принимающем только ссылку, дайте ему адрес, который тот может загрузить, а не грузите файл вручную. Относитесь к этой ссылке как к открытой: кто её имеет, тот видит изображение.

Question 37

Web, мобильный и extension: что когда использовать

Accepted Answer

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

Question 38

Разрешения камеры и проверка сканирования

Accepted Answer

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

Question 39

Что хранит Chrome extension

Accepted Answer

Extension генерирует коды со страницы, на которой вы находитесь. Работа, не сохранённая в workspace, остаётся в локальном хранилище браузера, то есть привязана к этому профилю и исчезает вместе с ним.

Question 40

Проверьте, только ли у вас проблема

Accepted Answer

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

Question 41

Что включить в обращение в поддержку

Accepted Answer

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

Question 42

Как определяется приоритет и чего нельзя отправлять никогда

Accepted Answer

Приоритет зависит от влияния и срочности, а не от формулировок. И ни одно обращение не должно нести пароль, access token, API secret, заголовок `Authorization` или приватные данные QR-кода — ни в сообщении, ни на скриншоте, ни во вложенном логе.

Чем помочь?

Обзор по направлениям

Начало работы

Типы QR-кодов

Динамические коды и перенаправления

Дизайн и читаемость

Печать и экспорт

Аналитика сканирований

Фидбек и отзывы

Workspace и команда

Шаблоны, brand kit и assets

Массовая генерация и CSV

Public API

Webhooks и интеграции

Мобильные приложения и Chrome extension

Обращение в поддержку

Всё ещё не решилось?