Slack DM 개인 알림 사용하기

Overview

이 문서에서는 Slack Direct Messages(DM)을 통해 Workflow 요청자/승인자/실행자에게 단계별 알림을 발송하도록 설정하는 방법 및 알림 유형을 안내합니다.

사전 준비 사항

QueryPie에서의 설정을 진행하기 이전에 다음의 사전 준비가 필요합니다.

• Slack App 생성 : Slack App이 준비되어 있어야 합니다. 앱 생성을 위해서는 QueryPie Customer Portal에 문의글을 작성해주시거나, 공식 파트너사를 통해 문의해주세요.

• 이메일 주소 일치 : QueryPie에 등록된 이메일 주소와 Slack에 등록된 이메일 주소가 동일해야 합니다.

  • 이메일 주소가 상이할 경우 정상적으로 DM 수신이 되지 않습니다.

• 네트워크 설정 : QueryPie에서 발송하는 알림을 Slack에서 수신할 수 있도록, 필요 시 네트워크 설정을 진행해주세요.

참고

QueryPie가 내부망에 설치되어 있어 ACL 설정이 어려운 경우 Proxy 서버 세팅이 필요할 수 있습니다. Okta 서비스를 이용하고 있다면 [내부망] Slack DM Workflow 결재 처리 결과 전달하기 문서를 참고하여 설정할 수 있습니다.

Slack DM 설정하기

Slack DM 개인 알림을 사용하려면, Workflow Configuration에서 관련 설정을 활성화해야 합니다.

Slack DM 알림 전송

Workflow Notifications via Slack Direct Message 토글로 활성화합니다.

• 승인자로 지정된 사용자에게 Slack DM으로 알림을 전송할지 결정합니다.

• 토글을 켜면 Bot User OAuth Token 필드가 나타납니다. 연동하고자 하는 Slack App의 Bot User OAuth Token을 입력 후 저장합니다.

• 토글을 끄면 필드가 가려집니다. (저장 이전에 다시 켜면 기존 입력된 내용이 유지됩니다.)

Slack App의 Bot User OAuth Token은 앱 관리 메뉴 중 ‘OAuth & Permissions’에서 확인할 수 있습니다.

Slack에서 요청 승인/거절 활성화

Allow users to Approve or Reject on Slack 토글로 활성화합니다.

• 토글을 켜면 수신되는 Slack DM에 Reject Approve 버튼이 추가됩니다.

  • 사유 입력 후 버튼을 누르면 손쉽게 요청을 처리할 수 있습니다.

Slack DM 알림의 종류

일반적인 사전 승인 상태의 Workflow를 기준으로, 진행 상태에 따라 네 종류의 알림이 발송됩니다.

1. 승인 요청 알림

2. 반려 알림

3. 승인 완료 알림 - 요청자에게

4. 실행 가능 알림

사후 승인 (Urgent Mode)의 경우에는 아래와 같이 네 종류이 알림이 발송됩니다.

1. 승인 요청 알림

2. 실행 가능 알림

3. 승인 완료 알림 - 요청자에게

4. Urgent Mode 미승인 알림

승인 요청 알림

Workflow의 다섯가지 타입(SQL Request, SQL Export Request, DB Access Request, Server Access Request, Access Role Request) 모두를 지원합니다.

기안 작성 즉시 1단계 승인자에게 알림이 발송됩니다. 1단계 승인이 완료된 경우에는 2단계 승인자에게 알림이 발송됩니다. 마찬가지로 2단계 승인이 완료된 경우 3단계 승인자에게 알림이 발송됩니다.

각 단계의 승인자가 여러 명인 경우에는 해당 승인자 모두에게 메시지가 발송됩니다. 이때 승인자 중 대리결재를 설정한 사용자가 있다면, 해당 대리결재자에게도 메시지가 발송됩니다. 대리결재 관련 자세한 설정 방법은 요청 부가 기능 내 대리결재 사용하기 문서를 참고해주시기 바랍니다.

