Как построить слабого бота

Slack кардинально изменил то, как сотрудники в командах, офисах и целых организациях общаются и сотрудничают друг с другом. Существует множество способов настроить Slack вашей компании, но помимо использования каналов, файлов GIF, интеграции приложений и реакционных смайликов, наиболее динамичный способ улучшить ваш опыт Slack - это использовать ботов.

Частично интерфейс чатбота и частично автоматизированный механизм действий, Slack-боты имеют массу потенциальных применений. В пределах определенного канала более 100 ботов, доступных в настоящее время в Slack's Bot Directory, могут вызывать что угодно - от опроса, опроса или формы отслеживания времени до аналитики сообщений, заказов на обеды и рекомендаций ресторана - и все это с помощью быстрого прямого сообщения (DM). или косая черта.

Многие поставщики программного обеспечения для бизнеса, в том числе SurveyMonkey и Zenefits, уже создали ботов, которые вы можете включить в Slack. Но вам не нужно ждать, пока кто-то еще создаст бот Slack, который нужен вашей организации. Используя ресурсы разработчика Slack, документацию и учебные пособия, вы можете позволить компании вести вас через создание собственного бота Slack.

PCMag рассказал Амиру Шевату, руководителю отдела по связям с разработчиками в Slack, и Джону Агану, старшему менеджеру по связям с разработчиками в Slack, о том, как создать бот Slack с нуля. Этот процесс требует значительных ноу-хау разработчиков на местах, но Шеват и Аган рассказали нам о двух простых сценариях создания ботов, которые могут быть связаны со всеми предприятиями: создание базового бота службы поддержки и включение уведомлений в канале. Читайте пошаговые инструкции о том, как создать свой собственный бот Slack.

1 1. Создайте новое приложение Slack

Для начала откройте левое навигационное меню в своем Slack-клиенте и нажмите «Приложения и интеграции». В верхней правой части каталога приложений нажмите «Построить». Это приведет вас к интерфейсу прикладного программирования Slack (API), где вы нажмете «Начать сборку» в центре страницы. Дайте вашему приложению имя (в данном случае Helpdesk), выберите команду, в которой вы хотите развернуть приложение, и нажмите «Создать приложение».

Вы перейдете на страницу «Основная информация» для своего приложения. Для дополнительной настройки прокрутите вниз до поля «Отображать информацию», в котором вы можете добавить описание, изменить цвет фона и добавить значок для вашего будущего бота. Например, для бота из службы поддержки Аган дал роботу смайлик робота в качестве значка.



2 2. Напишите сообщения своего бота

Теперь, когда вы создали свое приложение, Slack API предоставляет вам ряд опций, чтобы начать настраивать, что оно может делать. Для нашего приложения Helpdesk мы создаем бота, который позволяет легко подать заявку в службу поддержки от вашего имени. Во-первых, Аган из Slack сказал, что вам нужно написать сообщения, которые будут появляться, когда пользователь вводит команду слэша.

В разделе «Сообщения» меню Slack API выберите инструмент «Построитель сообщений». Это дает вам некоторый предварительно отформатированный код JSON с пространством для ввода и предварительного просмотра текста. Для этого бота Аган набрал: «Хотите подать этот билет в службу поддержки?»

Когда пользователь нажимает «Создать», чтобы подать заявку в службу поддержки, это сообщение с подтверждением, которое появится. Итак, рядом с текстом, Аган добавил команду для: white_check_mark: чтобы дать пользователю Slack зеленую галочку смайлика, подтверждающую отправку его билета. Точно так же вы написали автоматизированный код сообщения вашего бота. Держите это под рукой, потому что оно вам понадобится чуть позже.



3 3. Добавить уведомления

Аган и Шеват дали отдельные демонстрации, но Шеват объяснил, что одна из наиболее распространенных интеграций ботов, которую Slack видел с момента открытия возможности, - это бот, который получает уведомления от сторонних сервисов. Это может быть что-то вроде еженедельного отчета о продажах от Salesforce или, в данном случае, от платформы службы поддержки, для которой ваш бот создает билеты.



4 4. Активируйте входящие веб-хуки

Чтобы добавить уведомления в своего бота Helpdesk (Шеват продемонстрировал эти шаги на отдельном примере, который он назвал «ReportBot»), вы должны сначала включить входящие веб-хуки. Webhook - это простой HTTP-обратный вызов, который отправляет сообщение на URL-адрес при срабатывании определенного действия.

Для этого вернитесь на страницу «Основная информация» своего Slack API. В первом окне написано «Добавить функции и функциональность». Выберите опцию «Входящие веб-хуки». В правой верхней части страницы Activate Incoming Webhooks находится кнопка-ползунок. Нажмите на нее, чтобы переключить кнопку с Off на On.



