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

Глоссарий

Словарь, используемый в интерфейсе платформы, документации и API. Когда вы встречаете одно из этих слов в своём проекте — вот что оно означает.

Проект и конфигурация

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

Project — один бизнес с одним голосовым агентом. Содержит сценарии, базу знаний, подключения плагинов, участников, API-ключи и списания с кошелька. Большинство операций на платформе привязаны к одному проекту.

Industry Pack — откалиброванный комплект всего, что нужно агенту в конкретной вертикали (Рестораны, Продажи, Недвижимость, Госучреждения). Выбор пакета при создании проекта закладывает сценарии, слоты, цели, маршруты интентов и требования к плагинам. Затем всё полностью редактируемо.

Member — человек с доступом к проекту. Роли: Owner, Editor, Viewer.

Role — уровень прав участника в проекте. Owner — полный контроль; Editor — конфигурация, но без биллинга; Viewer — только чтение.

Copilot — AI-ассистент, встроенный в платформу (веб и мобильное приложение). Отвечает на вопросы о вашем проекте и предлагает типизированные изменения конфигурации — цели, промпты, пакеты, — которые вы применяете, дорабатываете или отклоняете. Ничего не меняется без вашего явного применения.

Среда выполнения разговора

Scenario — один тип звонка для одного проекта. «Входящее бронирование», «исходящее напоминание», «квалификация лидов» — каждый из них сценарий. У проекта много сценариев. Каждый либо входящий, либо исходящий.

Session — одно исполнение сценария для одного телефонного звонка или текстового разговора. Содержит транскрипт звонка, значения слотов, вызовы инструментов, ссылку на запись, исход и стоимость.

Slot — типизированное структурированное значение, которое агент собирает во время сессии. partySize: integer, bookingTime: datetime, phone: phone. Каждый сценарий объявляет нужные ему слоты.

Goal — бизнес-результат, на достижение которого настроен сценарий. Несёт критерии успеха, ограничения, правила эскалации, тон и приоритет. У большинства сценариев одна основная цель.

Step — именованный участник потока сценария (slot_collection, say, branch). Большинство простых сценариев — один шаг slot_collection, владеющий всеми слотами; агент заполняет их в одном плавном разговоре.

Intercept — именованный момент разговора, в котором может выполниться обработчик-скрипт: тишина, перебивание, до/после вызова инструмента, заполнение слота, начало/конец сессии, получение вебхука. Индустриальные пакеты идут с разумными значениями по умолчанию.

Outcome — то, чем разрешилась завершённая сессия. Три значения: success (цель достигнута), middle (реальный разговор от 30 секунд, но без цели), spam (сброс короче 30 секунд или отсутствие вовлечения). Определяет биллинг.

Commercial Intent Score — оценка от 0 до 100, которую платформа присваивает каждой сессии после звонка и которая показывает, насколько коммерчески заинтересованным выглядел звонящий. Полезна для приоритизации дальнейшей работы.

Интеграции

Plugin — интеграция с внешней системой: календарь, бронирование, CRM, мессенджеры, SMS, почта, веб-виджет. Плагины предоставляют инструменты, которые агент вызывает во время сессии.

Plugin Type — вид интеграции (Calendar, Booking, CRM, Messenger и т. д.). Каждый плагин одного типа реализует один и тот же контракт, поэтому провайдеры взаимозаменяемы.

Tool Call — вызов агентом возможности платформы во время сессии. schedule_meeting, create_lead, send_sms. Каждый вызов инструмента записывается в трассировку сессии с аргументами и результатом.

Knowledge base — проиндексированный контент, по которому агент отвечает на фактические вопросы о вашем бизнесе. Источники: обход сайта и загруженные PDF.

Исходящие звонки

Outbound trigger — API-запрос POST /v1/calls, инициирующий один исходящий звонок.

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

Idempotency Key — ваш уникальный идентификатор изменяющего API-запроса. Повтор того же ключа возвращает исходный ответ — безопасно для повторных попыток.

Вебхуки и API

Webhook subscription — URL, на который мы отправляем POST при срабатывании указанного события. Подписывается HMAC от тела запроса, повторяется с растущими интервалами.

Inbound webhook — именованный URL, на который ваши системы могут отправить POST, чтобы передать событие в активные сессии проекта; доставляется как интерцепт on_webhook_received.

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

Scope — операции, которые разрешены API-ключу. outbound:trigger, sessions:read, webhooks:read.

Биллинг и использование

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

Top-up — зачисление денег в кошелёк, вручную или по правилу автопополнения.

Trial — бесплатный период, с которого начинает каждый новый тенант: 14 дней и до 200 разговоров, карта не требуется. Тестовые звонки в него не засчитываются.

Tier — стек провайдеров, на котором работает сценарий: Economy / Standard / Premium / Enterprise. Задаёт и используемые модели, и стоимость звонка. Enterprise также включает enterprise-level support и SLA.

Overage — минуты звонка сверх стандартного лимита в 5 минут, когда сценарий его поднимает. Тарифицируются поминутно по ставке тира.

Sandbox — режим аккаунта для разработки, в котором каждое списание симулируется и явно помечается. Кошелёк на самом деле не двигается. Включается по запросу.

Usage event — учётная запись о потреблении (минута звонка, токены LLM, секунды распознавания речи, символы синтеза речи, минута телефонии, ГБ-час хранилища, вызов API, секунда краулера). Используется для расчёта биллинга и отчётов об использовании по проектам.

Безопасность и сроки хранения

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

DSAR — Data Subject Access Request, запрос субъекта данных. Право звонящего узнать, какие данные о нём вы храните, и потребовать удаления. Отправляйте запросы на удаление на privacy@aitelier.org — мы выполняем стирание с подтверждением.

Retention — как долго платформа хранит ваши данные. Записи — 30 дней; транскрипты и данные сессий — всё время жизни аккаунта; записи о биллинге — в объёме, требуемом финансовым законодательством.