> 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ボットを使うと、発信者が折り返し電話を求めた場合や緊急の問題を報告した場合などに、通話中の受付担当者から個人またはチームのグループへメッセージを送信できます。[Webhookツール](/docs/ja/reception-ai/integrations/webhooks)がTelegramのBot APIの`sendMessage`メソッドを呼び出します。

## ボットを作成してチャットIDを確認する

### ボットを作成する

Telegramで[@BotFather](https://t.me/BotFather)とのチャットを開き、`/newbot`を送信して、画面の指示に従って名前を付けます。BotFatherから、`123456789:AA...`のようなボットトークンが返信されます。これは秘密情報として扱ってください。トークンを知っている人は誰でもボットを操作できます。

### ボットとのチャットを開始する

ボットがメッセージを送信できるのは、参加しているチャットだけです。

* **自分にメッセージを送る場合：** 新しいボットとのチャットを開き、**開始** を選択します。
* **グループにメッセージを送る場合：** ボットをグループに追加し、`/start@YOUR_BOT_NAME`のようにボットをメンションするメッセージを送信します。

### チャットIDを確認する

ブラウザーで`https://api.telegram.org/botBOT_TOKEN/getUpdates`を開き、`BOT_TOKEN`をボットトークンに置き換えます。レスポンス内で送信したメッセージを見つけ、`"chat":{"id":`の後にある数字をコピーします。グループIDは`-1001234567890`のように負の値です。マイナス記号も含めてください。

レスポンスが空の場合は、ボットにもう一度メッセージを送信してページを再読み込みします。

## Webhookツールを作成する

**インテグレーション** に移動し、**インテグレーションを追加** を選択して、**Webhookツール** を選びます。

| フィールド           | 値                                                                                    |
| --------------- | ------------------------------------------------------------------------------------ |
| **名前**          | `notify_team_in_telegram`                                                            |
| **説明**          | 「Telegramでチームにメッセージを送信します。発信者が折り返し電話を求めた場合、担当者との会話を希望した場合、または緊急の問題を報告した場合に使用します。」    |
| **メソッド**        | POST                                                                                 |
| **URL**         | `https://api.telegram.org/botBOT_TOKEN/sendMessage`。`BOT_TOKEN`をボットトークンに置き換えます       |
| **本文パラメーター**    | `chat_id`（文字列、必須）：「常に正確な値`CHAT_ID`を使用します。」  `text`（文字列、必須）：「発信者の名前、電話番号、要件を含むメッセージ。」 |
| **エージェントに割り当て** | **受付担当者**                                                                            |

説明内の`CHAT_ID`をチャットIDに置き換えます。URLにはボットトークンが含まれるため、こちらも秘密情報として扱ってください。

**有効化** を選択し、折り返し電話を依頼して[受付担当者をテスト](/docs/ja/reception-ai/receptionist/testing)します。ボットがチャットにメッセージを投稿します。

> **Tip**
>
> 複数のチャットにメッセージを送るには、チャットIDごとにツールを1つ作成します。同じボットからすべてのチャットに投稿できます。

## トラブルシューティング

| 問題                            | 確認事項                                                                       |
| ----------------------------- | -------------------------------------------------------------------------- |
| Telegramから401が返される            | URL内のボットトークンが間違っているか、BotFatherで無効化されています。URLではトークンの直前に`bot`が必要です。          |
| `Bad Request: chat not found` | グループの場合はマイナス記号を含めてチャットIDを確認し、ボットとのチャットを開始したか、ボットをグループに追加したことを確認します。        |
| `Forbidden: bot was kicked`   | ボットがグループから削除されています。もう一度追加してください。                                           |
| `getUpdates`に何も表示されない         | グループ内のボットには、ボットをメンションしたメッセージだけが表示されます。`/start@YOUR_BOT_NAME`を送信して再読み込みします。 |
| 受付担当者が投稿しない                   | 投稿すべき状況をツールの説明に明記します。                                                      |