Make 이벤트 구독을 받기 전에 서명 확인과 중복 처리부터 준비해보세요

이벤트 구독은 어떻게 흘러가나요?

Make 조직 이벤트 → 구독 필터(All events 또는 고른 이벤트) → 서명한 JSON POST → 내 HTTPS 엔드포인트 → 실패하면 재시도

개발자 문서는 전달 하나가 JSON 본문을 담은 HTTP POST 요청이라고 설명해요. 이벤트에는 시나리오 단위와 조직 단위가 있고, 도움말은 예시로 시나리오 생성과 시나리오 실행 실패를 들어요. 이벤트 종류의 전체 목록과 본문 필드는 개발자 문서의 Event types 쪽 페이지에 따로 있어요.

누가 어떤 플랜에서 쓸 수 있나요?

도움말 기준이고 확인일은 2026-10-17이에요.

Teams 플랜이라면 3개를 어디에 쓸지 먼저 정해 두는 게 좋아요. 비활성화한 구독도 개수에 들어가서, 시험용 구독을 꺼 두기만 하면 자리가 계속 막혀 있어요.

구독은 어떤 순서로 만드나요?

1. Org > Utilities > Event subscriptions에서 Create event subscription을 눌러요.
2. 이름과 받을 주소를 넣어요. 주소는 POST를 받는 공개 HTTPS 엔드포인트여야 해요.
3. Send test event로 엔드포인트가 받는지 확인해요.
4. All events나 특정 이벤트를 골라요. 시나리오 단위 이벤트는 팀을 하나 이상 골라야 해요.
5. Create를 누르면 바로 Active 상태로 시작해요.

All events는 나중에 추가되는 이벤트 종류까지 받아요. 받는 쪽이 모르는 이벤트를 어떻게 다룰지 정하지 않았다면 처음에는 필요한 이벤트만 고르세요. 개발자 문서에도 모르는 이벤트 처리 방법을 다룬 페이지가 따로 있어요.

받은 요청이 Make에서 왔는지 어떻게 확인하나요?

구독마다 서명 비밀값이 있어요. Event subscription details 탭의 Signing secret에서 언제든 다시 볼 수 있어요. 도움말은 전달이 Standard Webhooks 사양을 따르니 공개된 라이브러리로 서명을 확인할 수 있다고 적어요.

서명 확인은 선택이지만 개발자 문서는 권장한다고 적어요. 주소만 알면 누구나 같은 엔드포인트로 POST할 수 있으니, 서명이 맞지 않는 요청은 처리하지 말고 버리는 쪽이 안전해요. 헤더 이름과 서명 형식은 개발자 문서의 Verify signatures 페이지에서 확인하고, 비밀값은 코드가 아니라 환경 변수나 비밀값 저장소에 두세요.

중복과 순서 뒤바뀜은 어떻게 다루나요?

Make는 최소 한 번 전달 방식이라 같은 전달이 여러 번 올 수 있고, 일어난 순서대로 온다는 보장도 없어요. 받는 쪽에서 이렇게 준비해 두면 돼요.

• 전달마다 붙는 고유 값을 저장해 두고, 이미 처리한 값이면 건너뛰어요.
• 시각 순서가 중요한 처리라면 도착 순서가 아니라 이벤트에 담긴 시각으로 정렬해요.
• 요청을 받으면 무거운 처리는 뒤로 미루고 먼저 응답해요.

마지막 항목은 문서 내용이 아니라 일반적인 웹훅 운영 방법이에요. 응답이 늦어 전달이 실패로 잡히면 재시도가 붙어 중복이 더 늘 수 있어서요. 고유 값으로 어떤 필드를 쓸지는 개발자 문서의 Receive events 페이지에서 정하세요.

전달이 실패하면 어떻게 되나요?

도움말에 적힌 재시도 규칙은 이래요.

• 첫 시도가 받아들여지지 않으면 최대 10번 더 보내요.
• 기다리는 시간은 30초에서 시작해 매번 두 배가 되고, 마지막 재시도 전에는 4시간 16분을 기다려요.
• 마지막 재시도까지 실패하면 그 전달은 Failed가 되고, 재시도 일정은 바꿀 수 없어요.

이 규칙대로 더하면 첫 시도부터 마지막 재시도까지 8시간 30분 남짓 걸려요. 엔드포인트가 반나절 넘게 멈추면 그 사이 이벤트는 Failed로 남는다는 뜻이에요. 실패가 이어지면 구독 상태가 Failing으로 바뀌지만 새 이벤트는 계속 보내고, 엔드포인트를 고칠 때까지 계속 실패해요. 실패 후 자동으로 꺼진다는 설명은 도움말에 없어요.

운영에 넣은 뒤 무엇을 확인하나요?

구독의 Logs 탭에서 전달마다 이벤트 종류, 팀, 상태, 응답 코드, 시각을 볼 수 있어요. 전달 하나를 열면 본문, 재시도 기록과 응답, Retrying 상태일 때 다음 재시도 시각까지 나와요. 로그를 얼마나 보관하는지는 도움말에 적혀 있지 않으니, 실패한 전달의 본문은 받는 쪽에서도 따로 저장해 두세요. Failed 전달은 구독을 Active로 돌린 뒤 직접 다시 보낼 수 있고, 이때도 같은 이벤트가 또 갈 수 있어요.

출처: Make Introducing event subscriptions, Make Event subscriptions, Make Event subscription 개발자 문서. 확인일 2026-10-17.