Slack에 봇 커넥트

적용 대상: SDK v4

Slack 앱을 통해 사용자와 통신하도록 봇을 구성할 수 있습니다. 이 문서에서는 Slack을 사용하여 Slack 앱을 만들고, Azure에서 Slack 앱에 봇을 연결하고, Slack에서 봇을 테스트하는 방법을 설명합니다.

이 문서에서는 Azure Portal에서 봇에 Slack 채널을 추가하는 방법을 보여 줍니다. 사용자 지정 채널 어댑터를 사용하는 방법에 대한 자세한 내용은 추가 정보를 참조하세요.

필수 구성 요소

  • Azure 구독 아직 구독 계정이 없는 경우 시작하기 전에 체험 계정을 만듭니다.
  • Slack에 연결하려는 Azure에 게시된 봇입니다.
  • https://api.slack.com/apps에서 애플리케이션을 만들고 관리하는 데 충분한 권한이 있는 Slack 작업 영역에 액세스합니다. Slack 환경에 액세스할 수 없는 경우 작업 영역을 만들 수 있습니다.

Slack에서 앱 만들기

먼저 Azure에서 봇에 대한 Slack 채널을 구성하는 데 필요한 정보를 생성하는 애플리케이션을 Slack에 만듭니다.

  1. 패널로 이동하여 Slack 계정에 로그인합니다.
  2. 새 앱 만들기를 선택하거나 첫 번째 애플리케이션인 경우 앱 만들기를 선택합니다.
    1. 만들기 페이지에서 처음부터 선택합니다.
    2. 이름 앱 & 작업 영역 선택 페이지에서 앱 이름Slack 애플리케이션의 이름을 입력합니다.
    3. 앱을 개발할 작업 영역을 선택하려면 앱의 작업 영역을 선택합니다.
    4. Slack API 서비스 약관을 검토하고 동의합니다.
    5. 앱 만들기를 선택합니다.

새 리디렉션 URL 추가

앱이 만들어지면 앱에 리디렉션 URL을 추가합니다.

  1. OAuth 및 사용 권한을 선택합니다.

  2. 결과 창의 리디렉션 URL 아래에서 새 리디렉션 URL 추가를 선택합니다.

  3. 입력 상자에 다음 리디렉션 URL 중 하나를 입력하고 추가를 선택합니다.

    • 전역 봇의 경우 .를 입력합니다 https://slack.botframework.com.
    • 지역 봇의 경우 선택한 지역에 따라 다음 URL을 입력합니다.
    지역 리디렉션 URL
    유럽 https://europe.slack.botframework.com
    인도 https://india.slack.botframework.com
  4. URL 저장을 선택합니다.

봇 이벤트 구독

리디렉션 URL을 추가한 후 봇 이벤트에 앱을 구독하여 Slack이 지정한 URL에서 사용자 활동을 봇에 알립니다. Slack에서 봇이 사용할 기능을 기반으로 이벤트를 구독합니다.

  1. 이벤트 구독을 선택합니다.

  2. 결과 창에서 이벤트 사용 설정을 켜기로 전환합니다.

  3. 요청 URL의 경우 다음 요청 URL 중 하나를 입력합니다. 여기서 {bot-name} 는 중괄호 없이 Azure Bot 리소스의 표시 이름입니다.

    • 전역 봇의 경우 .를 입력합니다 https://slack.botframework.com/api/Events/{bot-name}.
    • 지역 봇의 경우 선택한 지역에 따라 다음 URL을 입력합니다.
    지역 요청 URL
    유럽 https://europe.slack.botframework.com/api/Events/{bot-name}
    인도 https://india.slack.botframework.com/api/Events/{bot-name}
  4. 봇 이벤트 구독에서 봇 사용자 이벤트 추가를 선택한 다음, 이벤트를 구독합니다. 예시:

    • member_joined_channel
    • member_left_channel
    • message.channels
    • message.groups
    • message.im
    • message.mpim
  5. 변경 내용 저장을 선택합니다.

사용자가 봇에 메시지를 보낼 수 있도록 설정

