Как создать Slack-бота
Опубликовано: 2022-01-29Slack коренным образом изменил то, как сотрудники в командах, офисах и целых организациях общаются и сотрудничают друг с другом. Существует множество способов настроить Slack вашей компании, но, помимо использования каналов, файлов GIF, интеграции приложений и смайликов-реакций, наиболее динамичный способ улучшить работу Slack — это использовать ботов.
Частично интерфейс чат-бота и частично автоматизированный механизм действий, боты Slack имеют массу потенциальных применений. В рамках определенного канала более 100 ботов, доступных в настоящее время в каталоге ботов Slack, могут вызывать в воображении что угодно, от опроса, опроса или формы отслеживания времени до аналитики сообщений, заказов на обед и рекомендаций ресторана — и все это с помощью быстрого прямого сообщения (DM). или команда косой черты.
Многие поставщики программного обеспечения для бизнеса, в том числе SurveyMonkey и Zenefits (посетите сайт Zenefits), уже создали ботов, которых вы можете включить в Slack. Но вам не нужно ждать, пока кто-то другой создаст бота Slack, который нужен вашей организации. Используя ресурсы для разработчиков, документацию и учебные пособия Slack, вы можете позволить компании помочь вам в создании собственного бота Slack.
PCMag поговорил с Амиром Шеватом, руководителем отдела по связям с разработчиками в Slack, и Джоном Аганом, старшим менеджером по связям с разработчиками в Slack (посетите сайт Zenefits), о том, как создать бота Slack с нуля. Этот процесс требует некоторых значительных ноу-хау от разработчиков, но Шват и Аган показали нам два простых сценария создания бота, к которым могут относиться все компании: создание базового бота службы поддержки и включение уведомлений в канале. Читайте пошаговые инструкции о том, как создать собственного бота Slack.
1. 1. Создайте новое приложение Slack
Для начала откройте левое меню навигации в клиенте Slack и нажмите «Приложения и интеграции». В верхней правой части каталога приложений нажмите «Создать». Это приведет вас к интерфейсу программирования приложений (API) Slack, где вы нажмете «Начать сборку» в центре страницы. Дайте вашему приложению имя (в данном случае Helpdesk), выберите команду, в которой вы хотите развернуть приложение, и нажмите «Создать приложение».
Это приведет вас к странице основной информации для вашего приложения. Для дополнительной настройки прокрутите вниз до поля «Отображаемая информация», в котором вы можете добавить описание, изменить цвет фона и добавить значок для своего будущего бота. Например, для бота службы поддержки Аган дал боту смайлик робота в качестве значка.
Это приведет вас к странице основной информации для вашего приложения. Для дополнительной настройки прокрутите вниз до поля «Отображаемая информация», в котором вы можете добавить описание, изменить цвет фона и добавить значок для своего будущего бота. Например, для бота службы поддержки Аган дал боту смайлик робота в качестве значка.
2. 2. Пишите сообщения своего бота
Теперь, когда вы создали свое приложение, Slack API предоставляет вам несколько вариантов настройки того, что оно может делать. Для нашего приложения службы поддержки мы создаем бота, который упрощает отправку заявок в службу поддержки от вашего имени. Во-первых, Аган из Slack сказал, что вам нужно написать сообщения, которые будут появляться, когда пользователь вводит команду с косой чертой.
В разделе «Сообщения» меню Slack API выберите инструмент «Создание сообщений». Это дает вам предварительно отформатированный код JSON с пространством для ввода, а затем предварительного просмотра текста. Для этого бота Аган набрал: «Хотите отправить этот тикет в службу поддержки?»
Когда пользователь нажимает «Создать», чтобы подать заявку в службу поддержки, появляется это подтверждающее сообщение. Итак, рядом с текстом Аган добавил команду для :white_check_mark: чтобы дать пользователю Slack смайлик с зеленой галочкой, подтверждающий отправку его билета. Таким образом, вы написали код автоматического сообщения своего бота. Держите это под рукой, потому что оно вам понадобится немного позже.
В разделе «Сообщения» меню Slack API выберите инструмент «Создание сообщений». Это дает вам предварительно отформатированный код JSON с пространством для ввода, а затем предварительного просмотра текста. Для этого бота Аган набрал: «Хотите отправить этот тикет в службу поддержки?»
Когда пользователь нажимает «Создать», чтобы подать заявку в службу поддержки, появляется это подтверждающее сообщение. Итак, рядом с текстом Аган добавил команду для :white_check_mark: чтобы дать пользователю Slack смайлик с зеленой галочкой, подтверждающий отправку его билета. Таким образом, вы написали код автоматического сообщения своего бота. Держите это под рукой, потому что оно вам понадобится немного позже.
3. 3. Добавить уведомления
Аган и Шеват представили отдельные демонстрации, но Шеват объяснил, что одна из наиболее распространенных интеграций ботов, которую Slack видел с момента открытия этой возможности, — это бот, который получает уведомления от сторонних сервисов. Это может быть что-то вроде еженедельного отчета о продажах от Salesforce (посетите сайт Salesforce.com) или, в данном случае, от платформы службы поддержки, для которой ваш бот создает заявки.
4. 4. Активировать входящие вебхуки
Чтобы добавить уведомления в свой бот службы поддержки (Шеват продемонстрировал эти шаги на отдельном примере, который он назвал «ReportBot»), вам сначала нужно включить входящие веб-перехватчики. Веб-перехватчик — это простой обратный вызов HTTP, который отправляет сообщение на URL-адрес при запуске определенного действия.
Для этого вернитесь на страницу основной информации вашего Slack API. В первом поле написано «Добавить функции и возможности». Выберите опцию «Входящие вебхуки». В верхней правой части страницы «Активировать входящие веб-перехватчики» находится кнопка-ползунок. Нажмите на нее, чтобы переключить кнопку с «Выкл.» на «Вкл.».
Для этого вернитесь на страницу основной информации вашего Slack API. В первом поле написано «Добавить функции и возможности». Выберите опцию «Входящие вебхуки». В верхней правой части страницы «Активировать входящие веб-перехватчики» находится кнопка-ползунок. Нажмите на нее, чтобы переключить кнопку с «Выкл.» на «Вкл.».
5. 5. Авторизация уведомлений канала
После активации веб-перехватчиков прокрутите вниз и нажмите «Добавить новый веб-перехватчик в команду». Вам будет предложено выбрать канал, на который вы хотите, чтобы ваш бот публиковал автоматические уведомления. В этом примере Шват выбрал #general, но в этом случае вы можете опубликовать это уведомление в своей команде службы поддержки или на канале ИТ-отдела. Таким образом, не только будет создан новый тикет на вашей платформе службы поддержки, но и будет отправлено автоматическое уведомление на канал Slack ИТ-отдела, чтобы уведомить их о тикете. Выбрав свой канал, нажмите «Авторизовать».
6. 6. Настройте свой веб-хук
После авторизации вы увидите основной URL-адрес веб-перехватчика на странице и кнопку для его копирования. Выше находится ваш образец запроса на завивку, который вы можете скопировать в текстовый редактор, чтобы сказать все, что хотите. В этом сценарии вместо «Hello, World» вы можете написать «Отправлен новый запрос в службу поддержки» или что-то еще, точно описывающее уведомления, которые вы хотите, чтобы ваш бот отправлял. Отсюда вы можете взять код запроса curl и URL-адрес Webhooks и запустить его в любом скрипте. Этот код также понадобится вам на следующем шаге.
7. 7. Создайте своего бота
Теперь, когда у вас есть написанный код сообщения и удобный URL-адрес Webhooks, вы готовы создать своего бота. Для большинства интеграций Slack требуется сервер для ответа на запросы и их инициирования, особенно когда задействована автоматическая логика ботов и команды косой черты. Slack поддерживает ряд провайдеров, но Аган создал бота службы поддержки, используя сервис под названием Glitch.
Этот шаг требует некоторого опыта кодирования. Аган создал новый проект Glitch, а затем начал добавлять код JavaScript с открытым исходным кодом. Если вы не хотите писать весь код самостоятельно (или изобретать велосипед), вы можете выбрать один из бесчисленных фреймворков и библиотек ботов для импорта базовой логики бота.
Аган назвал свой проект «Index.js», добавил созданный им самостоятельно пакет под названием TinySpeck, а затем вставил его в код Message Builder, который мы написали ранее. Теперь, когда основной код бота на месте, он просто добавил команду обратного вызова для запуска нового тикета и подтверждающего сообщения «Билет службы поддержки был создан». Вот и все. Если вы хотите добавить свой код Webhooks для запуска уведомления в указанном вами канале, вы также можете вставить его сюда. Glitch создает уникальный URL-адрес для вашего бот-сервера, поэтому скопируйте этот URL-адрес, как только вы добавите весь свой код, и мы перейдем к следующему шагу.
Этот шаг требует некоторого опыта кодирования. Аган создал новый проект Glitch, а затем начал добавлять код JavaScript с открытым исходным кодом. Если вы не хотите писать весь код самостоятельно (или изобретать велосипед), вы можете выбрать один из бесчисленных фреймворков и библиотек ботов для импорта базовой логики бота.
Аган назвал свой проект «Index.js», добавил созданный им самостоятельно пакет под названием TinySpeck, а затем вставил его в код Message Builder, который мы написали ранее. Теперь, когда основной код бота на месте, он просто добавил команду обратного вызова для запуска нового тикета и подтверждающего сообщения «Билет службы поддержки был создан». Вот и все. Если вы хотите добавить свой код Webhooks для запуска уведомления в указанном вами канале, вы также можете вставить его сюда. Glitch создает уникальный URL-адрес для вашего бот-сервера, поэтому скопируйте этот URL-адрес, как только вы добавите весь свой код, и мы перейдем к следующему шагу.
8. 8. Включить интерактивные сообщения
Вы уже создали своего бота службы поддержки, поэтому теперь все, что вам нужно сделать, это вернуться в API. Вместо выбора «Создать новое приложение» просто нажмите «Управление приложениями» и выберите приложение Helpdesk. На странице «Основная информация» выберите «Интерактивные сообщения» в поле «Добавить функции и возможности». Оказавшись на этой странице, нажмите «Включить интерактивные сообщения», вставьте URL-адрес своего сервера из предыдущего шага и сохраните изменения.
9. 9. Создание косой черты
Как только это будет сделано, вернитесь в поле «Добавить функции и функциональные возможности» и перейдите в «Команды косой черты». Нажмите «Создать новую команду». Это приведет вас к странице формы с несколькими полями.
В поле «Команда» введите команду с косой чертой. В этом случае Аган набрал «/ helpdesk». В поле URL-адрес запроса он вставил тот же URL-адрес сервера из Glitch. Затем все, что вам нужно сделать, это ввести краткое описание команды («Создать тикет в службу поддержки»), подсказку о том, как пользователь должен ввести свой запрос, проверить предварительный просмотр под ним, чтобы убедиться, что все выглядит правильно, а затем нажать «Сохранить». .
В поле «Команда» введите команду с косой чертой. В этом случае Аган набрал «/ helpdesk». В поле URL-адрес запроса он вставил тот же URL-адрес сервера из Glitch. Затем все, что вам нужно сделать, это ввести краткое описание команды («Создать тикет в службу поддержки»), подсказку о том, как пользователь должен ввести свой запрос, проверить предварительный просмотр под ним, чтобы убедиться, что все выглядит правильно, а затем нажать «Сохранить». .
10. 10. Установите свое приложение
Бот службы поддержки готов к работе. Вернувшись на главную страницу API вашего приложения, перейдите на страницу «Установить приложение», которую можно найти в меню «Настройки» слева. Нажмите «Установить приложение для вашей команды». Это предложит вам авторизовать приложение. Как только вы это сделаете, ваш бот заработает. Вы увидите зеленую надпись «Успех!» лента уведомлений поверх экрана, которая подтверждает, что ваш бот установлен.
11. 11. Испытайте своего бота
Вернувшись в клиент Slack вашей команды, перейдите на канал, на котором вы указали, чтобы заставить вашего нового бота работать. Введите команду с косой чертой с запросом, например: «/helpdesk мой Wi-Fi не работает». Затем вам будет предложено с помощью кнопки создать билет службы поддержки. Поздравления; вы только что создали работающего Slack-бота!