QueryPie 관리자의 사전 설정에 따라, 메시지를 받은 승인자는 Slack에서 승인/반려를 할 수도 있습니다. 필요한 설정은 상단의 ‘Slack DM 설정하기’를 확인해주세요. 액션 버튼이 없을지라도 Details 버튼은 항상 포함됩니다. 해당 버튼 클릭시, 웹브라우저가 실행되어 QueryPie 로그인 창이 나타납니다. 로그인 성공시 Workflow 디테일페이지로 이동합니다.

사후승인 (Urgent Mode) 기안인 경우에는 아래와 같이 해당 사실이 메시지에 함께 안내됩니다. 사후승인 요청 건이므로, 액션 버튼을 사용 중이더라도 Approve 버튼만 나타납니다.

반려 알림

Workflow의 네 가지 타입(SQL Request, SQL Export Request, DB Access Request, Server Access Request) 모두를 지원합니다. 어느 단계에서든 해당 기안을 승인자가 반려한 경우, 요청자에게 즉시 메시지가 발송됩니다. 메시지 내에는 반려 사유 코멘트가 함께 전달됩니다.

별도의 액션 버튼은 포함되지 않으며, Details 버튼이 포함됩니다. 해당 버튼 클릭시, 웹브라우저가 실행되어 QueryPie 로그인 창이 나타납니다. 로그인 성공시 Workflow 디테일페이지로 이동합니다.

사후승인 (Urgent Mode) 기안인 경우에는 반려 케이스가 존재하지 않습니다. 따라서 반려 메시지도 존재하지 않습니다.

승인 완료 알림 - 요청자에게

Workflow의 네 가지 타입(SQL Request, SQL Export Request, DB Access Request, Server Access Request) 모두를 지원합니다. 승인이 최종적으로 완료된 시점에 요청자에게 메시지가 발송됩니다.

별도의 액션 버튼은 포함되지 않으며, Details 버튼이 포함됩니다. 해당 버튼 클릭시, 웹브라우저가 실행되어 QueryPie 로그인 창이 나타납니다. 로그인 성공시 Workflow 디테일페이지로 이동합니다.

사후승인 (Urgent Mode) 기안인 경우에도 모든 사후승인이 완료되고 나면 요청자에게 해당 메시지가 발송됩니다.

실행 가능 알림

Workflow에서 Execute 행동을 포함하하는 두 가지 타입 (SQL Request, SQL Export Request)을 지원합니다.

승인이 최종적으로 완료된 시점에 실행자에게 메시지가 발송됩니다.

별도의 액션 버튼은 포함되지 않으며, Details 버튼이 포함됩니다. 해당 버튼 클릭시, 웹브라우저가 실행되어 QueryPie 로그인 창이 나타납니다. 로그인 성공시 Workflow 디테일페이지로 이동합니다. 해당 페이지에서 SQL Request 및 SQL Export Request를 실행할 수 있습니다.

사후승인 (Urgent Mode) 기안인 경우에는 기안 상신 즉시 실행자에게 메시지가 발송됩니다.

Urgent Mode 미승인 알림

Workflow에서 두 가지 타입 (SQL Request, SQL Export Request)을 지원합니다.

Urgent Mode로 상신된 기안이 하루 이상 미승인 상태인 것을 알려주는 메시지입니다. 하루 이상을 경과한 모든 기안 건에 대해 해당 단계의 승인자에게 매일 아침 1회 발송됩니다.

각 단계의 승인자가 여러 명인 경우에는 해당 승인자 모두에게 메시지가 발송됩니다. 이때 승인자 중 대리결재를 설정한 사용자가 있다면, 해당 대리결재자에게도 메시지가 발송됩니다. 대리결재 관련 자세한 설정 방법은 요청 부가 기능 내 대리결재 사용하기 문서를 참고해주시기 바랍니다.

미승인 기안 1건마다 메시지가 1건이므로, 미승인 기안이 여러 건이라면 메시지도 여러 건 발송됩니다. 발송 시각은 매일 아침 10시이며, 업무일과 휴일을 구분하지 않습니다.