Slack Trigger 노드 문서
n8n v2.29Slack Trigger 노드를 사용하여 Slack의 이벤트에 응답하고 Slack을 다른 애플리케이션과 통합하세요. 이 페이지에서는 Slack Trigger 노드가 응답할 수 있는 이벤트 목록과 추가 자료 링크를 확인할 수 있습니다.
Slack Trigger 노드를 사용하여 Slack의 이벤트에 응답하고 Slack을 다른 애플리케이션과 통합하세요. n8n은 새 메시지, 반응, 새 채널을 비롯한 다양한 Slack 이벤트를 기본으로 지원합니다.
이 페이지에서는 Slack Trigger 노드가 응답할 수 있는 이벤트 목록과 추가 자료 링크를 확인할 수 있습니다.
이벤트#
- Any Event: 노드가 Slack의 모든 이벤트에서 트리거됩니다.
- App Home Opened: 사용자가 Slack 앱의 App Home 탭을 열면 노드가 트리거됩니다.
- 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: 노드가 워크스페이스의 모든 채널에서 선택한 Events를 감시할지(켜짐) 여부(꺼짐, 기본값)를 지정합니다.
주의
이 옵션을 사용하면 봇이나 앱이 속한 모든 채널의 모든 이벤트에 대해 실행이 하나씩 소비됩니다. 주의해서 사용하세요!
-
Channel to Watch: 노드가 선택한 Events를 감시할 채널을 선택합니다. 이 매개변수는 Watch Whole Workspace를 켜지 않은 경우에만 표시됩니다. 채널은 다음 방법으로 선택할 수 있습니다.
- From list: 노드가 자격 증명을 사용하여 워크스페이스의 채널 목록을 조회하므로 원하는 채널을 선택할 수 있습니다.
- By ID: 감시할 채널의 ID를 입력합니다. Slack은 채널 세부 정보 하단에 채널 ID를 표시하며 원클릭 복사 버튼을 제공합니다.
- By URL: 감시할 채널의 URL을
https://app.slack.com/client/<channel-address>형식으로 입력합니다.
-
Download Files: 파일을 다운로드하여 노드의 출력에 사용할지(켜짐) 여부(꺼짐, 기본값)를 지정합니다. 이 매개변수는 File Made Public 및 File Shared 이벤트와 함께 사용하세요.
옵션#
Add Option을 통해 노드의 동작을 더욱 세밀하게 조정할 수 있습니다.
- Resolve IDs: ID를 해당하는 이름으로 해석하여 반환할지(켜짐) 여부(꺼짐, 기본값)를 지정합니다.
- Usernames or IDs to ignore: 이벤트를 무시할 사용자 이름을 선택하거나 인코딩된 사용자 ID를 쉼표로 구분한 문자열로 입력합니다. 목록에서 선택하거나 표현식을 사용하여 ID를 지정할 수 있습니다.
- Emoji Names to Filter: Reaction Added 이벤트를 특정 반응으로만 제한하려면 이모지 이름을 쉼표로 구분(콜론으로 구분하지 않음)하여 입력합니다(예:
thumbsup, eyes, white_check_mark). 비워 두면 모든 반응에서 트리거됩니다.
관련 자료#
n8n은 Slack용 앱 노드를 제공합니다. 해당 노드 문서는 여기에서 확인할 수 있습니다.
n8n 웹사이트에서 예제 워크플로 및 관련 콘텐츠를 확인하세요.
Slack API에 대한 자세한 내용은 Slack 문서를 참고하세요.
필요한 스코프#
이 노드를 사용하려면 Slack에서 애플리케이션을 생성하고 이벤트 구독을 활성화해야 합니다. 자세한 내용은 Slack 자격 증명 | Slack Trigger 구성을 참고하세요.
이 트리거 노드가 작동하려면 Slack 앱에 적절한 스코프를 추가해야 합니다.
이 노드는 최소한 conversations.list 및 users.list 메서드에 대한 스코프가 필요합니다. 더 완전한 스코프 목록은 스코프 | Slack 자격 증명 목록을 확인하세요.
웹훅 검증#
버전 1.106.0부터 Slack 자격 증명을 구성할 때 Slack Signing Secret을 설정할 수 있습니다. 설정하면 Slack 트리거 노드가 요청이 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이 다시 정상적으로 작동해야 합니다.
토큰 만료#
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.