Добрый день, уважаемые хабрачитатели! О платформе JAICP было не так много статей на хабре. К сожалению, не всегда официальная документация может помочь в решении определенной проблемы. Я решил написать серию статей-руководств по работе с JAICP. В первой статье я расскажу о настройке Google SMTP сервера для отправки email сообщений из чат ботов на платформе JAICP. Кому интересно, прошу под кат.

JAICP - это платформа для разработки виртуальных ассистентов (голосовых и чат ботов) на языках программирования Javascript или Kotlin от компании  Just AI. Платформа предоставляет удобную встроенную среду разработки, встроенный NLU-сервис CAILA для ускорения обучения чат-ботов, а также детальную статистику и аналитику для создаваемых чат ботов. На сайте JAICP есть серия практических туториалов по созданию чат ботов.

В официальной документации JAICP по отправке email сообщений дается только краткая информация по конфигурации SMTP сервера. Здесь я расскажу о настройке Google SMTP сервера в случае двухфакторной аутентификации, поскольку она является немного сложнее.

Настройка аккаунта Google как SMTP сервера

Для начала нужно получить пароль для приложения. Перейдем по ссылке в Google аккаунт. В левом меню выберем Безопасность (Security), затем найдем секцию Signing in to Google и App Passwords. В поле Select app выберем Mail и в Select device выберем Other. Затем нажмем кнопку Generate.

Скопируем пароль. Он нам понадобится на следующем шаге.

Следующий шаг нужен в случае двухфакторной аутентификации. Нужно перейти по этой ссылке. Там должно появиться разрешение на предоставление доступа к аккаунту Google:

На все вопросы нажимаем подтверждение.

Если у вас нет двухфакторной аутентификации, то скорее всего этот шаг можно опустить.

Настройка SMTP сервера и отправка сообщения на платформе JAICP

Нам нужно добавить настройки SMTP сервера в приложении на JAICP. Добавим такие строки в chatbot.yaml:

injector:
  smtp:
    host: 'smtp.gmail.com' 
    port: 465
    from: '<your_email>@gmail.com'
    user: '<your_email>@gmail.com' 
    password: '<password>'

Здесь в поле your_email указываем имя пользователя в аккаунте Google, в поле password вставим наш скопированный пароль.

Самое время отправить какое-нибудь тестовое сообщение. Добавим такой тестовый стейт в main.sc:

state: TestEmail
        q: * testemail *
        script:
            var result = $mail.sendMessage("<target_email_address>", "Test", "Message from my bot");
            log("TestEmail");
            log(result["status"]);
        a: Сообщение отправлено.

В этом коде мы используем встроенный сервис $mail. Здесь подробно описаны параметры методов этого сервиса. В методе sendMessage первым параметром (target_email_address) передается email адрес адресата, вторым параметром - тема сообщения, а третьим - текст сообщения.

Теперь нужно добавить внешний канал для тестирования отправки, например, чатвиджет, поскольку в тестовом виджете вы будете натыкаться на ошибку о превышении лимита CPU.

На этом все. Удачи в разработке чат ботов на платформе JAICP.