Документация

Calder: от ссылки на сайт до ответов клиентам

Что внутри, как запустить, как устроен кабинет и API. Всё, что описано ниже, работает на этом сервере.

Что такое Calder

Calder — это AI-менеджер для сервисного бизнеса. Он отвечает клиентам на вашем сайте и в мессенджерах, подбирает свободное время и создаёт запись в календаре. Владелец видит диалоги, записи, отзывы и аналитику в одном кабинете — вместо переписки в директе и блокнота с расписанием.

Отвечает 24/7

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

Только ваши данные

Ответы строятся по вашему сайту и базе знаний. Модель не выдумывает цены.

Всё в одном месте

Записи, услуги, диалоги, отзывы, токены и подписка — в одном кабинете.

Быстрый старт

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

Что происходит после вставки ссылки

  1. Сервер загружает главную страницу и связанные разделы: «услуги», «цены», «контакты», «о нас».
  2. Из текста вытаскиваются факты: что вы делаете, сколько стоит, как связаться, часы работы.
  3. Собирается черновик описания агента. Его можно открыть в превью и сохранить.
  4. Дальше агент отвечает клиентам, а записи попадают в раздел «Записи».
Если сайт сделан на React/Vue и отдаёт пустую страницу — вставьте текст вручную: на экране приветствия есть ссылка «Сайт не читается? Вставить текст вручную».

Кабинет: что где

РазделЗачем нужен
ОбзорЦифры дня: записи впереди, выручка, средний чек, остаток токенов
АналитикаСколько записей и денег за период, источники обращений
AI-менеджерЖивой чат с агентом и история диалогов с клиентами
ЗаписиКалендарь, свободные окна, статусы визитов
Услуги и знанияПрайс, длительность, шаблоны наборов, ответы на вопросы
Виджет на сайтеВнешний вид чата, код для вставки, генерация по ссылке
ПодпискаТариф, срок, заявки на смену тарифа, платежи
ТокеныБаланс и расход на ответы
ИнтеграцияКлюч виджета, каналы, уведомления, вебхуки
ОтзывыСбор оценок после визита и публикация
НастройкиДанные бизнеса, адрес, телефон, часы работы, пароль

Записи и календарь

Раздел «Записи» показывает день, неделю и загрузку на месяц вперёд. Агент и администратор работают с одним и тем же календарём, поэтому двойных записей не бывает.

Статусы

  • Ждёт — запись создана, но ещё не подтверждена.
  • Подтверждена — клиент придёт, время занято.
  • Завершена — визит состоялся, сумма попадает в выручку.
  • Отменена — время снова свободно.

Свободные окна

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

Источники записи

В каждой записи виден источник: AI-чат, Виджет, Телефон или Вручную. Так понятно, что приносят клиентов.

Отменённую запись можно вернуть: кнопка «Вернуть» освобождает время обратно.

Услуги и цены

Услуга — это название, длительность и цена. Именно из этого списка агент берёт варианты, когда клиент спрашивает «сколько стоит» или «когда можно».

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

Готовые наборы

Кнопка «Готовый набор» добавляет прайс целиком: салон красоты, барбершоп, клиника, автосервис, репетитор и курсы, фитнес и спорт, фото и видео, ремонт и мастера, услуги и сервис.

Импорт из таблицы

Кнопка «Загрузить из Excel» принимает файл или вставленный текст: название, длительность, цена. Можно выгрузить текущий прайс кнопкой «Экспорт» и поправить его в таблице.

База знаний

База знаний — то, чем агент отвечает. Три источника:

  1. Страницы сайта — читаются автоматически при создании агента и по кнопке «Обновить».
  2. Услуги и цены — таблица из кабинета.
  3. Ответы на вопросы — пары «вопрос — ответ», которые вы добавляете вручную.

Что стоит добавить руками

  • правила отмены и переноса;
  • как добраться и где парковка;
  • способы оплаты и рассрочка;
  • что делать, если клиент опаздывает.
Не пишите агенту то, что не готовы подтвердить клиенту: он отвечает дословно по базе.

AI-менеджер

Раздел «AI-менеджер» — это чат, в котором можно проверить агента глазами клиента. Здесь же видна история настоящих диалогов.

Характер и тон

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

Передача человеку

Если вопрос выходит за рамки базы (жалоба, нестандартная просьба, скидка), агент предлагает связаться с администратором и не выдумывает ответ.

