통합

Slack 알림

@-멘션이나 작업 배정을 받으면 Slack DM이 오고, MadiPlan 공유 링크가 Slack에 올라오면 인라인 미리보기가 보입니다. 설정은 두 단계 — 워크스페이스에서 한 번, 멤버 본인이 한 번.

@멘션 / 배정Madi에서Slack 연결?예 → Slack DM아니요 → 인앱만madiplan.app/share/example-token출시 · 작업 12개 · 활성 공유 링크의 미리보기
멘션·배정은 그 사람이 자기 계정을 연결한 경우에만 Slack DM; Madi 링크는 미리보기로 펼쳐집니다.

무엇을 받게 되나요

  • 코멘트·설명·진행 메모에서 @-멘션될 때 DM. DM에서 바로 해당 작업으로 이동할 수 있습니다.
  • 작업을 배정받으면 DM. 누가 배정했는지 DM에 함께 표시됩니다.
  • Slack 채널에 MadiPlan 공유 링크(madiplan.app/share/…)를 붙여넣으면 미리보기. 프로젝트 이름, 설명, 작업·멤버 수가 표시됩니다.
  • Slack DM은 인앱 알림과 함께 작동합니다 — 추가 채널일 뿐 대체가 아닙니다. Slack이 잠시 안 되더라도 인앱 알림은 변함없이 정상입니다.
  • 팀원 부재 채널 공지(선택): 워크스페이스 소유자가 공지 채널을 설정하면 휴가·출장 항목이 그 채널에 자동으로 올라가고, 항목이 바뀌면 그 자리에서 수정·삭제됩니다. 부재 일정 가이드를 참고하세요.

1단계: 워크스페이스 연결 (소유자)

/workspace → 설정에서 Slack 카드의 Connect 버튼을 누르면 Slack의 표준 'Allow' 화면을 거쳐 돌아옵니다. 연결은 워크스페이스 단위로 저장되므로, Slack 워크스페이스마다 한 번만 하면 됩니다.

  • 요청하는 권한: DM 발송 (chat:write, im:write), 워크스페이스 멤버 이메일 읽기 (users:read, users:read.email — Slack 계정과 MadiPlan 계정을 매칭하기 위함), 링크 미리보기 (links:read, links:write).
  • 봇은 메시지 기록을 읽지 않습니다. 2단계에서 본인이 Slack 계정을 연결한 사람에게 DM을 보내고, 부재 공지 채널을 설정한 경우에 한해(부재 일정 참고) 그 채널에만 팀원 부재 알림을 올립니다. 그 외에는 채널에 아무것도 게시하지 않습니다.
  • 같은 카드에서 언제든 연결 해제 가능. 암호화된 봇 토큰을 즉시 삭제하고 DM 발송을 중단합니다. 개별 멤버의 연동은 유지되므로, 같은 Slack 팀에 다시 연결하면 멤버들이 재연동할 필요가 없습니다.

2단계: 본인 계정 연동 (각 멤버)

워크스페이스가 연결되면 두 번째 Slack 카드가 모든 멤버에게 표시됩니다. 'Get DMs in Slack'을 누르면, MadiPlan 이메일을 연결된 Slack 워크스페이스의 사용자와 매칭해, 일치하면 두 계정을 연동합니다. 이후 멘션과 배정이 DM으로 옵니다.

  • Slack 이메일이 다르면? 카드에서 'Use a different Slack email'을 펼치고 Slack에 등록된 주소를 입력하세요 — MadiPlan과 다른 이메일을 Slack에 쓰는 분이 많습니다. 입력한 값은 저장되어 다음 재연결 때 자동 채워집니다.
  • 매칭 실패 시 우리가 조회한 주소가 화면에 표시되므로 오타를 바로 잡을 수 있습니다. Slack은 정확한 이메일로만 매칭하며, 부분/대소문자 무시 매칭은 없습니다.
  • 언제든 연결 해제 가능 — 멤버 카드에 연동된 Slack ID와 Disconnect 버튼이 보입니다. 워크스페이스 소유자의 Slack 연결과는 독립적이며, 본인 연동을 해제해도 다른 멤버에게는 영향 없습니다.

URL 미리보기

봇이 설치된 Slack 채널에 공유 링크(madiplan.app/share/<token>)를 붙여넣으면, 맨 URL이 작은 카드로 바뀝니다 — 프로젝트 이름, 한 줄 설명, 워크스페이스 이름, 작업·멤버 수.

/projects/<slug> URL은 의도적으로 미리보기하지 않습니다. 그 페이지는 MadiPlan 인증이 필요하고, Slack 채널의 다른 멤버는 해당 프로젝트에 접근 권한이 없을 수 있어, 미리보기를 보여주면 프로젝트 이름이 노출될 수 있기 때문입니다. 공유 링크는 URL 자체가 읽기 권한을 담고 있어 안전하게 렌더링할 수 있습니다.

문제 해결

  • 'Slack integration is not configured' — 이 환경에 Slack 자격 증명이 설정되지 않았습니다. 필요하면 지원팀에 문의하세요.
  • 'Your MadiPlan email isn't in this workspace's Slack' — 두 시스템의 이메일이 다릅니다. 어느 쪽이든 변경 가능하며, 일치시킨 뒤 Connect를 다시 누르세요.
  • 연결 후 DM이 안 오면 — 멤버 카드에 'Connected as @<본인 Slack ID>'가 보이는지 확인하세요. 그렇다면 작업에서 본인에게 @-멘션을 보내 테스트하세요. DM은 MadiPlan 봇 DM에 도착합니다 (OAuth 완료 메시지가 왔던 동일한 채널).
  • URL 미리보기가 안 나오면 — /share/<token> URL만 미리보기됩니다. 프로젝트의 Share 메뉴에서 공유가 켜져 있는지 확인하세요. 꺼져 있으면 링크 자체가 작동하지 않습니다.

요약

  • 소유자 단계 — /workspace → 설정 → Slack → Connect.
  • 멤버 단계 — 같은 페이지, 두 번째 Slack 카드, 'Get DMs in Slack'.
  • 이메일 매칭 — MadiPlan 이메일과 Slack 이메일이 일치해야 합니다.
  • 개인정보 — DM, 그리고 선택적 부재 공지 채널. 메시지 기록은 읽지 않습니다.