> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Telegram

Telegram 봇을 사용하면 리셉셔니스트가 통화 중에 사용자 또는 팀 그룹에 메시지를 보낼 수 있습니다. 예를 들어 발신자가 콜백을 요청하거나 긴급한 문제를 알릴 때 사용할 수 있습니다. [웹훅 도구](/docs/ko/reception-ai/integrations/webhooks)는 Telegram Bot API의 `sendMessage` 메서드를 호출합니다.

## 봇 만들기 및 채팅 ID 찾기

### 봇 만들기

Telegram에서 [@BotFather](https://t.me/BotFather)와의 채팅을 열고 `/newbot`을 전송한 다음 안내에 따라 이름을 지정합니다. BotFather가 `123456789:AA...`와 같은 봇 토큰을 응답합니다. 이 토큰은 비밀로 취급하세요. 토큰을 가진 사람은 누구나 봇을 제어할 수 있습니다.

### 봇과 채팅 시작

봇은 자신이 속한 채팅에만 메시지를 보낼 수 있습니다.

* **자신에게 메시지 보내기:** 새 봇과의 채팅을 열고 **Start**를 선택합니다.
* **그룹에 메시지 보내기:** 그룹에 봇을 추가한 다음 `/start@YOUR_BOT_NAME`처럼 봇을 멘션하는 메시지를 보냅니다.

### 채팅 ID 찾기

브라우저에서 `https://api.telegram.org/botBOT_TOKEN/getUpdates`를 열고 `BOT_TOKEN` 자리에 봇 토큰을 입력합니다. 응답에서 내 메시지를 찾아 `"chat":{"id":` 뒤의 숫자를 복사합니다. 그룹 ID는 `-1001234567890`처럼 음수이므로 마이너스 기호를 유지하세요.

응답이 비어 있으면 봇에 다른 메시지를 보내고 페이지를 새로고침합니다.

## 웹훅 도구 만들기

**Integrations**로 이동해 **Add integration**을 선택한 다음 **Webhook Tool**을 선택합니다.

| 필드                   | 값                                                                                              |
| -------------------- | ---------------------------------------------------------------------------------------------- |
| **Name**             | `notify_team_in_telegram`                                                                      |
| **Description**      | "Telegram에서 팀에 메시지를 보냅니다. 발신자가 콜백을 요청하거나, 사람과 통화하고 싶어 하거나, 긴급한 문제를 알릴 때 사용하세요."                |
| **Method**           | POST                                                                                           |
| **URL**              | `https://api.telegram.org/botBOT_TOKEN/sendMessage`(`BOT_TOKEN` 자리에 봇 토큰 입력)                   |
| **Body Parameters**  | `chat_id`(문자열, 필수): "항상 정확히 `CHAT_ID` 값입니다."  `text`(문자열, 필수): "메시지: 발신자의 이름, 전화번호, 요청 사항입니다." |
| **Assign to agents** | **Receptionist**                                                                               |

설명에서 `CHAT_ID`를 채팅 ID로 바꿉니다. URL에도 봇 토큰이 포함되므로 이 역시 비밀로 취급하세요.

**Enable**을 선택한 다음 콜백을 요청하여 [리셉셔니스트를 테스트](/docs/ko/reception-ai/receptionist/testing)합니다. 봇이 채팅에 메시지를 게시합니다.

> **Tip**
>
> 여러 채팅에 메시지를 보내려면 채팅 ID마다 도구를 하나씩 만드세요. 동일한 봇이 모든 채팅에 게시할 수 있습니다.

## 문제 해결

| 문제                            | 확인 사항                                                                 |
| ----------------------------- | --------------------------------------------------------------------- |
| Telegram에서 401을 반환함           | URL의 봇 토큰이 잘못되었거나 BotFather에서 취소되었습니다. URL에서 토큰 바로 앞에 `bot`이 있어야 합니다. |
| `Bad Request: chat not found` | 그룹의 마이너스 기호를 포함하여 채팅 ID가 올바른지, 봇과 채팅을 시작했거나 그룹에 봇을 추가했는지 확인합니다.       |
| `Forbidden: bot was kicked`   | 봇이 그룹에서 제거되었습니다. 다시 추가하세요.                                            |
| `getUpdates`에 아무것도 표시되지 않음    | 그룹에서 봇은 자신을 멘션한 메시지만 볼 수 있습니다. `/start@YOUR_BOT_NAME`을 전송하고 새로고침하세요.  |
| 리셉셔니스트가 전혀 게시하지 않음            | 도구 설명에 게시해야 하는 상황을 명시하세요.                                             |