Сделать Slack-ботов на Java за считанные минуты

• Slack Bot ⇒ Расширить класс бота.
• Обработчик команд косой черты ⇒ Аннотируйте свой класс с помощью Spring @Controllerи получите метод с требуемым @RequestMappingпутем, получающий набор параметров запроса, как показано в примере.
• Slack Incoming Webhook ⇒ Просто POSTпозвоните в RichMessage всякий раз, когда вы хотите что-то сообщить своим пользователям Slack.
• Slack Outgoing Webhook ⇒ То же, что и обработчик команд Slash.

Получение сообщений

Для ботов , вы получите сообщение как события . Почти для всех действий Slack запускает соответствующее событие для него. К сожалению, он не генерирует соответствующие события, когда кто-то напрямую отправляет сообщение боту (прямое сообщение) или упоминает бота на канале (например @bot). Он просто генерирует событие типа messageдля всех отправленных сообщений (непосредственно боту и каналам, в которых бот является участником).

Но угадайте, что вы сейчас в нужном месте — BotKit справится с этим за вас. Он поддерживает три дополнительные мероприятия EventType.DIRECT_MESSAGE, EventType.DIRECT_MENTIONи EventType.ACKв дополнении ко всем поддерживаемым в настоящее время гача событий . Первые два события говорят сами за себя, но EventType.ACKэто не что иное, как событие подтверждения, которое подтверждает доставку ранее отправленного сообщения.

Чтобы получать и анализировать слабые бот-события, вам нужно иметь следующее:

@Controller(events = {EventType.DIRECT_MENTION, EventType.DIRECT_MESSAGE})
public void onReceiveDM(WebSocketSession session, Event event) {
    if (event.getText().contains("hi")) {
        reply(session, event, new Message("Hi, I am " + slackService.getCurrentUser().getName()));
    }
}

@Controller(events = EventType.MESSAGE, pattern = "([a-zA-Z ]{1,})(\\d+)([a-zA-Z ]{1,})")
public void onReceiveMessage(WebSocketSession session, Event event, Matcher matcher) {
    reply(session, event, new Message("First group: " + matcher.group(0) + "\n" +
            "Second group: " + matcher.group(1) + "\n" +
            "Third group: " + matcher.group(2) + "\n" +
            "Fourth group: " + matcher.group(3)));
}

@Controller(events = EventType.MESSAGE)
public void onReceiveMessage(WebSocketSession session, Event event) {
    reply(session, event, new Message("Hi, this is a message!"));
}

{
    "id": 1,
    "type": "message",
    "channel": "C024BE91L",
    "text": "Hi, this is a message!"
}

    /**
     * Conversation feature of Botkit. This method is the starting point of the conversation (as it
     * calls {@link Bot#startConversation(Event, String)} within it. You can chain methods which will be invoked
     * one after the other leading to a conversation. You can chain methods with {@link Controller#next()} by
     * specifying the method name to chain with.
     *
     * @param session
     * @param event
     */
    @Controller(pattern = "(setup meeting)", next = "confirmTiming")
    public void setupMeeting(WebSocketSession session, Event event) {
        startConversation(event, "confirmTiming");   // start conversation
        reply(session, event, new Message("Cool! At what time (ex. 15:30) do you want me to set up the meeting?"));
    }

    /**
     * This method is chained with {@link SlackBot#setupMeeting(WebSocketSession, Event)}.
     *
     * @param session
     * @param event
     */
    @Controller(next = "askTimeForMeeting")
    public void confirmTiming(WebSocketSession session, Event event) {
        reply(session, event, new Message("Your meeting is set at " + event.getText() +
                ". Would you like to repeat it tomorrow?"));
        nextConversation(event);    // jump to next question in conversation
    }

    /**
     * This method is chained with {@link SlackBot#confirmTiming(WebSocketSession, Event)}.
     *
     * @param session
     * @param event
     */
    @Controller(next = "askWhetherToRepeat")
    public void askTimeForMeeting(WebSocketSession session, Event event) {
        if (event.getText().contains("yes")) {
            reply(session, event, new Message("Okay. Would you like me to set a reminder for you?"));
            nextConversation(event);    // jump to next question in conversation  
        } else {
            reply(session, event, new Message("No problem. You can always schedule one with 'setup meeting' command."));
            stopConversation(event);    // stop conversation only if user says no
        }
    }

    /**
     * This method is chained with {@link SlackBot#askTimeForMeeting(WebSocketSession, Event)}.
     *
     * @param session
     * @param event
     */
    @Controller
    public void askWhetherToRepeat(WebSocketSession session, Event event) {
        if (event.getText().contains("yes")) {
            reply(session, event, new Message("Great! I will remind you tomorrow before the meeting."));
        } else {
            reply(session, event, new Message("Oh! my boss is smart enough to remind himself :)"));
        }
        stopConversation(event);    // stop conversation
    }