Добро пожаловать в первую часть серии Ускоренный курс по бэкенд-программированию для продакт-менеджеров, где мы шаг за шагом создадим приложение Slack.
В этой части вы:
- Создайте и настройте новое приложение в Slack
- Установите приложение в свою учетную запись Slack.
- Загрузите и установите Xcode (для пользователей Mac) и VSCode.
- Установить NodeJS
- Установите пакет npm Slack для отправки сообщений
- Используя токен приложения из Slack и свой идентификатор пользователя Slack, отправьте текстовое сообщение со своего компьютера в Slack, используя метод Slack chat.postMessage.
Перейдем в Slack и настроим новое приложение.
(10 шагов)
Мы создадим приложение и установим его в нашу рабочую область. Затем мы проверим нашу настройку с помощью инструментов документации Slack.
Примечание. Это только настройка приложения с точки зрения имени, разрешений и токенов. Мы создадим фактическую логику приложения на более поздних этапах.
- Перейдите на сайт Slack API и создайте новое приложение с нуля.
2. В разделе Добавить функции и возможности щелкните карточку Разрешения. Вы будете перенаправлены в разделы OAuth и разрешения.
3. В разделе Области нажмите Добавить область действия OAuth, чтобы добавить область действия chat:write — это область, которая нужна нашему приложению для отправлять сообщения
4. На вкладке Установить приложение нажмите кнопку «Установить в рабочую область», предоставьте разрешения и скопируйте токен бота.
Примечание. Если ваше приложение контролируется администратором, вы должны запросить его установку, нажав кнопку Запросить установку под Установить приложение вкладку p и дождитесь одобрения администратора (отправьте администратору Slack, чтобы ускорить процесс)
Дополнительное примечание: вы можете создать дополнительное рабочее пространство в Slack, чтобы полностью изолировать свой сторонний проект от работы. Просто зайдите на слабый веб-сайт и нажмите Создать новую рабочую область.
Если у вас есть адрес Gmail, вы можете использовать «+текст» в качестве суффикса, чтобы продолжать получать электронные письма на тот же почтовый ящик, но от другого пользователя.
Затем, когда вы создадите свое приложение, просто выберите новую рабочую область в раскрывающемся списке рабочей области на шаге 1.
5. Теперь давайте протестируем наше приложение вручную. В документации найдите метод сообщения сообщения и щелкните вкладку Тест.
6. Вставьте скопированный токен
7. Для поля «канал» нам понадобится идентификатор канала, на который мы хотим отправить наше приложение. Поскольку мы свели наши разрешения к минимуму, мы можем напрямую вставлять в канал приложения.
Согласно документации Slack, если мы укажем идентификатор участника в поле канала, он отправит сообщение на канал приложения. Давайте скопируем наш идентификатор участника:
8. Теперь давайте вставим идентификатор участника в поле канала нашего теста:
9. Добавьте текст сообщения и нажмите «Метод проверки».
10. Если все прошло хорошо, в правой части вы должны получить результат, подобный этому:
Вкратце:
Мы создали и установили приложение Slack, у которого есть разрешение и учетные данные для отправки сообщений в канал приложения в slack.
Теперь давайте попробуем протестировать метод публикации сообщения прямо с нашего локального компьютера.
Нам нужно настроить нашу среду кода, а затем протестировать метод публикации сообщений Slack.
Настройка среды кода
(4 шага)
- Для пользователей Mac нам нужно будет загрузить и установить Xcode от Apple — он понадобится нам для инструмента командной строки (пользователи Windows могут пропустить этот шаг). Имейте в виду, что это 11 ГБ загрузки, так что это может стать отличной возможностью для перерыва на кофе ☕️. После установки ничего настраивать для Xcode не нужно, можно просто закрыть окно. Примечание. Пользователи MAC, не пропустите этот шаг, вы должны выполнить его, прежде чем переходить к следующим шагам.
- Скачайте и установите VScode — это будет наш локальный редактор кода
3. Давайте настроим папку нашего проекта, чтобы хранить файлы проекта в
4. Загрузите и установите Node.js (используйте загрузку установщика для самой простой установки). По сути, это кодовая платформа для разработки на основе javascript — относительно интуитивно понятная и довольно популярная.
До сих пор мы просто настраивали нашу среду, теперь давайте начнем программировать, создав простейшее приложение NodeJS, которое будет отправлять сообщение в Slack
(7 шагов)
Это идеальное время, чтобы сделать еще один глубокий вдох 🤓
1. Запустите npm в своей рабочей папке, открыв терминал в VSCode и набрав npm init. npm — это менеджер пакетов для языка программирования JavaScript, который поможет нам загрузить пакет для взаимодействия в режиме Slack.
Примечание. Первое слово для команд терминала — это приложение, а после него идут команды, относящиеся к этому приложению, вместе с параметрами (если применимо). Так что в этом случае программа npm, а команда init (для инициализации службы)
2. Вам будет задано несколько вопросов, если вы не слишком придирчивы, вы можете нажать кнопку возврата для всех вопросов.
3. Установите пакет npm @slack/web-api в свой проект приложения, введя npm install @slack/web-api, а затем нажав return ключ
Примечание. В вашу папку были добавлены некоторые файлы конфигурации.
4. Создайте файл javascript с именем app.js в своей папке через VSCode.
5. Вставьте следующий код в файл app.js:
// Require the Node Slack SDK package (github.com/slackapi/node-slack-sdk) const { WebClient, LogLevel } = require("@slack/web-api"); // WebClient insantiates a client that can call API methods const client = new WebClient("YOUR-
Bot-User-OAuth-Token");
// ID of the channel you want to send the message to const channelId = "YOUR-MEMBER-ID";
(async () => {try { // Call the chat.postMessage method using the WebClient const result = await client.chat.postMessage({ channel: channelId, text: "Hello world from my computer" }); console.log(result); } catch (error) { console.error(error); }
})();
Примечание. Строки, начинающиеся с //, являются строками комментариев в коде и не выполняются.
Замените токен и канал своими данными
6. Сохраните файл app.js.
7. Теперь давайте запустим наш файл app.js с помощью следующей команды в терминале: node app.js (нажмите клавишу возврата для выполнения)
Если все пойдет хорошо, вы получите результат в терминале, подобный этому:
Ура! Вы только что программно отправили сообщение в Slack 🎉
В следующей части вы:
- Настроить контроль версий Git
- Откройте проект GitHub и синхронизируйте с ним свой проект.
- Настройте воркер на сервере Heroku
- Свяжите Heroku для синхронизации с учетной записью GitHub