Telegram

ElevenLabs 에이전트를 Telegram과 연결

개요

ElevenLabs AI 에이전트를 Telegram과 연결하여 봇으로 전송된 메시지에 응답하세요. 이 통합을 사용하면 에이전트가 비공개 채팅과 그룹에서 수신 메시지를 받고, 채팅 정보를 조회하고, 답장을 보내고, Telegram Bot API를 통해 메시지에 반응할 수 있습니다.

기능

기능지원
제로 보존 모드(ZRM)지원되지 않음
트리거의 첨부 파일지원되지 않음 — 수신 메시지의 사진, 파일 및 기타 미디어는 에이전트에 전달되지 않음
도구의 첨부 파일지원되지 않음 — 도구는 텍스트만 처리함

설정

1

Telegram 봇 만들기

Telegram을 열고 @BotFather와 대화를 시작하세요. /newbot을 전송한 후 안내에 따라 봇의 이름과 사용자 이름을 선택하세요. BotFather가 봇 토큰을 회신합니다.

2

ElevenLabs에서 연결

ElevenLabs 통합 설정에서 연결을 클릭하고 BotFather의 봇 토큰을 붙여넣으세요.

3

트리거 활성화

연결한 후 Telegram 메시지 트리거를 활성화하고 수신 메시지를 처리할 에이전트를 선택하세요. ElevenLabs가 Telegram에 웹훅을 자동 등록하여 봇이 메시지를 수신하기 시작합니다.

그룹에서 봇 사용하기

봇은 그룹의 관리자가 될 필요가 없으며, Telegram의 개인정보 보호 모드를 비활성화할 필요도 없습니다. 개인정보 보호 모드가 켜진 상태(기본값)에서는 Telegram이 봇을 명시적으로 언급하는 메시지를 전달하며, 이 통합은 정확히 이러한 메시지를 수신합니다.

  • 봇 사용자 이름에 대한 **@ 멘션 **(예: @my_bot what's the status?).
  • 같은 대화 흐름 내의 후속 대화를 포함한 봇 자체 메시지에 대한 답글.

봇을 언급하지 않는 메시지는 의도적으로 무시됩니다. 봇은 다른 봇의 메시지도 무시하며, 수정되거나 삭제된 메시지에는 작동하지 않습니다.

Telegram은 봇이 변경 후에 참여한 그룹에만 개인정보 보호 모드 및 관리자 역할 변경을 적용합니다. 이전에 @BotFather에서 개인정보 보호 모드를 전환했거나 멘션을 “수정”하려고 봇을 그룹 관리자로 지정했다면, 봇을 그룹에서 제거한 뒤 다시 추가하여 새 설정이 적용되도록 하세요. 일반적으로 멘션이 작동하게 만드는 것은 관리자 역할 자체가 아니라 이 과정입니다.

그룹 및 슈퍼그룹 채팅에서는 에이전트의 답장이 트리거 메시지에 대한 인용 답글로 전송되므로, 채팅이 활발한 경우에도 응답이 질문에 시각적으로 연결된 상태를 유지합니다. 비공개 1:1 채팅에서는 중복되므로 인용 답글이 표시되지 않습니다.

에이전트 도구

에이전트에 Telegram 도구를 추가하면 다음 기본 제공 도구를 사용할 수 있습니다.

도구설명
telegram_get_chat현재 채팅의 메타데이터(유형, 제목, 사용자 이름, 설명 등)를 조회합니다. chat_id는 현재 대화에 연결되어 있으며 다른 대상으로 변경할 수 없습니다.
telegram_send_message현재 채팅에 텍스트 메시지를 보냅니다. chat_id는 연결되어 있으며, 모델은 text와 선택적 parse_mode(HTML, Markdown 또는 MarkdownV2)를 제어합니다.
telegram_react_to_messageTelegram 봇에 허용된 리액션 세트에서 이모지 하나로 트리거 메시지에 반응합니다. 짧은 확인 응답(👍, 🎉, ❤)이 텍스트 답장보다 자연스러울 때 유용합니다. chat_id와 message_id는 모두 원래 대화 턴에 연결됩니다. 새 반응을 설정하면 봇이 동일한 메시지에 이전에 설정한 반응이 대체됩니다.

일부 채팅에서는 Telegram의 사용 가능한 반응 설정을 통해 허용되는 이모지를 제한합니다. 반응 호출이 거부되면 에이전트가 텍스트 답장으로 대체하도록 안내하세요.

동적 변수

에이전트가 Telegram에서 실행될 때 프롬프트와 도구에서 다음 동적 변수를 사용할 수 있습니다.

변수설명
integration__telegram_chat_id대화가 진행 중인 Telegram 채팅 ID입니다.
integration__telegram_message_id현재 에이전트 턴을 트리거한 사용자 메시지의 Telegram message_id입니다.
integration__telegram_connection_idElevenLabs 통합 연결 ID입니다.

프롬프트와 도구 호출에서 이러한 변수를 참조하는 방법은 동적 변수를 참조하세요.

유용한 링크