# Telegram 플랫폼 구성

Telegram 봇을 Pushwoosh에 연결하여 옴니채널 Journey의 일부로 Telegram을 한 곳에서 실행하고 Journey 분석에서 전송 결과를 추적하세요.

## 전제 조건

Telegram을 구성하기 전에 다음 요구사항이 충족되었는지 확인하세요:

*   **Telegram 계정:** [@BotFather](https://t.me/BotFather)에 액세스할 수 있는 활성 Telegram 계정을 사용하세요.
*   **Telegram 봇:** BotFather에서 Telegram 봇을 생성하세요.

## Telegram 봇 API 토큰 복사하기

기존 봇의 API 토큰을 얻으려면:

1.  Telegram에서 **@BotFather**를 엽니다.
2.  `/mybots`를 보내고 봇을 선택합니다.
3.  **API 토큰**을 탭하고 토큰을 복사합니다.

봇이 없는 경우, [공식 Telegram 가이드](https://core.telegram.org/bots/features#botfather)에 따라 **@BotFather**에서 봇을 생성하세요.

## Pushwoosh에서 Telegram 구성 설정하기

Telegram 구성을 설정하려면 다음 단계를 따르세요:

1.  **설정 > 플랫폼 구성**으로 이동하여 **Telegram**을 엽니다.

2.  이미 봇이 있는 경우 **토큰 추가**를 클릭합니다. 없는 경우 **봇 생성**을 클릭합니다.

**봇 생성**을 클릭하면 Pushwoosh가 **@BotFather**를 통해 Telegram에서 봇을 생성하는 방법에 대한 지침을 엽니다. Telegram에서 봇 생성을 완료한 다음 Pushwoosh로 돌아와 봇 토큰을 연결하세요.

<img src="/configure-project-telegram-configuration-1.webp" alt="플랫폼 구성의 Telegram 통합 화면, 토큰 추가 및 BotFather 지침 포함."/>

3.  **Telegram 봇 연결** 대화상자에서 BotFather에서 복사한 **API 토큰**을 입력합니다. [토큰을 얻는 방법 알아보기](#copy-your-telegram-bot-api-token).

<img src="/configure-project-telegram-configuration-3.webp" alt="Telegram 봇 연결 대화상자, 표시 이름, API 토큰 필드, 토큰 확인, 취소 및 연결 포함."/>

4.  **토큰 확인**을 클릭하여 토큰을 검증합니다.
<img src="/configure-project-telegram-configuration-2.webp" alt="Telegram 봇 연결 대화상자, 표시 이름, API 토큰 필드, 토큰 확인, 취소 및 연결 포함."/>

5.  **연결**을 클릭하여 저장합니다. 변경 사항을 취소하려면 **취소**를 클릭합니다.

## Telegram 봇 토큰 관리

<Aside type="caution">

각 프로젝트는 한 번에 **하나**의 Telegram 봇 API 토큰만 사용할 수 있습니다. 다른 봇을 사용하려면 **플랫폼 구성**에서 토큰을 교체하거나 다른 프로젝트를 사용하세요.
봇 API 토큰을 변경하면 활성 상태인 Telegram Journey가 일시 중지됩니다.
</Aside>

### 새 토큰 추가

1.  **Telegram** 설정에서 **토큰 추가**를 클릭합니다.
2.  **Telegram 봇 연결** 대화상자에서 새 **API 토큰**을 입력합니다.
3.  **토큰 확인**을 클릭합니다.
4.  **연결**을 클릭합니다.

### 토큰 삭제

1.  봇 토큰 옆에 있는 **점 세 개 메뉴**를 클릭합니다.
2.  **삭제**를 클릭합니다.

토큰을 삭제하면 모든 활성 Telegram Journey가 일시 중지됩니다.

## Telegram 메시지 보내기

설정 후 **Customer Journey Builder**에서 Telegram 메시지를 보낼 수 있습니다.

<LinkCard title="더 알아보기" href="/product/messaging-channels/telegram/send-telegram-via-customer-journey/" />