Перейти к основному содержимому

Подключение Slack для проекта на JAICF

Чтобы подключить Slack для проекта на JAICF:

  1. Подготовьте проект.
  2. Подключите канал.
  3. Протестируйте бота.

Подготовка проекта​

Перед подключением канала предварительно подготовьте проект JAICF:

  1. Укажите в файле build.gradle.kts в зависимостях настройки:
dependencies {
    // ...
    implementation("com.just-ai.jaicf:jaicp:$jaicfVersion")
    implementation("com.just-ai.jaicf:slack:$jaicfVersion")
}
подсказка
Замените $jaicfVersion последней версией фреймворка.
  1. Сконфигурируйте в зависимости от способа подключения к платформе:

  • long polling — бот будет сам подключаться к серверу Just AI при взаимодействии с платформой. Простое решение, подходит для локальной разработки и отладки.

    Для этого способа укажите в файле JaicpPoller.kt канал SlackChannel:

package com.just-ai.jaicf.template.connections

fun main() {
    JaicpPollingConnector(
        templateBot,
        accessToken,
        channels = listOf(
            ChatApiChannel,
            ChatWidgetChannel,
            TelephonyChannel,
            SlackChannel
        )
    ).runBlocking()
}

  • webhook — по указанной ссылке бот будет принимать сообщения платформы. Необходимо конфигурировать для подключения в JAICP Cloud.

    Для этого способа укажите в файле JaicpServer.kt канал SlackChannel:

package com.just-ai.jaicf.template.connections

fun main() {
    JaicpServer(
        botApi = templateBot,
        accessToken = accessToken,
        channels = listOf(
            ChatApiChannel,
            ChatWidgetChannel,
            TelephonyChannel,
            SlackChannel
        )
    ).start(wait = true)
}

Подключение канала​

Для подключения канала используйте инструкцию.

Тестирование бота​

Перейдите в окно диалога с ботом в Slack, выбрав своего бота из списка в подразделе Apps в рабочем пространстве. Отправьте в диалог приветственную/активационную фразу, предусмотренную вашим сценарием. После этого должен начаться ваш диалог с ботом.

Нативные возможности канала​

Использование данных из запроса​

В канале Slack можно получить из запроса дополнительные данные. Для этого приведите тип запроса в блоке action к SlackBotRequest:

action {
    val slackRequest = request.slack
    slackRequest?.command?.payload
}

Нативные реакции​

JAICF предоставляет универсальные реакции, доступные во всех каналах, а также реакции, уникальные для Slack. Чтобы использовать специфические реакции Slack, используйте reactions.slack, например:

action {
    reactions.say("Привет!")
    reactions.slack?.respond(listOf())
}

Вы также можете напрямую обратиться к объекту с контекстом запроса через reactions.slack.context:

action {
    reactions.slack?.context?.client()
}