Knowledge·production

IAM.Bot

Встраиваемый AI-консультант с RAG, воронкой и доставкой лидов.

Landing Приложение

Ключевые возможности

  • Виджет одной строкой для внешнего сайта
  • Tenant-scoped prompt и knowledge profile
  • Durable lead capture и доставка в Telegram/email

Пошаговые инструкции

Сценарии

Начинайте с результата: откройте сценарий, подготовьте prerequisites, выполните шаги и проверьте признаки успеха.

01 Зарегистрировать сайт и установить виджет IAM.BotВиджет открывается только на разрешённом домене и использует правильный tenant profile.
Для кого
Владелец сайта или frontend-разработчик
Результат
Виджет открывается только на разрешённом домене и использует правильный tenant profile.

Перед началом

  • Доступ к HTML сайта
  • Публичный HTTPS-домен
  • IAM.Bot account

Шаги

  1. Создайте workspaceВ консоли добавьте организацию, название ассистента и контакт владельца.
  2. Добавьте доменУкажите точный origin без path и подтвердите владение предложенным способом.
  3. Скопируйте embedИспользуйте выданный data-slug/credential; пример acme-corp из лендинга не является вашим ключом.
  4. Проверьте production pageОткройте сайт в приватном окне, отправьте тестовый вопрос и проверьте origin в session.
Как проверить результат

widget.js отвечает 200, чат создаёт session в нужном workspace, чужой origin отклоняется.

Если не работает

Онбординг внутри виджета означает неверные credentials, slug или неподтверждённый origin.

02 Настроить квалификацию и доставку лидов в Telegram/emailВалидный лид сохраняется до отправки и приходит по обоим настроенным каналам.
Для кого
Marketing или sales operations
Результат
Валидный лид сохраняется до отправки и приходит по обоим настроенным каналам.

Перед началом

  • Поля lead form
  • Telegram chat binding
  • Подтверждённый email получателя

Шаги

  1. Настройте qualificationУкажите обязательные поля, consent text, критерии MQL и fallback на оператора.
  2. Подключите каналыПривяжите Telegram через одноразовый код и подтвердите email.
  3. Выполните тестовый диалогПройдите happy path, отказ от consent и неполные контакты.
  4. Проверьте delivery ledgerУбедитесь, что lead saved предшествует queued/sent, retry не создаёт дубликат.
Как проверить результат

Один lead id виден в Conversations и доставлен в Telegram/email без дублей.

Если не работает

При ошибке канала проверьте retry state и dead-letter, не повторяйте ввод лида вручную.

Разделы приложения

Открыть подробное руководство

Для каждого экрана приложения подготовлена отдельная страница с кнопками, безопасными примерами значений, CLI/API и восстановлением по кодам ошибок.

Открыть подробное руководство →

Роль в экосистеме

IAM.Bot добавляет на сайт диалоговую точку входа: отвечает по разрешённым материалам, уточняет потребность и переводит разговор в лид. Профиль бота определяет домены, prompt, knowledge scope, каналы доставки и правила эскалации.

Подключение виджета

<script src="https://cdn.iambot.ru/widget.js" data-slug="your-company" async></script>

CDN-скрипт загружается асинхронно. Origin страницы должен входить в allowlist профиля. Если slug или credentials ещё не настроены, виджет запускает безопасный onboarding вместо молчаливой ошибки.

Диалог и лид

Бот сначала решает вопрос из knowledge profile, затем собирает только нужные контактные данные и согласие на связь. Лид фиксируется durable до отправки в Telegram и email. Ошибка одного канала доставки не должна уничтожать запись; повтор выполняется идемпотентно.

Надёжность inference

Модельный слой использует retry с bounded backoff и fallback между сконфигурированными провайдерами. Переключение не меняет tenant scope и не дублирует пользовательское сообщение. При полной недоступности AI виджет всё равно принимает контакт и сообщает о последующей связи.

Безопасность

Публичный клиент не содержит provider keys. CORS/origin policy, rate limiting, санитизация HTML и аудит доставки проверяются отдельно для каждого tenant.