n8n 에러 텔레그램 알림 만들기 — Error Trigger로 워크플로우 실패 잡아내기

n8n.io 공식 템플릿 마켓플레이스에 공개된 이 워크플로우를 가져오면, 운영 중인 다른 n8n 워크플로우가 실패했을 때 그 실행으로 바로 연결되는 링크가 담긴 메시지를 텔레그램으로 받을 수 있습니다. 노드 몇 개를 조합한 결과물이 아니라 n8n이 플랫폼 차원에서 기본 제공하는 Error Trigger와 워크플로우 설정의 에러 워크플로우 지정 기능을 그대로 쓰는 구조라, 이 템플릿 하나만 제대로 이해하면 자신이 만든 어떤 워크플로우에도 같은 방식을 그대로 적용할 수 있습니다.

이 템플릿 하나로 보여줄 수 있는 것

면접에서 "운영까지 고려해봤어요?"라는 질문을 받으면 대부분 말문이 막힙니다. 워크플로우를 만드는 것과, 그 워크플로우가 실패했을 때 알아채는 것은 전혀 다른 역량이기 때문입니다. 이 템플릿은 그 질문에 구체적으로 답할 수 있게 해줍니다. "워크플로우가 실패하면 실행 링크가 담긴 알림이 텔레그램으로 오도록 에러 핸들링을 붙여봤습니다"라고 말할 수 있습니다.

문장 하나지만 안에 들어간 역량은 세 가지입니다.

• 에러 핸들링 설계 — 실패를 방치하지 않고 별도 워크플로우로 감지·통지하는 구조를 만들어본 경험
• 플랫폼 표준 기능 활용 — n8n이 기본 제공하는 Error Trigger와 워크플로우 설정의 에러 워크플로우 지정 기능을 직접 써본 경험
• 알림 채널 연동 — 텔레그램 크리덴셜을 등록하고 실제로 메시지를 발송해본 경험

이 세 가지는 에러 알림뿐 아니라 데이터 파이프라인, 스크래핑, 배치 작업처럼 "자동으로 도는데 사람이 지켜보고 있지 않은" 모든 워크플로우에 그대로 적용됩니다. 하나를 만들어두면 나머지 워크플로우는 Settings에서 같은 에러 워크플로우를 지정하기만 하면 됩니다.

이 템플릿은 무엇인가

이 워크플로우는 데이터팝콘이 만든 게 아닙니다. n8n 공식 템플릿 마켓플레이스(n8n.io/workflows)에 Report n8n workflow errors to Telegram이라는 이름으로 공개된 템플릿이고, 제작자는 Mutasem입니다. 카테고리는 DevOps로 등록돼 있습니다.

공식 설명에 따르면 에러 워크플로우는 운영 환경에서 워크플로우를 돌릴 때 중요하게 챙겨야 할 요소이고, 중요한 워크플로우라면 전부 에러 워크플로우를 설정해두라고 권합니다. 그리고 이 템플릿이 보내는 메시지는 실패한 실행(execution)으로 바로 연결됩니다.

이 템플릿은 사실 특정 업무 하나를 자동화하는 워크플로우라기보다, n8n이 플랫폼 차원에서 제공하는 에러 핸들링 패턴 — Error Trigger 노드와 워크플로우 설정의 Error workflow 지정 기능 — 을 가장 단순한 형태로 보여주는 예시에 가깝습니다. 그래서 이 글은 노드 하나하나를 훑기보다, 이 메커니즘 자체가 어떻게 동작하는지에 더 집중합니다.

n8n 설치나 기본 노드 조작법은 n8n으로 반복업무 자동화 포트폴리오 만들기에 정리돼 있으니, 이 글은 에러 핸들링 구조에 집중합니다.

구조 — Trigger / Task / Target

공식 페이지는 이 템플릿을 이루는 노드로 Error Trigger, Edit Fields(Set), Telegram 세 가지를 카드 미리보기에 표시하고, 노드가 하나 더 있다는 표시(+1)만 남겨둡니다. 정확한 캔버스 배치나 그 하나 더 있는 노드가 무엇인지는 공식 페이지에 공개돼 있지 않습니다. 다만 이 노드 구성과 "메시지가 실행으로 바로 연결된다"는 설명을 합치면, 흐름은 아래처럼 정리할 수 있습니다.

