Slack Trigger 노드 문서
Slack Trigger 노드를 사용하면 Slack의 이벤트에 반응하고 Slack을 다른 애플리케이션과 통합할 수 있습니다. 이 페이지에서는 Slack Trigger 노드가 반응할 수 있는 이벤트 목록과 추가 리소스 링크를 확인할 수 있습니다.
Slack Trigger 노드를 사용하면 Slack의 이벤트에 반응하고 Slack을 다른 애플리케이션과 통합할 수 있습니다. n8n은 새 메시지, 반응, 새 채널 등 다양한 Slack 이벤트를 기본으로 지원합니다.
이 페이지에서는 Slack Trigger 노드가 반응할 수 있는 이벤트 목록과 추가 리소스 링크를 확인할 수 있습니다.
이 노드의 인증 정보는 여기에서 확인할 수 있습니다.
시작에 도움이 되는 사용 예제와 템플릿은 n8n의 Slack 통합 페이지를 참조하세요.
이벤트#
- Any Event: Slack의 모든 이벤트에서 노드가 트리거됩니다.
- App Home Opened: 사용자가 Slack 앱의 App Home{:target="_blank" .external-link} 탭을 열 때 노드가 트리거됩니다.
- Bot / App Mention: 앱이 속한 채널에서 봇 또는 앱이 멘션될 때 노드가 트리거됩니다.
- File Made Public: 파일이 공개로 설정될 때 노드가 트리거됩니다.
- File Shared: 앱이 속한 채널에서 파일이 공유될 때 노드가 트리거됩니다.
- New Message Posted to Channel: 앱이 속한 채널에 새 메시지가 게시될 때 노드가 트리거됩니다.
- New Public Channel Created: 새 공개 채널이 생성될 때 노드가 트리거됩니다.
- New User: Slack에 새 사용자가 추가될 때 노드가 트리거됩니다.
- Reaction Added: 앱이 추가된 메시지에 반응이 추가될 때 노드가 트리거됩니다.
파라미터#
트리거할 이벤트를 설정한 후, 나머지 파라미터를 사용하여 노드의 동작을 추가로 정의할 수 있습니다.
- Watch Whole Workspace: 노드가 워크스페이스의 모든 채널에서 선택한 이벤트를 감시할지(활성화) 여부(비활성화, 기본값)를 설정합니다.
이 옵션을 활성화하면 봇 또는 앱이 속한 모든 채널의 모든 이벤트에 대해 하나의 실행이 사용됩니다. 신중하게 사용하세요!
- Channel to Watch: 노드가 선택한 이벤트를 감시할 채널을 선택합니다. Watch Whole Workspace를 활성화하지 않은 경우에만 이 파라미터가 표시됩니다. 채널 선택 방법:
- From list: 노드가 자격 증명을 사용하여 워크스페이스의 채널 목록을 조회하므로 원하는 채널을 선택할 수 있습니다.
- By ID: 감시할 채널의 ID를 입력합니다. Slack은 채널 ID를 채널 상세 정보 하단에 원클릭 복사 버튼과 함께 표시합니다.
- By URL:
https://app.slack.com/client/<channel-address>형식으로 감시할 채널의 URL을 입력합니다.
- Download Files: 파일을 다운로드하여 노드 출력에 사용할지(활성화) 여부(비활성화, 기본값)를 설정합니다. File Made Public 및 File Shared 이벤트와 함께 사용합니다.
옵션#
Add Option을 통해 노드의 동작을 추가로 조정할 수 있습니다.
- Resolve IDs: ID를 해당 이름으로 확인하여 반환할지(활성화) 여부(비활성화, 기본값)를 설정합니다.
- Usernames or IDs to ignore: 이벤트를 무시할 사용자 이름을 선택하거나 인코딩된 사용자 ID를 쉼표로 구분하여 입력합니다. 목록에서 선택하거나 표현식을 사용하여 ID를 지정합니다.
관련 리소스#
n8n은 Slack용 앱 노드를 제공합니다. 노드 문서는 여기에서 확인할 수 있습니다.
n8n 웹사이트에서 예제 워크플로 및 관련 콘텐츠를 확인하세요.
API에 대한 자세한 내용은 Slack 공식 문서를 참조하세요.
필요한 스코프#
이 노드를 사용하려면 Slack에서 애플리케이션을 생성하고 이벤트 구독을 활성화해야 합니다. 자세한 내용은 Slack credentials | Slack Trigger 설정을 참조하세요.
이 트리거 노드가 작동하려면 Slack 앱에 적절한 스코프를 추가해야 합니다.
노드는 최소한 conversations.list와 users.list 메서드에 대한 스코프가 필요합니다. 더 완전한 스코프 목록은 Scopes | Slack credentials를 확인하세요.
웹훅 검증#
버전 1.106.0부터 Slack credentials를 설정할 때 Slack Signing Secret을 지정할 수 있습니다. 설정 시 Slack Trigger 노드가 요청이 Slack에서 온 것인지, 그리고 신뢰할 수 있는 서명을 포함하는지 자동으로 검증합니다. n8n은 Slack에서 전송된 요청만 처리하기 위해 이 설정을 권장합니다.
일반적인 문제#
다음은 Slack Trigger 노드에서 자주 발생하는 오류와 문제, 그리고 해결 또는 트러블슈팅 방법입니다.
워크플로가 테스트 또는 프로덕션 중 하나에서만 작동함#
Slack은 앱당 하나의 웹훅만 등록을 허용합니다. 즉, 등록된 웹훅 URL을 재설정하지 않고는 테스트 URL과 프로덕션 URL을 전환할 수 없습니다.
프로덕션에서도 활성화된 워크플로를 테스트하려고 할 때 이 문제가 발생할 수 있습니다. Slack은 두 웹훅 URL 중 하나에만 이벤트를 전송하므로 다른 하나는 이벤트 알림을 받지 못합니다.
이 문제를 해결하려면 테스트 시 워크플로를 비활성화할 수 있습니다.
이 방법은 테스트를 위해 프로덕션 워크플로를 일시적으로 비활성화합니다. 비활성화된 동안 워크플로는 프로덕션 트래픽을 받지 못합니다.
- 워크플로 페이지로 이동합니다.
- 상단 패널의 Active 스위치를 토글하여 워크플로를 일시적으로 비활성화합니다.
- Slack Trigger 설정에서 Request URL을 프로덕션 웹훅 URL 대신 테스트 웹훅 URL로 변경합니다.
- 테스트 웹훅 URL을 사용하여 워크플로를 테스트합니다.
- 테스트가 완료되면 Slack Trigger 설정에서 Request URL을 테스트 웹훅 URL 대신 프로덕션 웹훅 URL로 변경합니다.
- Inactive 토글을 토글하여 워크플로를 다시 활성화합니다. 프로덕션 웹훅 URL이 정상적으로 작동을 재개해야 합니다.
토큰 만료#
Slack은 봇 및 사용자 토큰에 활성화할 수 있는 토큰 순환 기능을 제공합니다. 이 기능을 활성화하면 모든 토큰이 12시간 후에 만료됩니다. 테스트 목적으로는 유용할 수 있지만, 이 기능이 활성화된 토큰을 사용하는 n8n 자격증명은 만료 후 실패하게 됩니다. Slack 자격증명을 프로덕션에서 사용하려면 이 기능이 꺼져 있어야 합니다.
Slack 앱에 토큰 순환이 활성화되어 있는지 확인하려면 Slack API 문서 | 토큰 순환을 참고하세요.
Slack 앱에서 토큰 순환을 사용하는 경우 다시 비활성화할 수 없습니다. 대신 토큰 순환이 비활성화된 새 Slack 앱을 생성해야 합니다.
