# 알림 개요

Mocco는 팀이 관심 있는 이벤트를 Discord에 게시합니다. 일부 이벤트는 승인을 기다리는 배포 게이트처럼 Mocco가 직접 만듭니다. 나머지는 이미 쓰고 있는 도구에서 옵니다. Sentry, Vercel, GitHub가 웹훅으로 Mocco에 이벤트를 보내면, Mocco는 요청한 이벤트만 전달합니다.

워크스페이스를 열고 왼쪽 메뉴에서 **Notifications**를 선택합니다. 페이지에는 탭이 세 개 있습니다.

| 탭 | 용도 |
|---|---|
| **Channels** | Discord를 연결하고, Mocco가 게시할 채널을 고르고, 채널마다 받을 이벤트(규칙)를 정합니다. |
| **Sources** | Sentry, Vercel, GitHub를 연결합니다. 소스마다 고유한 ingest URL과 서명 시크릿이 있습니다. |
| **Activity** | Mocco가 받았거나 만든 모든 이벤트와, 각 채널에서 그 이벤트가 어떻게 처리되었는지를 보여 줍니다. "왜 안 왔지?"를 확인할 때 씁니다. |

워크스페이스의 소유자와 관리자는 모든 것을 바꿀 수 있습니다. 멤버는 세 탭을 모두 볼 수 있지만 아무것도 바꿀 수 없습니다.

## 이벤트가 전달되는 과정

1. 도구가 소스의 ingest URL로 웹훅을 보내거나, Mocco가 자체 이벤트를 만듭니다.
2. Mocco가 서명을 확인하고 전달 내역을 기록합니다. 기록은 **Activity**에 나타납니다.
3. Mocco가 이를 `vercel.deployment.error`나 `gate.pending` 같은 이벤트로 변환합니다.
4. 이벤트와 일치하는 규칙이 있는 활성 채널마다 메시지가 전송됩니다. 일치하는 규칙이 없는 채널에는 아무것도 가지 않으며, 규칙이 왜 맞지 않았는지는 **Activity**에서 알려 줍니다.

메시지는 백그라운드에서 전송됩니다. Discord가 바쁘거나 봇에 속도 제한을 걸면 Mocco는 기다렸다가 다시 시도합니다. 메시지가 조금 늦게 도착할 수는 있지만 사라지지는 않습니다.

## 이 순서로 설정하세요

1. [Discord를 연결](https://www.mocco.club/docs/ko/articles/9kwifm-connect-discord)하고 채널을 하나 이상 추가합니다.
2. 채널에 규칙을 추가합니다. 프리셋을 쓰는 것이 가장 빠릅니다. 자체 배포 이벤트에는 **Mocco**, 소스에는 **Sentry**, **Vercel**, **GitHub** 프리셋을 씁니다.
3. 원하는 소스를 추가합니다. [Sentry](https://www.mocco.club/docs/ko/articles/wbbawp-sentry), [Vercel](https://www.mocco.club/docs/ko/articles/55gt7w-vercel), [GitHub](https://www.mocco.club/docs/ko/articles/cnzvv7-github)가 있습니다.
4. 첫 이벤트가 도착하면 **Activity**를 확인합니다.

![Sources 탭: 각 소스의 ingest URL, 마지막 수신 시각, 사용할 수 있는 동작](https://fi-workers-mocco-storage.s3.ap-northeast-2.amazonaws.com/pub/w/93e11fe8-0494-4e3d-b1cb-fe4dffd3ee7e/p/d64785b8-9a23-4fa1-a81d-550af30e203a/helpcenter/662afbe8-a646-44b9-9724-c9e669dd26e3/sources.png)

**Sources** 탭의 각 소스에는 **Ingest URL**(**Copy** 버튼 포함), 마지막으로 전달을 받은 시각, 그리고 **Pause** / **Resume**, **Rotate secret**, **Delete** 동작이 표시됩니다. 소스를 일시 중지하면 다시 시작할 때까지 Mocco가 그 소스의 전달을 거부합니다. 소스를 삭제하면 그 소스의 활동 기록도 함께 삭제됩니다. 각 소스의 **Setup steps**는 해당 가이드로 연결됩니다.

[Mocco 이벤트](https://www.mocco.club/docs/ko/articles/eriac3-mocco-events)에서 Mocco가 자체적으로 만드는 이벤트를 볼 수 있습니다. 알림이 보이지 않으면 [문제 해결](https://www.mocco.club/docs/ko/articles/pmzrkr-troubleshooting)을 참고하세요.

## 한도

- 워크스페이스는 하루에 소스 이벤트를 **5,000**건까지 전달할 수 있습니다. 이를 넘으면 전달 내역은 기록되지만 전달되지 않습니다(결과 `over_quota`). 한도는 대략적인 값이라, 한꺼번에 몰리면 조금 넘을 수 있습니다.
- 24시간 동안 전달이 **20,000**건을 넘으면, 서비스를 보호하기 위해 Mocco는 새 전달을 HTTP `429`로 거부하고 아무것도 기록하지 않습니다.
- 웹훅 본문은 최대 **1 MB**입니다.
- Activity는 **30일** 동안 보관됩니다.