Telegram 툴킷

Telegram 툴킷은 에이전트와 워크플로우가 Telegram 봇과 상호작용할 수 있게 합니다. 메시지 전송 및 편집, 미디어 전송, 채팅 구성원 관리, 초대 링크 생성, 인바운드 메시지에서 워크플로우를 트리거하기 위한 웹훅 등록을 지원합니다. Telegram 봇과 자격 증명은 @BotFather라는 Telegram 봇을 통해 관리됩니다 — 웹 개발자 콘솔은 없습니다.

​

전제 조건

​

1단계 — Telegram 봇 생성

​

2단계 — EK에 토큰 추가

​

토큰 관리

토큰이 실수로 유출된 경우 즉시 폐기하세요:

1. @BotFather에게 메시지를 보냅니다
2. /mybots를 보냅니다
3. 봇을 선택합니다
4. API Token → 현재 토큰 폐기를 탭합니다

새 토큰이 생성됩니다. EK에서 새 값으로 연결을 업데이트하세요.

​

사용 가능한 도구

​

트리거 — New Message

누군가가 Telegram 봇에 메시지를 보낼 때마다 자동으로 워크플로우를 시작합니다. 설정: 사용 가능한 트리거 변수:

​

메시징 작업

​

Send Text Message

봇에서 모든 Telegram 채팅으로 텍스트 메시지를 보냅니다. 핵심 입력: 다운스트림 단계에서 출력 참조:

• 메시지 ID (이후 편집 또는 삭제에 필요): {{ step.output.message_id }}
• 채팅 ID: {{ step.output.chat_id }}

​

Send Media

Telegram 채팅에 사진, 동영상, 스티커 또는 애니메이션 GIF를 보냅니다. 핵심 입력:

​

Edit Message Text

봇이 이전에 보낸 메시지의 텍스트를 업데이트합니다. 핵심 입력: 예시 사용 사례: 먼저 “요청을 처리하고 있습니다…”를 보냅니다. 워크플로우 로직을 실행합니다. 그런 다음 최종 결과로 해당 메시지를 편집합니다 — 사용자는 두 개가 아닌 하나의 메시지를 보게 됩니다.

​

Delete Message

채팅에서 메시지를 삭제합니다. 핵심 입력:

​

채팅 및 구성원 작업

​

Get Chat Info

채팅에 대한 메타데이터를 가져옵니다. 핵심 입력: 다운스트림 단계에서 값 참조:

• 채팅 제목: {{ step.output.title }}
• 설명: {{ step.output.description }}
• 초대 링크: {{ step.output.invite_link }}

​

Get Chat Member

채팅에서 특정 사용자를 조회하고 구성원 상태와 역할을 반환합니다. 핵심 입력: 다운스트림 단계에서 값 참조:

• 상태: {{ step.output.status }}
• 사용자 이름: {{ step.output.username }}

가능한 상태 값: creator, administrator, member, restricted, left, kicked 예시 사용 사례: {{ step.output.status }}를 확인합니다 — left 또는 kicked와 같으면 메시지 전송을 건너뛰고 대신 오류를 처리합니다.

​

Create Invite Link

그룹 또는 채널의 새 초대 링크를 생성합니다. 핵심 입력: 다운스트림 단계에서 링크 참조:

• 초대 URL: {{ step.output.invite_link }}

​

웹훅 설정 작업

이 두 단계는 New Message 트리거를 봇에 연결합니다. 워크플로우당 한 번만 실행하세요.

​

Register Webhook

Telegram에게 봇에서 워크플로우 URL로 메시지를 전달하기 시작하도록 요청합니다. 핵심 입력:

​

Deregister Webhook

웹훅을 제거하고 Telegram이 워크플로우로 메시지를 전달하는 것을 중지합니다. 핵심 입력:

​

문제 해결