Добро пожаловать в первую часть серии Ускоренный курс по бэкенд-программированию для продакт-менеджеров, где мы шаг за шагом создадим приложение Slack.

В этой части вы:

  1. Создайте и настройте новое приложение в Slack
  2. Установите приложение в свою учетную запись Slack.
  3. Загрузите и установите Xcode (для пользователей Mac) и VSCode.
  4. Установить NodeJS
  5. Установите пакет npm Slack для отправки сообщений
  6. Используя токен приложения из Slack и свой идентификатор пользователя Slack, отправьте текстовое сообщение со своего компьютера в Slack, используя метод Slack chat.postMessage.

Перейдем в Slack и настроим новое приложение.

(10 шагов)

Мы создадим приложение и установим его в нашу рабочую область. Затем мы проверим нашу настройку с помощью инструментов документации Slack.

Примечание. Это только настройка приложения с точки зрения имени, разрешений и токенов. Мы создадим фактическую логику приложения на более поздних этапах.

  1. Перейдите на сайт 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 шага)

  1. Для пользователей Mac нам нужно будет загрузить и установить Xcode от Apple — он понадобится нам для инструмента командной строки (пользователи Windows могут пропустить этот шаг). Имейте в виду, что это 11 ГБ загрузки, так что это может стать отличной возможностью для перерыва на кофе ☕️. После установки ничего настраивать для Xcode не нужно, можно просто закрыть окно. Примечание. Пользователи MAC, не пропустите этот шаг, вы должны выполнить его, прежде чем переходить к следующим шагам.
  2. Скачайте и установите 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 🎉

В следующей части вы:

  1. Настроить контроль версий Git
  2. Откройте проект GitHub и синхронизируйте с ним свой проект.
  3. Настройте воркер на сервере Heroku
  4. Свяжите Heroku для синхронизации с учетной записью GitHub

Перейдем к части 2››