# Telegram (ベータ版) 既存のTelegramアカウントをプラットフォームに接続すると、Telegramの会話が直接アプリに流れ込み、AIエージェントが返信できるようになります。接続するには、新しいデバイスでTelegramを追加するのと同じように、電話番号とログインコードを入力します。 > **ベータ版。** Telegramは現在どなたでもご利用いただけますが、まだ新しいサービスです。調整中につき、不具合が発生する可能性があります。説明通りに動作しない場合は、サポートまでお知らせください。 --- ## Telegram連携とは？ Telegram連携は、Telegram独自のログインフローを使用して、個人のTelegramアカウントをプラットフォームにリンクします。ボットを作成したり、別の電話番号を購入したりする必要はありません。普段お使いのTelegramアカウントでログインするだけで、1対1のチャットがアプリ内で利用可能になります。 これは、すでにTelegramで顧客とやり取りしており、既存のアカウントにAIエージェント、ブロードキャスト、共有インボックスを追加したい企業に最適です。 > **重要 — 接続前にお読みください。** これは**非公式**の連携であり、**個人のTelegramアカウント**を自動化するものです。Telegramのルールでは自動化や大量送信、迷惑メッセージが禁止されており、ルールに違反したアカウントは**利用制限や永久停止**の対象となる可能性があります（場合によっては、その電話番号自体が再登録できなくなることもあります）。このチャネルは、**すでに連絡を取り合っている相手や保存済みの連絡先**へのメッセージ送信にのみ使用し、送信量を抑え、AIが自然なペースで返信するようにしてください。コールドメールのような大量送信には**絶対に使用しないでください**。 --- ## TelegramとWhatsApp Webの比較 どちらも公式のBusiness APIを使用せず、すでに所有しているアカウントを接続します。 | 機能 | Telegram | WhatsApp Web | |---|---|---| | **セットアップ** | 電話番号 + ログインコードを入力 | スマートフォンをペアリング (QRまたはペアリングコード) | | **アカウントタイプ** | 個人のTelegramアカウント | 個人の/ビジネス用WhatsApp | | **メッセージごとのコスト** | 無料 | 無料 | | **テンプレートメッセージ** | 該当なし | 非対応 | | **入力中インジケーター** | 対応 | 対応 | | **メディア (受信)** | 写真、ドキュメント、ボイスメモ | 写真、ドキュメント、ボイスメモ | | **公式サポート** | 非公式統合 | 非公式統合 | | **推奨用途** | すでにTelegramで活動中、既存の連絡先がある場合 | WhatsAppを利用中、すぐに開始したい場合 | > **両方で同じ番号を使用できますか？** はい。TelegramとWhatsApp（Web）の両方で同じ電話番号を使用している場合、**両方**のチャネルとして接続できます。これらは「チャネル」ページ上で2つの個別の接続として実行され、それぞれ独自のステータス、ウォームアップ、制限を持ちます。一方を接続しても、もう一方に影響を与えたり、置き換えたりすることはありません。 --- ## Telegramのセットアップ ### ステップ 1: 接続フローを開く 1. 左側のサイドバーで、下部付近にある **Settings** をクリックします。 2. Settings の左側ナビゲーションで、**Channels** の下にある **Channels** をクリックします。 3. **Telegram** カードを見つけます（**Beta** の通知が表示されています）。**Connect** をクリックします。 ### ステップ2：電話番号を入力する 1. 接続したいTelegramアカウントの電話番号を、国番号を含めて入力します（例: `555 123 4567`）。 2. 最近のTelegramでの1対1の会話を連絡先として取り込み、空の受信トレイから開始したくない場合は、**Import existing chats**（既存のチャットをインポート）をオンにします。（これをオンにすると、**Keep AI paused for imported chats**（インポートしたチャットのAIを一時停止）も制御できるようになります。これは推奨設定でありデフォルトでオンになっているため、履歴をインポートしても古いメッセージに対して自動返信がトリガーされることはありません。準備ができたら、連絡先ごとに後からオフに切り替えることができます。） 3. **Send Login Code**（ログインコードを送信）をクリックします。 4. Telegramから**Telegramアプリ宛て**にログインコードが送信されます（通常、SMSではなく、公式の「Telegram」サービスチャットからのメッセージとして届きます）。 ### ステップ3：ログインコードを入力する 1. スマートフォンでTelegramを開きます。 2. **Telegram** サービスチャットからログインコードを確認します。 3. アプリにコードを入力します。 4. **Verify Code** をクリックします。 > **コードには有効期限があります。** **Send Login Code** をクリックする前にスマートフォンを手元に用意し、速やかにコードを入力してください。期限が切れた場合は、接続をやり直して新しいコードを取得してください。 ### ステップ4：2段階認証パスワード（設定している場合） Telegramアカウントで **2段階認証** が有効になっている場合、コード入力後に **2FAパスワード** が求められます。パスワードを入力し、**Verify Password** をクリックしてください。パスワードは安全なログインを完了するためにのみ使用され、読み取り可能な形式で保存されることはありません。 認証が完了すると、Channelsページにアカウントが **Connected** と表示されます。これでTelegramの会話がプラットフォームからアクセス可能になり、このチャネルに割り当てられたAIエージェントが受信メッセージに応答できるようになります。 ### 既存のチャットをインポートする ステップ2で **Import existing chats** をオンにした場合: - 最近のプライベート（1対1）チャットのみがインポートされます。グループチャットは含まれず、各チャットにつき一定量の最近の履歴のみが取得されます。 - インポートは接続直後にバックグラウンドで一度だけ実行されます。アカウントの規模が大きい場合、すべてが表示されるまでに少し時間がかかることがあります。 - インポートされたメッセージは「チャット」内の会話を補完しますが、[ダッシュボード](../get-started/dashboard.md)の数値やグラフにはカウントされません。接続後に送受信されたメッセージのみが測定対象となります。 インポートせずに接続した場合でも、その時点以降の新しい会話は通常通り受信されます。スキップされるのは過去の履歴のみです。 --- ## セッション管理 ### 接続ステータスの確認 Telegramの接続ステータスは、**Channels** ページの **Telegram** カードに表示されます。 | ステータス | 意味 | |---|---| | **接続済み** | アクティブで、メッセージの送受信が可能です | | **コード送信済み** | ログインコードの入力を待機中です | | **2段階認証が必要** | 2段階認証パスワードの入力を待機中です | | **未接続** | アクティブなセッションはありません | ### 再接続 セッションが切断された場合は、**設定 → チャネル → チャネル**を開き、Telegramカードを見つけて、接続/管理アクションを使用してください。セッションが自動的に復元できない場合（電話から終了した場合など）、新しいコードで再度ログインするよう求められます。 ### 切断 **Telegram**カードを開き、**切断**をクリックします。これにより、プラットフォームからTelegramアカウントがログアウトされ、セッションがクリーンアップされます。Telegramアプリ側から終了することも可能です：**設定 → デバイス → アクティブなセッション**から、プラットフォームのセッションを終了してください。 --- ## Telegramでの安全な利用について これは個人のアカウントを自動化するものであるため、アカウントの停止を防ぐことは利用者の責任となります。プラットフォーム側でAIの動作や送信間隔を調整し、自然に見えるようにしていますが、以下の慣行に従ってください。 - **温かい関係にある既存の連絡先のみにメッセージを送信してください。** 先にメッセージをくれた人や、保存済みの連絡先に返信しましょう。見知らぬ人に大量のメッセージを送ることは避けてください。これはTelegramのスパム判定を誘発する最も早い方法です。 - **送信量を低く抑えてください。** 特に新しく接続したアカウントでは注意が必要です。一度に行わず、数日かけて徐々に増やしていきましょう。 - **面識のない人にリンクを送ることは避けてください。** 見知らぬ人へのリンクが多いメッセージは、アカウント停止の一般的な原因となります。 - **AIには自然なペースで返信させてください。** 組み込みの遅延や入力インジケーターは、会話を人間らしく保つためのものです。これらを無効にしようとしないでください。 - **管理下にある実在の番号を使用してください。** 使い捨て/仮想（VoIP — 物理的なSIMではなくインターネットベースの電話番号）番号は、フラグが立てられる可能性が非常に高くなります。 > **警告。** Telegramがアカウントをスパムとしてフラグ付けした場合、動作が改善されるまで送信は停止されます。待機するだけでは解除されません。違反を繰り返すと、アカウントとその電話番号が永久に停止される可能性があります。 --- ## 送信制限、ウォームアップ、およびフォローアップの制御 Telegramは、WhatsApp Webと同様の保護的な送信制限、自動ウォームアップ、およびアカウントごとのフォローアップ停止スイッチを使用しています。これらは、個人アカウントがスパムファームのように見なされ、フラグが立てられるのを防ぐために存在します。**チャネル**ページでTelegramアカウントが接続されると、以下が表示されます： - **送信制限とウォームアップ**カード。WhatsApp Webと同じメーター（今日の送信メッセージ数、今日の新規連絡先数、現在のウォームアップ日数）が表示されます。 - **自動フォローアップ**トグル。新しく接続された番号ではデフォルトで**オン**になっているため、番号のウォームアップ中は必要に応じてオフにしてください。この機能は常に操作可能ですが、まだ通過していないウォームアップゲート（番号の経過日数、アクティビティの増加、最近の連絡先とのエンゲージメント）が表示されます。 ### 自動ウォームアップ（ランプアップ） 新しく接続されたTelegramアカウントは意図的に制限されており、時間の経過とともに容量が増加します。アカウントは、現在の制限の少なくとも75%を実際に送信した日にのみ「認定日」を獲得します。アイドル状態の日数はカウントされないため、実際の安定した使用なしにアカウントを昇格させることはできません。 - **1日のメッセージ上限** = `50 + 8 × (day − 1)`（最大 **500通/日**、58日目に到達）。 - **1日の新規連絡先上限** = `floor((day − 1) × 5 / 6)`（整数に切り捨て、最大 **50通/日**、61日目に到達）。 つまり、新しいアカウントでは1日50通のメッセージと1日0件の新規連絡先から開始し、約2か月かけて上限まで引き上げられます。チャネルページには、現在の日数、今日の上限に対する使用量、および上限に達するまでの進捗状況が表示されます。 ::: tip **ヒント：** すでに数ヶ月の正当なTelegram利用履歴があるアカウントを接続する場合、ランプアップパネルを使用してウォームアップ日数を進め、上限をすぐに解除できます。これは誠実に利用してください。実際にオーガニックな履歴があるアカウントに対してのみ使用してください。ウォームアップをスキップした新規アカウントは、BANされる可能性がはるかに高くなります。 ::: ### ランプアップ後の手動オーバーライド アカウントが58日間の完全なランプアップを完了すると、オプションのオーバーライドを使用して、1日のメッセージ上限を500通以上に引き上げることができます（750通から最大5,000通まで、250通単位で設定可能）。Telegramには公開された「安全な」数値はありません。保守的に運用し、スパムフラグに注意し、問題が発生した瞬間に制限を緩和してください。このオーバーライドは、完全にランプアップされたアカウントでのみ利用可能です。新しいアカウントがこの方法でウォームアップをスキップすることはできません。 ### アカウントごとのフォローアップ停止スイッチ **自動フォローアップ**トグルは、このアカウントのみを制御します。オフの場合、ブロードキャストやキャンペーンの設定に関係なく、そのアカウントから**いかなる種類の自動フォローアップも**送信されません。新規アカウント（ランプアップ期間が約30日未満）では、フォローアップをオフにして最初の返信のみを送信するのが最も安全です。フォローアップは、信頼性の低いアカウントが「ボットである」と分類される最も一般的な原因です。アカウントがウォームアップされ、安定してからオンに戻してください。 1日のメッセージ上限に達した場合、スケジュールされたフォローアップは失敗するのではなく、自動的に翌日に延期されます。 --- ## メディアメッセージ 受信した写真、ドキュメント、ボイスメモはチャットに取り込まれ、AIが理解できるようになります（ボイスメモは自動的に文字起こしされます）。このバージョンでは、AIからの送信返信は**テキストのみ**です。長い返信は、Telegramの4,096文字の制限に合わせて自動的にトリミングされます。 --- ## スマートフォンで既読ステータスを確認する AIがTelegramのチャットに返信したとき、または「チャット」でそのチャットを開いたとき、そのチャットは自身のTelegramアプリ上でも既読としてマークされます。そのため、未読チャットが何百件も溜まることなく、スマートフォンの未読バッジが同期された状態に保たれます。 ボットが回答しなかったチャット（オフの場合、営業時間外の場合、または返信しないことを選択した場合など）は、意図的に**未読**のままにされるため、自分で確認して対応することができます。 --- ## 制限事項 - **個人の1対1チャットのみ。** グループやチャンネルのメッセージはこのバージョンでは処理されません。 - **インラインボタンなし。** インタラクティブなボタンメニューはサポートされていません。 - **テキスト送信のみ。** AIはテキストで返信します。メディアの送信は今後のアップデートで予定されています。 - **非公式の統合。** Telegramのクライアントログインに依存しており、Telegramによって承認されたものではありません。Telegram側のプラットフォーム変更が影響を与える可能性があります。 - **アカウントのリスク。** 過度または未承諾の自動化は、アカウントの制限やBANにつながる可能性があります。上記の安全ガイドラインに従ってください。 --- ## トラブルシューティング ### ログインコードが届かない - Telegramアプリ内の **Telegram** サービスチャットを確認してください。コードは通常SMSではなく、そこに送信されます。 - 国番号を含め、電話番号が正しく入力されていることを確認してください。 - Telegramは、不審と判断したアカウントや番号に対してコードの送信を制限することがあります。数分待ってから再度試してください。 ### 「コードの有効期限切れ」または「無効なコード」 - コードの有効期間は短いです。接続をやり直して新しいコードを要求し、速やかに入力してください。 ### 予期せずパスワードを求められた - アカウントで2段階認証が有効になっています。Telegramのパスワードを入力してログインを完了してください。パスワードを忘れた場合は、Telegramの**設定 → プライバシーとセキュリティ → 2段階認証**からリセットしてください。 ### メッセージが送信されない - チャネルページで接続ステータスが **Connected**（接続済み）になっていることを確認してください。 - 連絡先がTelegramでメッセージを送信できる相手であることを確認してください。 - アカウントが最近スパムとしてフラグ立てされた場合は、送信量を減らし、既存の連絡先とのやり取りに限定してください。 ### アカウントがログアウトされた - セッションが終了しました（あなた自身、他のデバイス、またはTelegramによって）。**設定 → チャネル → チャネル**に移動し、**切断**をクリックしてから、再度ログインしてください。 --- ## ベストプラクティス - **Telegramですでに顧客とやり取りしているアカウントを接続してください**。作成したばかりの使い捨てアカウントは避けてください。 - **最初は自動化の量を少なくし**、徐々に増やしてください。 - **見知らぬ人へのコールドメッセージではなく**、受信したメッセージや既存の連絡先への返信から始めてください。 - **アカウントを健全に保ってください**。実在する番号を使用し、通常通りの利用を心がけ、控えめなペースで運用することで、BANのリスクを大幅に軽減できます。