FAQ

FAQ

Как устроен Джасп: с чего начать, что такое теги и фильтры, как собрать форму и сайт, где взять API.

Авторизуйтесь по номеру телефона — и вы сразу в своём пространстве, настраивать ничего не нужно. Внизу экрана есть строка ввода: пишите в неё дела обычным текстом. «Позвонить Ивану завтра в 14:00», «купить билеты в Псков» — каждая запись становится карточкой.

Когда записей становится много, их пора разделить по делам. Наверху есть строка поиска — начните печатать в ней название нового дела, и в списке проектов появится плитка с этим названием. Клик — проект создан, вы его администратор. Та же строка ищет по существующим проектам и тегам, а если ввести название группы или тега, которых ещё нет, их можно создать прямо оттуда.

В Джаспе нет колонок, полей и типов записей — есть теги. Тег это любой атрибут карточки: статус, исполнитель, дата, место, категория. Выделите слово в тексте долгим нажатием — оно станет тегом.

Теги живут в группах. Группа — это ось, по которой вы смотрите на дела: «Состояние», «Ответственный», «Этап». Некоторые группы Джасп понимает по смыслу — дата, местоположение, пользователь — и показывает их соответствующим видом.

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

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

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

Кроме текста в страницу вставляются блоки. Нажмите пробел на пустой строке — появится палитра: картинки и видео (сеткой или слайдером), таблица, кнопка, форма, SEO-блок с мета-тегами. Отдельный блок — подборка карточек по фильтру: вы задаёте условие, а блок сам показывает всё, что под него подходит, и обновляется, когда карточки меняются.

У любого блока в меню есть «Обсудить с ИИ» — открывается тред, в котором ассистент видит именно этот блок.

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

Поэтому карточка, которую коллега передвинул на другом конце города, доедет до вашего экрана сама, без обновления страницы. По этому же каналу приходят сообщения, индикатор набора текста и звонки. И этот же механизм доступен вам из своего кода — см. раздел про API.

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

Это значит, что заявки не нужно разбирать вручную — они сразу разложены по осям. Заявки «работа от 6 до 10 лет, формат А3» находятся одним фильтром, считаются в статистике и попадают в нужную колонку канбана.

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

Доска уже содержит всё, что нужно сайту: тексты, картинки, карточки с тегами. Задержите палец на аватаре проекта (или кликните правой кнопкой) — там пункт «Визитка». Это главная страница вашего сайта, и редактируется она тем же редактором. Блок с фильтром станет каталогом или портфолио, форма — обратной связью.

Сайт живёт синхронно с доской: добавили карточку — она появилась на сайте, если попадает под фильтр блока. Обновлять в двух местах ничего не нужно.

Сразу после создания сайт открывается по адресу вида .jusp.io. Чтобы он открывался по вашему домену, пропишите записи у регистратора.

Поддомен (www.example.com, site.example.com) подключается одной записью: тип CNAME, имя www, значение .jusp.io — Джасп сам достанет id проекта из этой записи.

Корневой домен (example.com) так подключить нельзя: на апексе CNAME запрещён, он конфликтует с NS и SOA. Поэтому записей две. Первая ведёт трафик: тип A, имя @, значение 92.53.65.252. Вторая говорит, какому проекту домен принадлежит: тип TXT, имя jusp (то есть полное имя jusp.example.com), значение — .

Проверить, что записи разошлись, можно так: dig +short A example.com и dig +short TXT jusp.example.com. HTTPS-сертификат выпускается автоматически, обычно в пределах 15 минут после того, как DNS обновился. Robots.txt и sitemap.xml Джасп генерирует для вашего домена сам.

По умолчанию карточка видна только участникам проекта. Чтобы открыть её всему миру, поставьте тег public — после этого запись доступна анонимно: по прямой ссылке и в блоках сайта.

Главная страница проекта — исключение: она и есть сайт, поэтому открыта всегда. Остальные страницы без public остаются черновиками: анонимам они не отдаются и от индексации закрыты, так что материал можно спокойно готовить и опубликовать одним тегом.

Тот же тег работает и в API: если отдаёте данные наружу из своего приложения, публикуйте записи с public — тогда их видно без токена.

Ассистент живёт не в отдельном окне, а внутри работы.

В поисковой строке сверху можно написать или надиктовать голосом «покажи срочные задачи Ивана на следующей неделе» — Джасп соберёт из этого фильтр и переключит доску.

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

Через «Обсудить с ИИ» на блоке ассистент работает именно с этим блоком. У блока-подборки — заведёт карточки сразу с нужными тегами по его фильтру. У картинки — перерисует её, поменяет цвет, соберёт композицию из нескольких изображений; понравился результат, пункт «Актуализировать» в меню сообщения ставит новую картинку в блок.

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

Всё, что делает интерфейс, доступно и снаружи. Модель данных одна на весь Джасп: запись это { id, type, text, entities }, где text — строки, а entities — теги, проекты, вложения и блоки. Отдельных схем под задачи, страницы и сообщения нет — поэтому и API одно.

Точек входа три. Чтение и запись — POST https://jusp.io/api?token=YOUR_TOKEN. Подписка и реалтайм — WS https://ws.jusp.io/?token=YOUR_TOKEN. Для ИИ-помощников есть MCP-сервер: https://jusp.io/mcp с заголовком authorization: Bearer YOUR_TOKEN — добавьте его в конфиг своего ассистента, и он научится работать с вашими проектами.

Токен выдаётся по логину, в Джаспе он по номеру телефона: отправьте на /api тело { auth: { phone, password } } и сохраните token из ответа. Дальше подключайтесь к сокету и подписывайтесь на фильтр — сначала придёт всё, что ему соответствует, потом обновления. Если у вас есть сервер, удобнее наоборот: подпишите его на вебхук через POST https://jusp.io/webhook?token=YOUR_TOKEN, и Джасп сам будет присылать POST при создании и изменении нужных записей.

Ссылки внутри Джаспа собираются предсказуемо: карточка — jusp.io/project//all/, доска с фильтром — jusp.io/project//?=.

Готовые примеры запросов, форматы фильтров и действий — в карточке «API».