Модель

Ответы генерирует подключённая модель (по умолчанию — через API-Token.ru). Каждый ответ тратит токены, остаток виден в разделе «Токены».

Виджет на сайте

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

Код для вставки

<script src="https://getcalder.ru/widget.js" data-ref="clw_…" async></script>

Вставьте перед закрывающим тегом </body>. Ключ data-ref берётся в разделе «Виджет на сайте» — он не секретный, его видно в исходном коде страницы.

Внешний вид

  • цвет кнопки и панели, скругления, тень;
  • положение: справа или слева, отступы от края;
  • размер панели для телефона и компьютера;
  • приветствие и подпись в панели.

Генерация по ссылке

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

Если виджет не появился: проверьте, что скрипт стоит перед </body>, страница загружена по HTTPS, а в консоли нет ошибок.

Интеграция и API

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

Публичный чат

curl https://getcalder.ru/api/widget/chat \
  -H "Content-Type: application/json" \
  -d '{"ref":"clw_…","message":"Сколько стоит маникюр?"}'

Состояние сервера

curl https://getcalder.ru/api/health
# {"ok":true,"ai":true,"provider":"…","model":"…"}

Вебхук

Укажите адрес в разделе «Интеграция» и нажмите «Проверить» — на ваш сервер уйдёт тестовое событие. Так можно связать записи с CRM или таблицей.

Уведомления и напоминания

  • Письмо владельцу — о новой записи и о новом диалоге.
  • Telegram — те же события в личный чат или группу.
  • SMS — напоминание клиенту перед визитом (если подключён провайдер).
  • Дайджест — вечерняя сводка: сколько записей, сколько обращений.

Каждый канал включается отдельно, чтобы не заваливать себя сообщениями.

Отзывы

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

Аналитика

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

Подписка и токены

ТарифЦенаЧто входит
Start1 990 ₽/мес1 AI-менеджер, 1 000 токенов
Business4 990 ₽/месдо 5 менеджеров, 5 000 токенов, аналитика, API
Enterprise7 990 ₽/месбез ограничений, 25 000 токенов, роли и журнал

На что уходят токены

На ответы агента: чем длиннее вопрос и ответ, тем больше расход. Просмотр кабинета, записи и отчёты токены не тратят.

Что будет при нуле

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

Вход и доступ

  • Почта и пароль — основной способ. Пароль от 8 символов, буквы и цифры.
  • Код по SMS — вход по номеру телефона, если подключён провайдер.
  • Telegram — кнопка «Войти через Telegram», подтверждение приходит в приложение.

Забыли пароль — на экране входа есть ссылка восстановления. Пароль меняется в разделе «Настройки».

Безопасность и данные

  • пароли хранятся в виде хеша с солью;
  • доступ к кабинету — по сессии в защищённой cookie;
  • весь трафик по HTTPS, ключи API можно отозвать;
  • перед обновлением сайта делается резервная копия кода и базы;
  • текст запроса уходит только выбранной модели и не используется для обучения.

Частые проблемы

Сайт не прочитался

Скорее всего, страницы рисуются скриптами. Вставьте текст вручную или укажите прямую ссылку на страницу с услугами.

Агент отвечает общими словами

Знаний мало: добавьте услуги с ценами и пару ответов на частые вопросы. Проверьте в чате — ответ должен содержать конкретную цену или время.

Виджет не появляется

Проверьте код перед </body>, HTTPS и консоль браузера. Ключ data-ref должен совпадать с тем, что в кабинете.

Запись не создаётся

Убедитесь, что услуга включена и у неё есть длительность, а рабочие часы в настройках заданы.

Не приходят письма

Проверьте папку «Спам» и адрес в настройках. Обычно достаточно добавить домен отправителя в белый список.

Закончились токены

Пополните баланс в разделе «Токены» или смените тариф — доступ вернётся сразу после подтверждения.

Глоссарий

СловоЗначение
АгентAI-менеджер, который отвечает клиентам и создаёт записи
База знанийСтраницы сайта, услуги и ответы, по которым отвечает агент
СлотСвободное окно времени для записи
ТокеныЕдиница расхода на ответы модели
data-refКлюч виджета в коде страницы
ВебхукАдрес, куда сервер отправляет события о записях
Не нашли ответ? Напишите на [email protected] — отвечаем в рабочие дни.