Telegram Trigger 노드 공통 문제
n8n v2.29다음은 Telegram Trigger node에서 발생하는 일반적인 오류 및 문제와 이를 해결하거나 문제를 해결하는 단계입니다. Execute step 또는 Execute workflow 버튼으로 Telegram Trigger 노드를 테스트할 때, 실행이 멈춘 것처럼 보이며 이벤트 수신 대기를 중지하지 못할 수 있습니다.
다음은 Telegram Trigger node에서 발생하는 일반적인 오류 및 문제와 이를 해결하거나 문제를 해결하는 단계입니다.
트리거 이벤트를 기다리는 상태에서 멈춤#
Execute step 또는 Execute workflow 버튼으로 Telegram Trigger 노드를 테스트할 때, 실행이 멈춘 것처럼 보이며 이벤트 수신 대기를 중지하지 못할 수 있습니다. 이런 현상이 발생하면 워크플로를 종료했다가 다시 열어 캔버스를 초기화해야 할 수 있습니다.
이벤트 수신 대기가 멈추는 현상은 n8n 외부의 네트워크 구성 문제로 인해 자주 발생합니다. 특히 웹소켓 프록시를 구성하지 않은 상태에서 리버스 프록시 뒤에 n8n을 실행할 때 이런 현상이 자주 발생합니다.
이 문제를 해결하려면 리버스 프록시(Nginx, Caddy, Apache HTTP Server, Traefik 등)의 구성을 확인하여 웹소켓 지원을 활성화하세요.
Bad request: bad webhook: 웹훅에는 HTTPS URL을 제공해야 합니다#
이 오류는 리버스 프록시 뒤에서 n8n을 실행하는 중 인스턴스의 웹훅 URL에 문제가 있을 때 발생합니다.
리버스 프록시 뒤에서 n8n을 실행할 때는 n8n 인스턴스가 실행 중인 공개 URL로 WEBHOOK_URL 환경 변수를 구성해야 합니다. Telegram의 경우 이 URL은 HTTPS를 사용해야 합니다.
이 문제를 해결하려면 리버스 프록시에서 TLS/SSL 종료를 구성하세요. 그런 다음 WEBHOOK_URL 환경 변수를 HTTPS 주소를 사용하도록 업데이트하세요.
테스트 또는 프로덕션에서만 워크플로가 작동함#
Telegram은 앱당 하나의 웹훅만 등록할 수 있도록 허용합니다. 즉, 테스트 URL과 프로덕션 URL 사이를 전환할 때마다(그리고 그 반대의 경우에도) Telegram이 등록된 웹훅 URL을 덮어씁니다.
프로덕션에서도 활성화되어 있는 워크플로를 테스트하려고 하면 이로 인해 문제가 발생할 수 있습니다. Telegram 봇은 두 웹훅 URL 중 하나에만 이벤트를 전송하므로, 다른 하나는 이벤트 알림을 전혀 받지 못합니다.
이 문제를 우회하려면 테스트 중에는 워크플로를 비활성화하거나, 테스트용과 프로덕션용으로 별도의 Telegram 봇을 만드세요.
테스트용 별도 Telegram 봇을 만들려면 첫 번째 봇을 만들 때 진행했던 과정을 반복하세요. 자세한 내용은 Telegram의 봇 문서와 Telegram 봇 API 참조를 참고하세요.
테스트 중 워크플로를 비활성화하려면 다음을 시도하세요.
프로덕션 트래픽 중단
이 우회 방법은 테스트를 위해 프로덕션 워크플로를 일시적으로 비활성화합니다. 비활성화되어 있는 동안에는 워크플로가 더 이상 프로덕션 트래픽을 수신하지 않습니다.
- 워크플로 페이지로 이동합니다.
- 상단 패널에서 Active 스위치를 토글하여 워크플로를 일시적으로 비활성화합니다.
- 테스트 웹훅 URL을 사용하여 워크플로를 테스트합니다.
- 테스트가 끝나면 Inactive 토글을 다시 전환하여 워크플로를 다시 활성화합니다. 그러면 프로덕션 웹훅 URL이 다시 작동합니다.