🔔 [Lv.1] 링크 저장 시 슬랙 & 메일 실시간 알림

IMPORTANT

이 가이드에서는 우리 서비스에 링크가 추가되는 순간을 감지해서, 지정한 슬랙 채널과 이메일로 상세 정보를 전송하는 워크플로우를 만듭니다.

최대한 n8n의 기본 노드만을 사용하여 구현하는 방법을 안내드리며, 상황에 따라 커스텀 스크립트나 추가 노드가 필요할 수 있습니다.

생략된 정보도 있으며, n8n의 러닝커브가 있을 수 있으니, 익숙하지 않은 개발자 분들은 충분한 학습이나 테스트 후 적용하시길 권장드립니다.

본 가이드는 n8n 버전 1.115.3를 기준으로 작성되었습니다.

---

1. n8n 워크플로우 구성

• Webhook Node (트리거) → Slack Node (알림) → Gmail Node (알림)

---

2. 상세 설정 단계

Step 1: n8n에서 Webhook URL 생성 및 서비스 등록

1. n8n에서 Webhook 노드를 추가하고 HTTP Method를 POST로 설정합니다.
2. 생성된 Production Webhook URL을 복사합니다.
3. [우리 서비스 -> 팀 설정 -> 웹훅 관리] 페이지로 이동하여 복사한 URL을 붙여넣고 활성화 상태를 'ON' 으로 변경합니다. (이 설정을 해야 데이터가 전송됩니다.)

---

Step 2: 슬랙 알림 메시지 설정

이제 우리는 슬랙 노드를 추가하여, 새로운 링크가 저장될 때마다 알림을 보내도록 설정할 것입니다.

1. Step 1에서 생성한 Webhook 노드에 이어서 Slack 노드를 추가합니다.

2. 슬랙 노드에서 미리 생성한 슬랙 크레덴셜을 선택합니다.

3. Resource는 Message로, Operation은 Send로, Send Message To는 Channel로 설정합니다.

4. Channel 필드는 By ID로 설정하고, 알림을 받을 슬랙 채널의 ID를 입력합니다.

   • 채널 ID는 슬랙에서 해당 채널 우클릭 -> 채널 세부 정보 보기 -> 하단 채널 ID에서 확인할 수 있습니다. (예: C01234567AB)
   • 참고: 퍼블릭 채널은 #general과 같은 이름으로도 지정할 수 있지만, 프라이빗 채널은 반드시 ID로 지정해야 합니다.

5. Message Text 필드에 아래의 구조화된 텍스트를 복사하여 넣으세요.

6. 아래는 예시 메시지 템플릿입니다:

   🚀 *새로운 링크가 추가되었습니다!*
   
   📌 *제목*: {{ $json.body.data.title }}
   🔗 *URL*: {{ $json.body.data.url }}
   📂 *위치*: {{ $json.body.data.teamName }} > {{ $json.body.data.folderName }}
   🏷️ *태그*: {{ $json.body.data.tags.join(', ') }}
   
   📝 *요약*:
   > {{ $json.body.data.summary }}
   
   👤 *저장한 사람*: {{ $json.body.data.createdBy.nickname }}

7. 설정을 마친 후, 노드를 저장합니다.

---

Step 3: 지메일(Gmail) 알림 설정

1. Slack 노드 다음에 Gmail 노드를 추가합니다.
2. 지메일 노드에서 미리 생성한 지메일 크레덴셜을 선택합니다.

• 지메일 크레덴셜 생성 시 OAuth2 인증 방식을 사용해야 합니다. (일반 SMTP 방식은 보안 문제로 인해 권장되지 않습니다.)
• 지메일 크레덴셜 생성 방법은 각종 공식 문서나 가이드를 참고하세요.

3. Resource는 Message로, Operation은 Send로 설정합니다.

4. To 필드에 알림을 받을 이메일 주소를 입력합니다.

5. Subject 필드는 원하는 제목으로 설정합니다. 예: [Lilcookie] 신규 링크 저장 알림

6. Email Type은 Text로 설정합니다.

7. Message 필드에 아래의 구조화된 텍스트를 복사하여 넣으세요.

   [Lilcookie] 신규 링크 저장 알림
   
   우리 서비스에 새로운 지식이 저장되어 안내드립니다.
   
   --------------------------------------------------
   📑 저장 정보 상세
   --------------------------------------------------
   
   ■ 제목: {{ $('웹훅').item.json.body.data.title }}
   ■ 링크: {{ $('웹훅').item.json.body.data.url }}
   ■ 팀/폴더: {{ $('웹훅').item.json.body.data.teamName }} / {{ $('웹훅').item.json.body.data.folderName }}
   ■ 태그: {{ $('웹훅').item.json.body.data.tags.join(', ') }}
   
   [요약 내용]
   {{ $('웹훅').item.json.body.data.summary }}
   
   --------------------------------------------------
   추가된 링크의 상세 내용은 서비스에서 확인하실 수 있습니다.
   저장 시간: {{ $('웹훅').item.json.body.timestamp }}

8. 설정을 마친 후, 노드를 저장합니다.

---

3. 테스트 및 활성화

1. n8n 상단의 Execute Workflow를 클릭합니다.
2. 우리 서비스(웹/익스텐션)에서 링크를 저장합니다.
3. 슬랙 메시지와 지메일이 위 양식대로 예쁘게 도착하는지 확인합니다!

---

4. 결과 예시

• 전달된 슬랙 메시지 예시:

• 전달된 지메일 예시:

📚 데이터 구조 참고

웹훅으로 넘어오는 더 자세한 페이로드 정보는 아래 레퍼런스를 확인하세요.

👉 API Reference: 웹훅 이벤트 페이로드

구성된 n8n 워크플로우 파일

• Exam_Notification_n8n.json
• 위 링크를 클릭하여 워크플로우 JSON 파일을 다운로드한 후, n8n에서 가져오기(import)하여 사용하세요.