• Trigger — Error Trigger. 이 노드가 있는 워크플로우 자신이 아니라, 이 워크플로우를 에러 워크플로우로 지정해둔 다른 워크플로우가 실패했을 때 실행됩니다. n8n 공식 문서에 따르면 이 노드는 실패한 워크플로우의 실행 ID, 실행 URL, 에러 메시지, 마지막으로 실행된 노드 이름, 워크플로우 이름 같은 정보를 필드로 받습니다.
• Task — Edit Fields(Set). 이 필드들 중 사람이 읽을 수 있는 텍스트, 특히 실행 URL을 메시지 형태로 조립하는 역할로 보입니다. 다만 정확한 조립 방식(어떤 필드를 어떤 문구로 합치는지)까지는 공식 텍스트에 나와 있지 않아 이 이상 단정하지 않습니다.
• Target — Telegram. 조립된 메시지를 지정한 chat id로 전송합니다.

만들기

이 템플릿을 이해하려면 노드 하나하나보다 n8n이 에러를 처리하는 방식 자체를 먼저 알아야 합니다. n8n 공식 문서에 따르면 워크플로우의 실패를 감지하는 표준 방법은 두 조각으로 나뉩니다. 하나는 실패 정보를 받아서 실행되는 Error Trigger 노드이고, 다른 하나는 "이 워크플로우가 실패하면 저 워크플로우를 실행하라"고 지정하는 워크플로우 설정의 Error workflow 항목입니다. 이 템플릿은 이 두 조각을 텔레그램 발송과 묶어놓은 것입니다.

공식 Setup 단계는 3개입니다. 순서는 그대로 두고 각 단계에서 무엇을 확인해야 하는지 풀어씁니다.

1. 텔레그램 크리덴셜 연결

n8n의 Telegram 크리덴셜은 텔레그램 봇의 API 토큰을 필요로 합니다. n8n 공식 문서에 따르면 텔레그램에서 BotFather와 대화를 시작해 /newbot 명령으로 봇을 만들고, BotFather가 발급한 토큰을 n8n 크리덴셜의 Access Token 항목에 등록하면 됩니다. 봇 사용자명은 5자에서 32자 사이여야 하고 반드시 bot으로 끝나야 한다는 제약이 있습니다.

2. Telegram 노드에 chat id 설정

Telegram 노드에서 메시지를 받을 대상, 즉 개인 대화방이나 채널의 chat id를 지정합니다. 공식 Setup 텍스트에는 이 이상의 세부 사항이 없어서, 정확히 어떤 방식으로 chat id를 확인하도록 안내하는지는 이 템플릿 페이지만으로는 확인되지 않습니다.

3. 이 에러 워크플로우를 다른 워크플로우에 연결

여기가 이 템플릿의 핵심입니다. 이 워크플로우 자체는 실행할 대상이 아니라, 다른 운영 워크플로우들이 실패했을 때 대신 실행될 "에러 워크플로우" 역할을 합니다. n8n 공식 문서가 안내하는 연결 절차는 이렇습니다.

1. 알림을 받고 싶은 실제 운영 워크플로우를 엽니다.
2. 캔버스 우측 상단의 점 세 개 메뉴를 클릭하고 Settings를 선택합니다.
3. 워크플로우 설정 모달에서 Error workflow 항목을 찾아, 방금 만든 이 텔레그램 알림 워크플로우를 선택합니다.
4. Save로 저장합니다.

공식 Setup 3단계가 "다른 워크플로우들에 이 에러 워크플로우를 추가하라"고 복수형으로 적혀 있는 이유가 여기 있습니다. 에러 워크플로우 하나를 여러 운영 워크플로우의 Error workflow로 동시에 지정할 수 있어서, 알림 로직을 워크플로우마다 따로 만들 필요 없이 한 곳에서 관리할 수 있습니다.

주의할 점 · 제약

공식 문서에서 확인되는 제약과 이 템플릿의 THIN한 소스 한계를 그대로 옮기면 다음과 같습니다.

