> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getporter.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Telegram Bot 연동

> Telegram에서 사내 데이터를 연동한 AI의 답변을 받을 수 있도록 설정합니다.

<Card>
  Telegram과 연동하면 Porter AI 봇이 Telegram에 연결됩니다. 채팅 연결 과정에서 지식베이스, MCP 서버, 데이터베이스 커넥터 등을 활성화하면 Telegram 채팅에서 사내 데이터를 활용할 수 있습니다.
</Card>

## Telegram 커넥터 설치

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/telegram01.png" />
</Frame>

> `설정 > 커넥터`에서 Telegram 커넥터를 선택한 후, 우측 상단의 `설치하기` 버튼으로 Telegram 커넥터를 설치합니다.

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/telegram02.png" />
</Frame>

## Telegram Bot 연결

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/telegram03.png" />
</Frame>

> 커넥터 설정 탭에서 `봇 추가` 버튼을 클릭한 후, Telegram Bot을 생성하면서 발급받은 Bot token을 입력하면 Porter AI와 Telegram Bot이 연결됩니다.

<Accordion title="Telegram Bot 생성 방법">
  <Frame>
    <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/telegram04.png" />
  </Frame>

  BotFather 대화창에서 `/newbot` 명령어를 입력한 후 봇의 이름을 정하면 봇을 생성하고 Bot token을 조회할 수 있습니다.
</Accordion>

## 채팅 연결과 설정

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/telegram05.png" />
</Frame>

> Bot 연결 후 아래에 표시되는 채팅 연결하기를 클릭하면 연결할 채팅과 답변할 AI 및 활용할 데이터와 도구 등을 설정할 수 있습니다.

### 채팅

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/telegram06.png" />
</Frame>

> 선택 목록으로 표시되는 DM 또는 그룹 채팅을 선택하여 연결한 Bot과 채팅할 수 있습니다.

<Note>
  연결 전에 생성된 Bot에게 메시지를 보내야 해당 Bot이 채팅 목록에 표시됩니다. 그리고 그 봇이 그룹 채팅의 참가자로 추가되어 있어야 해당 그룹 채팅이 연결할 수 있는 채팅 목록으로 표시됩니다.
</Note>

### 에이전트와 모델

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/telegram07.png" />
</Frame>

> Telegram Bot으로 활용할 에이전트와 모델을 선택할 수 있습니다.

<Info>
  모델 설정 페이지에서 활성화한 모델만 선택할 수 있습니다. 더 다양한 모델을 사용하려면 [AI 모델 운영](/ko/model)에서 사용할 모델을 활성화하세요.
</Info>

### 트리거 설정

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/telegram08.png" />
</Frame>

> Telegram Bot이 답변을 생성하도록 하는 트리거를 아래의 방식으로 설정할 수 있습니다.

<AccordionGroup>
  <Accordion title="멘션 (Mention)">
    `@Porter AI` 방식으로 봇을 직접 태그했을 때만 답변합니다.
  </Accordion>

  <Accordion title="Slash command">
    `/porter` 명령어에만 봇이 응답합니다.
  </Accordion>

  <Accordion title="프리픽스 (Prefix)">
    <Frame>
      <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/discord08.png" />
    </Frame>

    `!porter`와 같이 설정된 프리픽스로 시작하는 메시지에만 응답하는 방식이며, 프리픽스는 자유롭게 설정할 수 있습니다.
  </Accordion>

  <Accordion title="모든 메시지">
    연결된 채널의 모든 메시지에 응답합니다.
  </Accordion>
</AccordionGroup>

### 맞춤 지시사항과 표시항목

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/slack25.png" />
</Frame>

> 봇으로 활용할 AI의 역할, 스타일, 답변 지침 등의 시스템 프롬프트로 작동하는 맞춤 지시 사항과 답변 하단부의 표기 사항을 설정할 수 있습니다.

### 데이터와 도구

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/slack26.png" />
</Frame>

> 문서 파일 또는 Notion 데이터로 구성된 지식베이스, 연결한 MCP 서버, 데이터베이스 등을 활성화하면, AI 모델이 해당 데이터를 기반으로 답변할 수 있습니다.

<Info>
  활용하려는 데이터의 연동은 [문서 지식베이스(에이전틱 RAG)](/ko/rag), [Notion 데이터 연동 및 활용](/ko/notion), [MCP 서버로 업무 시스템 연결](/ko/mcp), [DB 데이터 조회](/ko/database)를 참고하세요.
</Info>

### Skills 기반 답변

> 미리 설정한 스킬을 활성화하면 Telegram에서 스킬을 활용한 에이전트의 작업을 요청할 수 있습니다.

<Tip>
  스킬을 추가하는 방법은 [Skills 관리](/ko/harness-and-skills#skills-관리)를 참고하세요.
</Tip>