Slack 연동 가이드

인공지능 에이전트가 Slack 내에서 직접 활동합니다. 연동이 끝나면 에이전트가 메시지 흐름을 모니터링하고, 봇 언급 멘션에 답장하며, 유저들이 대화방을 벗어나지 않고도 문의 지식을 토대로 티켓을 자동 처리해 줍니다.

Slack API 설정 사이트에서 진행해야 할 절차는 다음과 같습니다.

Slack 앱 생성

1. api.slack.com/apps 사이트에 접속한 후 Create New App(새 앱 만들기) 버튼을 클릭합니다.

2. From a manifest(매니페스트에서 생성) 옵션을 선택합니다. 복잡한 마우스 클릭 작업 대신 아래 JSON 설정 코드를 활용해 모든 권한 및 환경을 한 번에 세팅할 수 있습니다.

3. 아래 JSON 매니페스트 코드를 입력 칸에 붙여넣으세요:

   {
     "display_information": {
       "name": "Your App Name (e.g. Acme Support)"
     },
     "features": {
       "app_home": {
         "home_tab_enabled": false,
         "messages_tab_enabled": true,
         "messages_tab_read_only_enabled": false
       },
       "bot_user": {
         "display_name": "support-bot",
         "always_online": true
       }
     },
     "oauth_config": {
       "scopes": {
         "bot": [
           "app_mentions:read",
           "chat:write",
           "im:history",
           "im:read",
           "im:write",
           "channels:history",
           "channels:read",
           "groups:history",
           "mpim:history"
         ]
       }
     },
     "settings": {
       "event_subscriptions": {
         "request_url": "https://yco4b94kgxnz.shares.zrok.io/api/integrations/slack/webhook",
         "bot_events": [
           "app_mention",
           "message.im"
         ]
       },
       "org_deploy_enabled": false,
       "socket_mode_enabled": false,
       "token_rotation_enabled": false
     }
   }

4. Next를 누르고, 이어서 Create를 클릭하여 앱 생성을 마칩니다.

워크스페이스에 앱 설치하기

1. 생성한 앱 대시보드로 이동한 후, 왼쪽 메뉴의 Install App(앱 설치) 페이지로 들어갑니다.

2. Install to Workspace 버튼을 클릭해 연동 권한 승인 내역을 검토한 후, 최종 승인(Approve)해 설치를 완료합니다.

고유 키 값 복사하기

Vela 연동 설정을 완료하려면 Slack 대시보드 화면에서 다음 두 키 값을 복사해 두어야 합니다.

Bot User OAuth Token Install App 페이지에서 xoxb-로 시작하는 토큰 문자열 값을 복사합니다.

Signing Secret Basic Information(기본 정보) 페이지로 이동합니다. 화면을 하단으로 내려 App Credentials 영역에 있는 Signing Secret(서명 시크릿 키) 값을 복사합니다.

Vela에서 연동 마무리하기

Vela 대시보드를 열어 Slack 연동 페이지로 이동한 후, 복사해 둔 두 키 값을 해당하는 입력 칸에 붙여넣습니다. 이제 AI 에이전트가 Slack 워크스페이스에 정상 가동을 시작합니다.