봇 이벤트를 구독한 후 사용자가 봇에 메시지를 표시할 수 있도록 합니다.

  1. 앱 홈을 선택합니다.
  2. 결과 창의 메시지 탭 아래 표시 섹션에서 사용자가 메시지 탭에서 슬래시 명령과 메시지를 보낼 수 있도록 허용합니다.

대화형 메시지 추가 및 구성

필요에 따라 대화형 메시지를 사용하도록 설정합니다.

  1. 대화형 작업 및 바로 가기를 선택합니다.

  2. 요청 URL의 경우:

    • 전역 봇의 경우 .를 입력합니다 https://slack.botframework.com/api/Actions.
    • 지역 봇의 경우 선택한 지역에 따라 다음 URL을 입력합니다.
    지역 요청 URL
    유럽 https://europe.slack.botframework.com/Actions
    인도 https://india.slack.botframework.com/Actions
  3. 변경 사항 저장을 선택합니다.

앱 정보 복사

Slack 채널을 봇에 추가하려면 다음 정보가 필요합니다. 항상 안전한 장소에 앱 자격 증명을 복사하고 저장합니다.

  1. 기본 정보를 선택합니다.
  2. 결과 창의 앱 자격 증명 아래에서 클라이언트 ID, 클라이언트 암호 및 서명 비밀을습니다.
  3. 이제 OAuth 및 권한을 선택합니다.
  4. 결과 창에서 범위 섹션을 찾습니다 . 앱의 봇 토큰 범위를 기록합니다 .

Azure에서 봇 구성

이 단계를 완료하려면 이전 단계의 Slack 애플리케이션 자격 증명이 필요합니다.

  1. Azure Portal을 엽니다.

  2. 봇에 대한 Azure Bot 리소스 블레이드를 엽니다.

  3. 채널을 열고 Slack 선택합니다.

  4. Slack 채널 구성에서 이전 단계에서 복사한 정보를 입력합니다.

    1. Slack에서 만든 애플리케이션에 필요한 Slack 자격 증명을 입력합니다.
    2. 필요에 따라 Slack 사용자가 봇을 추가한 후 리디렉션되는 방문 페이지 URL 을 제공합니다.
    3. OAuth 및 권한 리디렉션 URL 및 이벤트 구독 요청 URL 값은 리디렉션 URL을 추가하고 봇 이벤트를 구독하기 위해 Slack에 입력한 값과 일치해야 합니다.

    submit credentials

  5. 적용을 선택합니다.

  6. Slack 앱 설치를 완료하기 위해 Slack으로 리디렉션됩니다.

    • 요청된 사용 권한이 올바르면 [허용]을 선택합니다.

이제 Slack에서 사용자와 통신하도록 봇이 구성되었습니다. 이제 작업 영역의 사용자가 Slack 앱을 통해 봇과 상호 작용할 수 있습니다.

Slack에서 애플리케이션 테스트

  1. 앱을 설치한 Slack 작업 영역에 로그인합니다.
  2. 에서 앱을 선택합니다.
  3. 결과 창에서 애플리케이션에 메시지를 보냅니다.

추가 정보

참고 항목

2020년 6월 현재 Slack 채널은 Slack V2 권한 범위를 지원하며, 이를 통해 봇은 보다 세분화된 방식으로 해당 기능 및 사용 권한을 지정할 수 있습니다. 새로 구성된 모든 Slack 채널은 V2 범위를 사용합니다. 봇을 V2 범위로 전환하려면 Azure Portal 채널 블레이드에서 Slack 채널 구성을 삭제하고 다시 만듭니다 .

봇에 대한 Slack 지원에 대한 자세한 내용은 Slack API 설명서를 참조하세요.

Slack 어댑터를 사용하여 Slack에 봇 커넥트

Azure AI Bot Service에서 봇을 Slack 과 연결하는 데 사용할 수 있는 채널뿐만 아니라 Bot Builder 커뮤니티 리포지토리는 Slack에 대한 사용자 지정 채널 어댑터를 정의합니다.

  • C# 어댑터에 대한 자세한 내용은 .NET 커뮤니티 리포지토리의 어댑터 섹션을 참조하세요.
  • JavaScript 어댑터에 대한 자세한 내용은 JavaScript 커뮤니티 리포지토리의 어댑터 섹션을 참조하세요.