• 수동 실행으로는 테스트할 수 없습니다. n8n 공식 문서는 워크플로우를 수동으로 실행하는 동안에는 에러 워크플로우를 테스트할 수 없다고 명시합니다. 실제로 자동 실행(스케줄, 웹훅 등)이 실패해야만 이 알림이 오는 걸 확인할 수 있습니다.
• 트리거 노드 자체에서 에러가 나면 실행 링크가 제한적입니다. 실행 ID와 실행 URL은 실행이 데이터베이스에 저장돼 있어야 채워지는데, 워크플로우가 아직 시작도 되기 전인 트리거 노드 단계에서 에러가 나면 이 값이 비어 있을 수 있습니다. 이 경우 대신 트리거 자체의 에러 정보가 담긴 별도 필드를 받습니다. "메시지가 실행으로 바로 연결된다"는 이 템플릿의 장점이 이런 상황에서는 약해질 수 있다는 뜻입니다.
• Error Trigger가 있는 워크플로우는 기본적으로 자기 자신을 에러 워크플로우로 씁니다. n8n 공식 문서는 워크플로우 안에 Error Trigger 노드가 있으면 별도 설정이 없는 한 그 워크플로우가 스스로를 에러 워크플로우로 사용한다고 안내합니다. 이 템플릿을 다른 운영 워크플로우들의 공용 에러 핸들러로 쓰려면, 3단계처럼 각 운영 워크플로우의 Settings에서 명시적으로 이 워크플로우를 Error workflow로 지정해야 합니다.
• 정확한 캔버스 구성은 공개돼 있지 않습니다. 공식 페이지에는 노드 이름 목록과 짧은 설명만 있을 뿐, 노드 세부 파라미터나 정확한 연결 순서는 나와 있지 않습니다. 이 글의 구조도는 공개된 정보를 바탕으로 재구성한 것이라, 실제로 템플릿을 가져오면 세부 배치가 다를 수 있습니다.

포트폴리오·면접 포인트

포트폴리오에는 두 장이면 충분합니다. 운영 워크플로우의 Settings 모달에서 Error workflow가 이 템플릿으로 지정된 화면과, 워크플로우를 일부러 실패시켰을 때 텔레그램에 실행 링크가 담긴 메시지가 도착한 화면입니다. 실패를 일부러 만들 때는 Stop And Error 노드를 쓰면 됩니다. 공식 문서에 따르면 이 노드는 원래 커스텀 에러 메시지를 표시하고 조건에 따라 실행을 중단시켜 에러 워크플로우로 정보를 넘기는 용도로 만들어졌으니, 테스트용 실패를 만드는 데 그대로 맞는 노드입니다. 운영 워크플로우 중간에 이 노드를 하나 끼워 넣고 자동 실행(스케줄이나 웹훅)이 한 번 돌기를 기다리면 됩니다. 수동 실행으로는 에러 워크플로우가 돌지 않으므로, 확인은 반드시 자동 실행으로 해야 합니다.

면접에서는 "왜 에러 핸들링을 알림 워크플로우 하나로 따로 뒀나요?"라는 질문이 나올 수 있습니다. 답은 이렇게 할 수 있습니다. 운영 워크플로우가 늘어날수록 각 워크플로우 안에 알림 로직을 반복해서 넣는 건 비효율적이고, 알림 문구를 하나 바꾸려 해도 워크플로우 전부를 열어야 합니다. 에러 워크플로우를 하나로 분리하고 각 운영 워크플로우의 Settings에서 그것을 가리키게 하면, 알림 로직은 한 곳에서만 관리하면 됩니다. 이렇게 답하면 템플릿을 그대로 가져다 쓴 사람과 왜 이런 구조인지 이해한 사람이 갈립니다.

다음 액션

다음 편에서는 같은 마켓플레이스에 공개된 웹 스크래핑 템플릿을 다룹니다. 커뮤니티 노드를 쓰기 때문에 셀프호스팅 환경에서만 동작한다는 제약이 있어서, 이번 편에서 본 "n8n 표준 기능만으로 동작하는 템플릿"과 대조되는 사례로 보게 됩니다.