umbot
    Preparing search index...

    Class AlisaAdapter

    Адаптер, обеспечивающий полную поддержку платформы Яндекс.Диалоги (Алиса). Позволяет разрабатывать навыки для Алисы на TypeScript с использованием всего функционала платформы: от обработки голосовых запросов до работы с карточками и кнопками.

    Подключение адаптера не требует изменения существующей бизнес-логики: после интеграции все команды и обработчики, написанные для umbot, автоматически становятся доступны для Алисы. Единый интерфейс позволяет одновременно использовать одну бизнес-логику для нескольких платформ (Telegram, VK, Алиса и др.) без дублирования кода.

    Этот адаптер автоматически обрабатывает входящие webhook`и от Алисы, преобразует их в унифицированный формат фреймворка и формирует ответ, совместимый с требованиями платформы. Подключается одной строкой и не мешает работе других адаптеров (например, для Telegram или VK).

    Поддерживает:

    • голосовые и текстовые запросы;
    • сохранение состояния (user/application/session);
    • карточки, кнопки, TTS-эффекты;
    • health-check (ping → pong);

    Подключается как любой другой адаптер: bot.use(new AlisaAdapter(token)). Несколько адаптеров могут работать одновременно — система сама выберет подходящий на основе заголовков и структуры входящего запроса.

    // Простейший навык для Алисы, который отвечает на приветствие
    import { Bot } from 'umbot';
    import { AlisaAdapter } from 'umbot/plugins';

    const bot = new Bot()
        .use(new AlisaAdapter('YOUR_OAUTH_TOKEN')) // Подключаем адаптер для Алисы
        .addCommand('start', ['привет'], (_text, ctx) => {
            ctx.text = 'Привет! Я твой первый навык для Алисы';
        });

    bot.start('localhost', 3000);

    Hierarchy (View Summary)

    Index

    Constructors

    constructor

    Properties

    _platformOptions? _token? appContext? isVoice limit MAX_TIME_REQUEST platformName signatureName? WARMING_TIME_REQUEST

    Methods

    _getResponse _initTTS _timeLimitLog destroy getContent getLocalStorage getProcessingTime getQueryExample getRatingContext init isCorrectQuery isLocalStorage isPlatformOnQuery send setLocalStorage setQueryData soundProcessing updateTimeStart isVoice

    Constructors

    Properties

    Protected Optional_platformOptions

    _platformOptions?: IAdapterOptions

    Protected Optional_token

    _token?: string
    appContext?: AppContext<unknown, string | IAlisaWebhookRequest>

    Контекст приложения

    isVoice: boolean = true

    Определяет тип платформы(голосовая или чат-бот)

    limit: number | null = null

    Определяет лимит платформы. В значение указывается количество запросов, которое можно отправить платформе за 1 секунду. В случае если у платформы нет ограничений, можно указать 0 или null. По умолчанию null

    MAX_TIME_REQUEST: number = 2900

    Максимальное время ответа навыка в миллисекундах при превышении этого времени, будет отправлена ошибка

    platformName: string = T_ALISA

    Имя платформы

    signatureName?: string

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

    WARMING_TIME_REQUEST: number = 2000

    Время ответа навыка в миллисекундах при превышении этого времени, будет отправлено предупреждение

    Methods

    Protected_getResponse

    Protected_initTTS

    Protected_timeLimitLog

    • _timeLimitLog(controller: BotController): void

      При превышении установленного времени исполнения, пишет информацию в лог После вызова getContent() автоматически проверяется время выполнения. Если оно превышает 2000 мс — пишется warning, если >2900 мс — ошибка.

      Parameters

      Returns void

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

      Parameters

      • _bot: Bot

        Основной класс приложения

      Returns void | Promise<void>

    • Формирует тело ответа для отправки пользователю.

      Возвращает платформо-специфичный ответ (например, JSON для Алисы). Для платформ, которые отправляют ответ напрямую (например, Telegram через sendMessage), метод может возвращать { ok: true } или аналог.

      Parameters

      • controller: BotController

        контроллер с готовым ответом

      • OptionalstateData: Record<string, unknown> | null

        данные для локального хранилища

      Returns Promise<IAlisaWebhookResponse>

      ответ в формате, понятном платформе

    • Генерирует пример входящего запроса для локального тестирования вашего приложения. Позволяет эмулировать запрос от платформы с заданным текстом, ID пользователя, номером сообщения и состоянием. Необходимо указывать для того, чтобы можно было корректно проверить работоспособность приложения.

      Обязательно определите метод, если планируется тестирования приложения через инструменты предоставляемые платформой. Это существенно упростит процесс разработки приложения.

      Parameters

      • query: string

        Запрос пользователя

      • userId: string

        Идентификатор пользователя

      • count: number

        Порядковый номер запроса

      • state: string | IAlisaRequestState

        Данные из локального хранилища

      Returns Record<string, unknown>

    • Инициализация адаптера. Определять не обязательно. Стоит указывать в случаях, когда нужно выполнить доп логику, например указать токены или писать какую-то статистику по использованию.

      Parameters

      Returns void

    • Проверяет полученный запрос от платформы на корректность. Из коробки проверка идет по sha256. Если по какой-то причине поведение по умолчанию не подходит, то просто переопределите метод.

      Parameters

      Returns boolean

    • Возвращает признак того, соответствует ли запрос текущей платформе или нет

      Parameters

      • query: IAlisaWebhookRequest

        Запрос, который пришел в приложение

      • Optional_headers: Record<string, unknown>

        Заголовок с которым был отправлен запрос

      Returns boolean

      true, если запрос относится к этой платформе, иначе false

      isPlatformOnQuery(query, headers) {
        return headers?.['x-telegram-bot-api-secret-token'] === this._token;
      }

      isPlatformOnQuery(query) {
        return typeof query === 'object' && query.meta?.session_id;
      }

    • Обрабатывает входящий запрос и заполняет контроллер данными.

      Обязательно установите:

      • controller.userCommand и controller.originalUserCommand — текст сообщения пользователя
      • controller.userId — уникальный ID пользователя
      • controller.appType = this.platformName

      Опционально:

      • controller.userToken — если платформа присылает токен авторизации
      • controller.userMeta — если платформа присылает метаданные
      • controller.state — если платформа поддерживает локальное хранилище
      • controller.nlu — если платформа присылает NLU/интенты (через controller.nlu.setNlu(...))

      Parameters

      Returns boolean

      false, если запрос повреждён или не может быть обработан; иначе true

    Settings

    Member Visibility

    On This Page

    Constructors
    Properties
    Methods