Telegram 트리거¶

Telegram 봇으로 메시지가 수신되면 워크플로우를 즉시 실행합니다. 웹훅 방식으로 실시간 이벤트를 수신합니다.

설정¶

항목	설명
인증 정보	Telegram Bot Token

Bot Token 발급¶

Telegram에서 @BotFather에게 /newbot 명령어를 보냅니다.
봇 이름과 username을 설정합니다.
발급된 Bot Token을 프로젝트 인증 정보에 등록합니다.

출력¶

{
  "text_content": "사용자가 보낸 메시지 텍스트",
  "data_content": {
    "chat_id": 123456789,
    "message_id": 42,
    "from": {
      "id": 987654321,
      "first_name": "홍길동",
      "username": "honggildong"
    },
    "message_type": "text",
    "date": "2026-03-05T10:30:00Z"
  }
}

지원 메시지 타입¶

타입	`message_type`	설명
텍스트	`text`	일반 텍스트 메시지
문서	`document`	파일 첨부
사진	`photo`	이미지 전송
음성	`audio`	음성 메시지
동영상	`video`	동영상 전송

참조¶

{{ $('trigger').text_content }}                → 메시지 텍스트
{{ $('trigger').data_content.chat_id }}        → 채팅 ID (답장용)
{{ $('trigger').data_content.from.first_name }}→ 발신자 이름

활용 예시¶

AI 챗봇¶

사용자의 메시지를 AI 에이전트가 분석하고, 같은 채팅방에 답변을 전송합니다.

명령어 기반 자동화¶

주의 사항¶

실시간 수신

Telegram은 웹훅 방식으로 메시지를 즉시 수신합니다. 폴링 방식의 Gmail과 달리 지연이 거의 없습니다.

chat_id 활용

트리거의 chat_id를 Telegram 전송 스킬의 chat_id에 변수로 전달하면 같은 대화에 답장할 수 있습니다.