5 5. Авторизация уведомлений канала

После активации веб-крючков прокрутите вниз и нажмите «Добавить новый веб-крюк в команду». Вам будет предложено выбрать канал, на который вы хотите, чтобы ваш бот публиковал автоматические уведомления. В этом примере Shevat выбрал #general, но в этом случае вы можете разместить это уведомление в своей группе поддержки или на канале ИТ-отдела. Таким образом, на вашей платформе службы поддержки будет создан не только новый тикет, но и автоматическое уведомление будет отправлено на канал Slack ИТ-отдела, чтобы уведомить их о тикете. Выбрав канал, нажмите «Авторизовать».



6 6. Настройте свой Webhook

После авторизации вы увидите основной URL-адрес Webhook на странице и кнопку для его копирования. Выше это пример запроса скручивания, который вы можете скопировать в текстовый редактор, чтобы сказать все, что вы хотите. В этом сценарии вместо «Hello, World» вы можете написать «Новый отправленный тикет в службу поддержки» или что-то еще, что точно описывает уведомления, которые вы хотите, чтобы ваш бот отправлял. Отсюда вы можете взять свой код запроса curl и URL Webhooks и запустить его в любом скрипте. Этот код вам понадобится и на следующем шаге.



7 7. Построй свой бот

Теперь, когда вы написали свой код сообщения и ваш URL-адрес Webhooks, вы готовы создать своего бота. Большинство Slack-интеграций требуют, чтобы сервер отвечал и инициировал запросы, особенно когда задействованы автоматизированная логика бота и слэш-команды. Slack поддерживает несколько провайдеров, но Agan создал бота службы поддержки, используя сервис Glitch.

Этот шаг требует некоторого опыта кодирования. Аган создал новый проект Glitch, а затем начал добавлять код JavaScript с открытым исходным кодом. Если вы не хотите писать весь код самостоятельно (или заново изобретать колесо), то вы можете выбирать из бесчисленных каркасов и библиотек ботов, чтобы импортировать базовую логику бота.

Аган назвал свой проект «Index.js», добавил созданный им пакет TinySpeck, а затем вставил в код построителя сообщений, который мы написали ранее. Теперь, когда основной код бота уже установлен, он просто добавил команду обратного вызова, чтобы вызвать новый тикет, и подтверждающее сообщение «Билет в службу поддержки создан». Вот и все. Если вы хотите добавить свой код Webhooks для запуска уведомления в указанном канале, вы можете вставить его и здесь. Glitch создает уникальный URL для вашего бот-сервера, поэтому скопируйте этот URL, как только вы добавите весь свой код, и мы перейдем к следующему шагу.



8 8. Включить интерактивные сообщения

Вы уже создали своего бота Helpdesk, поэтому теперь все, что вам нужно сделать, это вернуться в API. Вместо выбора «Создать новое приложение» просто нажмите «Управление приложениями» и выберите приложение «Служба поддержки». На странице «Основная информация» выберите «Интерактивные сообщения» в поле «Добавить функции и функции». На этой странице нажмите «Включить интерактивные сообщения», вставьте URL-адрес вашего сервера с предыдущего шага и сохраните изменения.



9 9. Создайте команду косой черты

Как только это будет сделано, вернитесь в поле Add Features and Functionality и перейдите в Slash Commands. Нажмите «Создать новую команду». Вы попадете на страницу формы с несколькими полями.

В поле «Command» введите команду слеша. В этом случае Аган набрал «/ helpdesk». В поле URL-адрес запроса он вставил тот же URL-адрес сервера из Glitch. Затем все, что вам нужно сделать, это ввести краткое описание команды («Создать заявку в службу поддержки»), подсказку об использовании того, как пользователь должен набрать свой запрос, проверить предварительный просмотр под ним, чтобы убедиться, что все выглядит правильно, и затем нажать «Сохранить».,



10 10. Установите ваше приложение

Бот Helpdesk теперь готов к работе. Вернувшись на главную страницу API для вашего приложения, перейдите на страницу Install App, которую можно найти в меню настроек слева. Нажмите «Установить приложение в вашу команду». Это предложит вам авторизовать приложение. Как только вы это сделаете, ваш бот жив. Вы увидите зеленый "Успех!" Лента уведомлений на вашем экране, которая подтверждает, что ваш бот установлен.



11 11. Возьми своего бота на спин

Вернувшись в Slack-клиент вашей команды, перейдите на канал, на котором вы определили запуск своего нового бота. Введите команду слеша с запросом, например: «/ helpdesk у меня сломан Wi-Fi». Затем вам будет предложено нажать кнопку для создания заявки в службу поддержки. Поздравляем; Вы только что построили работающий бот Slack!