Telegram은 클라우드 기반의 인스턴트 메시징 및 VoIP 서비스입니다. 사용자는 메시지를 보내고 사진, 동영상, 스티커, 오디오, 모든 유형의 파일을 주고받을 수 있습니다. 이 페이지에서는 Telegram Trigger 노드가 반응할 수 있는 이벤트 목록과 관련 자료 링크를 확인할 수 있습니다.

이벤트(Events)#

• *: "Chat Member", "Message Reaction", "Message Reaction Count"를 제외한 모든 업데이트입니다(이들은 매우 많은 업데이트 호출을 발생시키므로 Telegram API의 기본 동작입니다).
• Business Connection: 봇이 비즈니스 계정에 연결되거나 연결이 해제될 때, 또는 사용자가 봇과의 기존 연결을 수정할 때 트리거됩니다.
• Business Message: 연결된 비즈니스 계정에서 새 메시지가 왔을 때 트리거됩니다.
• Callback Query: 새로운 콜백 쿼리가 수신될 때 트리거됩니다.
• Channel Post: 텍스트, 사진, 스티커 등 모든 종류의 새 채널 게시물이 수신될 때 트리거됩니다.
• Chat Boost: 채팅 부스트가 추가되거나 변경될 때 트리거됩니다. 이 업데이트를 받으려면 봇이 해당 채팅의 관리자여야 합니다.
• Chat Join Request: 채팅 참여 요청이 전송될 때 트리거됩니다. 이 업데이트를 받으려면 봇이 해당 채팅에서 can_invite_users 관리자 권한을 가지고 있어야 합니다.
• Chat Member: 채팅 멤버의 상태가 업데이트될 때 트리거됩니다. 봇이 해당 채팅의 관리자여야 합니다.
• Chosen Inline Result: 사용자가 인라인 쿼리 결과를 선택하여 전송할 때 트리거됩니다. 봇에서 이 업데이트를 활성화하는 방법에 대한 자세한 내용은 Telegram API 문서의 피드백 수집을 참고하세요.
• Deleted Business Messages: 연결된 비즈니스 계정에서 메시지가 삭제될 때 트리거됩니다.
• Edited Business Message: 연결된 비즈니스 계정에서 메시지의 새 버전이 왔을 때 트리거됩니다.
• Edited Channel Post: 봇이 알고 있는 채널 게시물이 편집되어 새 버전이 생겼을 때 트리거됩니다.
• Edited Message: 봇이 알고 있는 채널 게시물이 편집되어 새 버전이 생겼을 때 트리거됩니다.
• Inline Query: 새로운 인라인 쿼리가 수신될 때 트리거됩니다.
• Message: 텍스트, 사진, 스티커 등 모든 종류의 새 메시지가 수신될 때 트리거됩니다.
• Message Reaction: 사용자가 메시지에 대한 반응을 변경할 때 트리거됩니다. 봇이 해당 채팅의 관리자여야 합니다. 봇이 설정한 반응에 대해서는 업데이트가 수신되지 않습니다.
• Message Reaction Count: 익명 반응이 설정된 메시지의 반응이 변경될 때 트리거됩니다. 봇이 해당 채팅의 관리자여야 합니다. 업데이트는 그룹화되며 최대 몇 분까지 지연되어 전송될 수 있습니다.
• My Chat Member: 채팅에서 봇 자신의 채팅 멤버 상태가 업데이트될 때 트리거됩니다. 개인 채팅의 경우 이 업데이트는 사용자가 봇을 차단하거나 차단 해제할 때만 수신됩니다.
• Poll: 새로운 투표 상태에서 트리거됩니다. 봇은 중지된 투표와 봇 자신이 보낸 투표에 대한 업데이트만 수신합니다.
• Poll Answer: 사용자가 비익명 투표에서 응답을 변경할 때 트리거됩니다. 봇은 봇 자신이 보낸 투표에 대한 새 투표만 수신합니다.
• Pre-Checkout Query: 새로운 사전 결제(pre-checkout) 쿼리가 수신될 때 트리거됩니다. 결제에 대한 전체 정보를 포함합니다.
• Purchased Paid Media: 사용자가 채널이 아닌 채팅에서 봇이 보낸 비어 있지 않은 페이로드가 포함된 유료 미디어를 구매할 때 트리거됩니다.
• Removed Chat Boost: 채팅에서 부스트가 제거될 때 트리거됩니다. 이 업데이트를 받으려면 봇이 해당 채팅의 관리자여야 합니다.
• Shipping Query: 새로운 배송(shipping) 쿼리가 수신될 때 트리거됩니다. 유동 가격이 적용된 인보이스에만 해당됩니다.

일부 이벤트에는 추가 권한이 필요할 수 있습니다. 자세한 내용은 Telegram API 문서를 참고하세요.

옵션(Options)#

• Download Images/Files: 출력 데이터에 포함할 첨부 이미지나 파일을 다운로드할지 여부입니다.
  • Image Size: Download Images/Files를 활성화하면 다운로드할 이미지의 크기를 설정합니다. 기본적으로 큰 이미지를 다운로드합니다.
• Restrict to Chat IDs: 나열된 채팅 ID에 해당하는 이벤트에 대해서만 트리거됩니다. 쉼표로 구분하여 여러 채팅 ID를 포함할 수 있습니다.
• Restrict to User IDs: 나열된 사용자 ID에 해당하는 이벤트에 대해서만 트리거됩니다. 쉼표로 구분하여 여러 사용자 ID를 포함할 수 있습니다.

관련 자료(Related resources)#

n8n은 Telegram용 앱 노드를 제공합니다. 노드 문서는 여기에서 확인할 수 있습니다.

n8n 웹사이트에서 예제 워크플로 및 관련 콘텐츠를 확인하세요.

Telegram API에 대한 자세한 내용은 Telegram API 문서를 참고하세요.

자주 발생하는 문제(Common issues)#

자주 묻는 질문이나 문제 및 권장 해결 방법은 자주 발생하는 문제를 참고하세요.