Slack
Anyy는 Socket Mode로 Slack에 연결합니다. 작동하는 계정에는 Web API/메시지 작업용 봇 토큰과 WebSocket 연결용 앱 토큰이 모두 필요합니다.
1. Slack 앱 준비
Slack 앱 구성에서 다음을 수행합니다.
- 대상 워크스페이스용 앱을 만듭니다.
- Socket Mode를 활성화합니다.
- Socket Mode 범위를 가진 앱 수준 토큰을 만듭니다.
- 선택한 대화 읽기, 메시지 게시, 지원 파일 가져오기에 필요한 봇 범위를 추가합니다.
- 다이렉트 메시지와 멘션된 그룹 대화에 필요한 메시지 이벤트 구독을 활성화합니다.
- 범위를 바꾸면 워크스페이스에 앱을 설치하거나 다시 설치합니다.
Dashboard에는 Socket Mode, 이벤트 구독, 앱 토큰 범위, 봇 토큰 범위의 외부 사전 요건이 표시됩니다. 계정을 활성화하기 전에 충족하세요.
2. Anyy에 연결
Dashboard → Channel → Add → Slack을 열어 기본 Socket Mode 항목을 사용합니다. 다음을 입력합니다.
- 봇 토큰(
xoxb-…). - 앱 토큰(
xapp-…). - Anyy 계정 ID.
다이렉트 메시지/그룹 정책은 CLI 마법사에서 설정합니다. Dashboard 자격 증명 양식에는 해당 입력이 없습니다.
CLI 설정:
anyy setup channel
계정을 활성화하려면 두 토큰이 모두 필요하며 프로필 비밀정보 참조로 저장됩니다.
3. 정책 선택
Slack의 기본값은 DM pairing, 그룹 mention입니다. DM 정책은 open, allowlist, pairing, disabled, 그룹 정책은 mention, open, allowlist, disabled를 지원합니다.
CLI 마법사에서 Slack을 선택해 정책을 바꿉니다. 기존 허용 목록은 Slack 사용자/채널 ID를 사용하지만 현재 설정 작업은 목록 항목 편집을 제공하지 않습니다. 새 계정에는 페어링을 우선 사용하세요. 공통 접근 제한을 참조하세요.
4. 다시 로드 및 테스트
anyy channel reload
anyy channel doctor slack
앱에 DM을 보내거나 허용된 채널에서 멘션하세요. DM 페어링이 활성화되어 있으면 대기 요청을 승인합니다.
anyy channel pairing list --channel slack
anyy channel pairing approve --request REQUEST_ID
스레드와 파일
Anyy는 채널 경로에 Slack 스레드 타임스탬프를 보존하고 원래 스레드 안에 응답합니다. 지원되는 수신 파일은 봇 자격 증명으로 다운로드한 뒤 크기 검사 후 범위가 지정된 첨부 파일로 준비됩니다.
Socket Mode에는 공개 수신 웹훅 URL이 필요 없지만 Gateway에는 Slack으로 향하는 외부 네트워크 접근이 필요합니다.
Slack 토큰 범위는 설치된 앱의 권한 부여로 고정됩니다. 앱 구성만 바꾸면 앱을 다시 설치하기 전까지 현재 봇 토큰이 업데이트되지 않을 수 있습니다.
문제 해결
| 증상 | 확인 사항 |
|---|---|
| 소켓 연결 불가 | Socket Mode, xapp- 토큰과 범위, 외부 네트워크 접근 확인 |
| 인증은 되지만 메시지가 오지 않음 | 이벤트 구독, 봇 범위, 앱 설치, 채널 참여 검토 |
| 게시 실패 | 대상 대화의 xoxb- 토큰과 쓰기 범위 확인 |
| DM이 보류됨 | 페어링을 승인한 뒤 새 메시지 전송 |
| 파일을 읽을 수 없음 | 파일 범위, 비공개 다운로드 접근, 어댑터 미디어 한도 확인 |
일반적인 접근 권한 관리는 메시징 플랫폼을 참조하세요.