Formbricks на своём сервере: обратная связь внутри приложения

MAATRIX · 17 октября 2026 · 8 мин чтения

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

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

Ниже — проект короткого опроса после создания первого отчёта. Его можно адаптировать для регистрации, заказа или другой законченной операции. Мы настроим показ, проверим отправку и организуем передачу ответа человеку, который действительно может что-то исправить.

Один вопрос вместо допроса

Для учебного приложения выберем момент: отчёт успешно сформирован и пользователь увидел результат. Вопрос звучит так: «Насколько легко было получить нужный отчёт?» После оценки можно предложить необязательное поле «Что помешало?».

Такой опрос связан с конкретным действием. Человек ещё помнит трудности и понимает, о чём его спрашивают. Вопрос «Оцените наше приложение вообще» после первого входа обычно измеряет первое впечатление от экрана, а не качество продукта.

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

Запишите до запуска три вещи: кто читает ответы, как часто он это делает и при каком сигнале создаётся задача. Например, обращения о потере данных идут в поддержку сразу, пожелания к оформлению разбираются раз в неделю. Это учебный порядок, а не встроенная обязательная логика Formbricks.

Подготовьте отдельную среду для опросов

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

Для небольшого пилота на MAATRIX можно рассмотреть Heka Standard: 4 vCPU и 8 GB памяти. Современная сборка состоит из нескольких служб, поэтому планировать её по размеру одной HTML-анкеты было бы оптимистично. Объём диска зависит от хранения ответов, вложений и журналов; доступность CPU и памяти проверяют на выбранной версии.

Начните с поддерживаемой Ubuntu и официального Docker-развёртывания. Актуальный состав контейнеров берите из документации установки, фиксируя версию. Старую Compose-конфигурацию из случайной заметки нельзя считать гарантированно совместимой с новым выпуском.

Назначьте домен, например feedback.example.com, включите HTTPS и настройте почту администратора. База, очередь и внутренние службы не должны иметь общедоступных портов. Полная первоначальная подготовка описана также в руководстве MAATRIX по Formbricks.

От проекта до первой карточки вопроса

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

Создайте Website & App Survey. Добавьте вопрос с оценкой и свободное текстовое поле. Проверьте подписи крайних значений: люди должны понимать, где «легко», а где «сложно». В завершении поблагодарите за конкретное действие, не обещая персональный ответ каждому, если команда этого не делает.

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

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

Подключение SDK и правильный момент показа

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

Следуйте официальному руководству Website & App Surveys. Инициализацию выполняйте один раз в предусмотренном для клиента месте. В приложениях с серверным рендерингом браузерный код не должен запускаться во время серверной сборки.

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

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

Если приложение передаёт идентификатор пользователя, используйте внутренний непрозрачный ID и минимальный набор атрибутов. Не отправляйте в аналитику пароль, полный документ или содержимое отчёта только потому, что объект уже находится под рукой в JavaScript.

Как убедиться, что ответ дошёл

Создайте несколько тестовых сценариев. Первый пользователь проходит процесс и отвечает. Второй закрывает опрос. Третий открывает приложение с медленной сетью. Четвёртый сначала выходит из аккаунта, а затем входит под другим пользователем на том же устройстве.

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

Сравните число завершённых тестовых анкет с записью ответов в панели. Посмотрите, какие сведения оказались в контексте: страница, версия приложения, идентификатор. Лишние поля лучше удалить до запуска, пока они не накопились в тысячах записей.

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

Передаём ответ в работу

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

Formbricks поддерживает webhook-уведомления. Выберите нужное событие и направьте его в защищённый обработчик. Проверяйте подпись по документации версии, сохраняйте идентификатор события и не создавайте дубли при повторной доставке.

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

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

Дайте ответам понятные категории

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

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

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

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

Читаем результат без самообмана

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

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

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