Расширяемая архитектура плагинов — Создавайте пользовательские возможности (Будущее)

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

Почему плагины важны для продвинутых случаев использования

Стандартные виджеты не могут предсказать каждое бизнес-требование. Вам может понадобиться:

• Анализ настроений для маршрутизации недовольных клиентов к человеческим агентам
• Интеграция CRM для обогащения разговоров историей покупок клиентов
• Пользовательская модерация для соблюдения специфических для бренда политик контента
• Специализированные рендереры для данных, специфичных для отрасли (медицинские диаграммы, финансовые графики, юридические цитаты)
• Триггеры автоматизации рабочего процесса (создание тикета поддержки, когда появляются определенные ключевые слова)

Хуки жизненного цикла для чистой интеграции

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

• onBeforeMessageSend — предварительная обработка пользовательских сообщений перед отправкой на бэкенд
• onAfterMessageReceive — постобработка ответов ИИ перед рендерингом
• onConversationStart — инициализация состояния плагина, когда начинается разговор
• onConversationEnd — очистка ресурсов, регистрация аналитики
• onWidgetOpen / onWidgetClose — отслеживание вовлеченности, запуск побочных эффектов
• onError — пользовательская обработка или отчет об ошибках

Предобработчики и постобработчики сообщений

Предобработчики модифицируют пользовательские сообщения перед отправкой:
- Проверка орфографии и автозамена
- Фильтр ненормативной лексики или модерация контента
- Извлечение данных (обнаружение электронных адресов, номеров телефонов, идентификаторов заказов)
- Обнаружение настроений

Постобработчики модифицируют ответы ИИ перед рендерингом:
- Улучшение Markdown (преобразование таблиц в интерактивные компоненты)
- Обогащение ссылок (предварительный просмотр URL-адресов, раскрытие метаданных)
- Фильтрация соблюдения (редактирование PII, чувствительных финансовых данных)

Безопасность через песочницу

Плагины не могут компрометировать безопасность или стабильность виджета:

• Плагины работают в изолированных областях JavaScript (не могут получать доступ к глобальным переменным или загрязнять пространство имен)
• Доступ к API ограничен (плагины могут вызывать только разрешенные домены)
• Доступ к DOM ограничен (плагины не могут изменять интерфейс виджета вне обозначенных областей рендеринга)
• Время выполнения ограничено (долговечные плагины завершаются, чтобы предотвратить зависания интерфейса)

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

WidgetSDK.registerPlugin({
  name: 'sentiment-analyzer',
  version: '1.0.0',
  hooks: {
    onBeforeMessageSend: async (message, context) => {
      const sentiment = await analyzeSentiment(message.text);
      return { ...message, metadata: { sentiment } };
    },
    onAfterMessageReceive: (message, context) => {
      if (message.metadata?.sentiment < -0.5) {
        context.escalateToHuman(message);
      }
      return message;
    }
  }
});