Telegram (ベータ版) #

既存のTelegramアカウントをプラットフォームに接続すると、Telegramの会話が直接アプリに流れ込み、AIエージェントが返信できるようになります。接続するには、新しいデバイスでTelegramを追加するのと同じように、電話番号とログインコードを入力します。

ベータ版。 Telegramは現在どなたでもご利用いただけますが、まだ新しいサービスです。調整中につき、不具合が発生する可能性があります。説明通りに動作しない場合は、サポートまでお知らせください。

Telegram連携とは？ #

Telegram連携は、Telegram独自のログインフローを使用して、個人のTelegramアカウントをプラットフォームにリンクします。ボットを作成したり、別の電話番号を購入したりする必要はありません。普段お使いのTelegramアカウントでログインするだけで、1対1のチャットがアプリ内で利用可能になります。

これは、すでにTelegramで顧客とやり取りしており、既存のアカウントにAIエージェント、ブロードキャスト、共有インボックスを追加したい企業に最適です。

重要 — 接続前にお読みください。 これは非公式の連携であり、個人のTelegramアカウントを自動化するものです。Telegramのルールでは自動化や大量送信、迷惑メッセージが禁止されており、ルールに違反したアカウントは利用制限や永久停止の対象となる可能性があります（場合によっては、その電話番号自体が再登録できなくなることもあります）。このチャネルは、すでに連絡を取り合っている相手や保存済みの連絡先へのメッセージ送信にのみ使用し、送信量を抑え、AIが自然なペースで返信するようにしてください。コールドメールのような大量送信には絶対に使用しないでください。

TelegramとWhatsApp Webの比較 #

どちらも公式のBusiness APIを使用せず、すでに所有しているアカウントを接続します。

料金について。 接続されたTelegramアカウント1つにつき月額50クレジットが、お客様のクレジット残高から差し引かれます。メッセージごとの追加料金はありません。最初の課金は接続から30日後に行われ、その後はアカウントが接続されている限り30日ごとに課金されます。接続を解除すると課金は停止します。月額料金の支払い時に残高が不足している場合、その月はスキップされ、約30日後に再度試行されます。スキップされた月分が後から請求されることはなく、チャージを行っても即座に課金されることはありません。また、アカウントの接続状態は維持されます。

両方で同じ番号を使用できますか？ はい。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の会話を連絡先として取り込みたい場合は、既存のチャットをインポートをオンにします。これにより、空の受信トレイから始める必要がなくなります。（これをオンにすると、インポートしたチャットでAIを一時停止するの制御も可能になります。これはデフォルトでオンになっており、履歴のインポートによって古いメッセージに自動返信が送信されるのを防ぐため、オンのままにすることを推奨します。準備ができたら、連絡先ごとにオフに切り替えてください。）
3. この接続に対して月額50クレジットが課金されることを理解しましたにチェックを入れます。これを行うまで、ログインコードを送信ボタンはグレーアウトされたままになります。
4. ログインコードを送信をクリックします。
5. 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エージェントが受信メッセージに応答できるようになります。

各Telegramアカウントは、1つのワークスペースにつき1回のみ接続できます。アカウントがすでに接続されている場合（別の電話番号であっても）、接続フローは停止し、その旨が通知されます。既存の接続を使用するか、先に接続を解除してください。

既存のチャットをインポートする #

ステップ2で Import existing chats をオンにした場合:

• 最近のプライベート（1対1）チャットのみがインポートされます。グループチャットは含まれず、各チャットにつき一定量の最近の履歴のみが取得されます。
• インポートは接続直後にバックグラウンドで一度だけ実行されます。アカウントの規模が大きい場合、すべてが表示されるまでに少し時間がかかることがあります。
• インポートされたメッセージは「チャット」内の会話を補完しますが、ダッシュボードの数値やグラフにはカウントされません。接続後に送受信されたメッセージのみが測定対象となります。

インポートせずに接続した場合でも、その時点以降の新しい会話は通常通り受信されます。スキップされるのは過去の履歴のみです。

セッション管理 #

接続ステータスの確認 #

Telegramの接続ステータスは、Channels ページの Telegram カードに表示されます。

再接続 #

セッションが切断された場合は、設定 → チャネル → チャネルを開き、Telegramカードを見つけて、接続/管理アクションを使用してください。セッションが自動的に復元できない場合（電話から終了した場合など）、新しいコードで再度ログインするよう求められます。

わざわざ探しに行く必要はありません。Telegramがセッションを終了すると、アプリ内のすべてのページの上部にTelegram signed you out（Telegramからサインアウトされました）バーが表示され、ログイン画面をすぐに開けるReconnect（再接続）ボタンが表示されます。その他の理由で接続が切断された場合は、Telegram disconnected（Telegramが切断されました）バーが表示され、バックグラウンドで再試行が継続されます。接続が復旧すると、このバーは自動的に消えます。これには、接続は維持されているものの応答がなくなった場合も含まれます。アプリは数分おきにTelegramが応答するかを確認し、応答のない接続を自動的にリセットします。アカウントが再接続されるまで、AIはそのアカウントで返信を行いません。

切断 #

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か月かけて上限まで引き上げられます。チャネルページには、現在の日数、今日の上限に対する使用量、および上限に達するまでの進捗状況が表示されます。

独自の日次上限を設定する #

ウォームアップ期間中であればいつでも、独自の日次メッセージ上限を設定できます。Channels（チャネル）ページでTelegramカードを開き、Set daily limit（日次制限を設定）をクリックして、1日あたり100〜1,500通の範囲で数値を指定してください。設定した上限は、ウォームアップ期間中のメッセージ上限に代わって直ちに適用されます（上限を下回る場合も上回る場合も同様です）。新規連絡先への日次上限は引き続きウォームアップ設定に従うため、新しいアカウントでも返信数は増やせますが、見知らぬ人へのメッセージ送信数は増えません。上限設定を解除すると、アカウントは再びウォームアップスケジュールに戻ります。

上限を引き上げると即座に反映され、古い制限で一時停止されていた会話が再開されます。Telegramにおいて「安全」と公表されている数値はありません。控えめな運用を心がけ、スパムフラグに注意し、問題の兆候があればすぐに制限を緩和してください。一般的なアカウントの送信量を大幅に超える送信は、アカウントが制限される最も早い原因となります。なお、制限はプラットフォーム側ではなく、お客様のTelegramアカウントに対して課されます。

APIから上限を設定することも可能です。Update Phone Numberエンドポイントを使用して daily_message_limit_manual_override（100〜1,500、または解除する場合は0）を送信するか（APIリファレンスの「Channels」ページにある「Sending limits and warm-up day」を参照）、ramp-dayエンドポイントを使用してウォームアップ日を変更してください。

再接続してもウォームアップ状態は維持されます #

同じTelegramアカウントを切断して再接続した場合（電話番号が新しい場合でも）、再接続した瞬間に本プラットフォーム上の送信履歴からウォームアップ日が復元されるため、1日目からやり直す必要はありません。

アカウントごとのフォローアップ停止スイッチ #

自動フォローアップのトグルは、このアカウントのみに適用されます。オフにすると、ブロードキャストやエージェントの設定に関係なく、そのアカウントからはいかなる種類の自動フォローアップも送信されなくなります。新規アカウント（運用開始から約30日未満）の場合は、フォローアップをオフにして最初の返信のみを送信するのが最も安全です。フォローアップは、信頼性の低いアカウントが「ボットである」と判定される最大の要因となることが多いためです。アカウントが十分に温まり、安定してから再度オンにしてください。

1日のメッセージ上限に達した場合、スケジュールされたフォローアップは失敗するのではなく、自動的に翌日に延期されます。

複数のアカウントに訪問者を分散させる #

ショートリンク を使用して、WhatsApp番号でローテーションを行うのと同様に、複数のTelegramアカウント間でローテーションを行うことができます。クリックされるたびに、その日の送信枠に最も余裕があるアカウントの t.me/<username> が開かれます。切断されているアカウント、ユーザー名が設定されていないアカウント、またはその日の送信上限に達したアカウントはスキップされるため、いずれかのアカウントが停止してもリンクは機能し続けます。Settings → Short Links → New link から作成し、Telegram を選択してください。各アカウントには、Telegramで公開ユーザー名が設定されている必要があります。

メディアメッセージ #

受信した写真、ドキュメント、ボイスメモはチャットに取り込まれ、AIが理解できるようになります（ボイスメモは自動的に文字起こしされます）。このバージョンでは、AIからの送信返信はテキストのみです。長い返信は、Telegramの4,096文字の制限に合わせて自動的にトリミングされます。

スマートフォンで既読ステータスを確認する #

AIがTelegramのチャットに返信したとき、または「チャット」でそのチャットを開いたとき、そのチャットは自身のTelegramアプリ上でも既読としてマークされます。そのため、未読チャットが何百件も溜まることなく、スマートフォンの未読バッジが同期された状態に保たれます。

ボットが回答しなかったチャット（オフの場合、営業時間外の場合、または返信しないことを選択した場合など）は、意図的に未読のままにされるため、自分で確認して対応することができます。

制限事項 #

• 個人の1対1チャットのみ。 グループやチャンネルのメッセージはこのバージョンでは処理されません。
• インラインボタンなし。 インタラクティブなボタンメニューはサポートされていません。
• テキスト送信のみ。 AIはテキストで返信します。メディアの送信は今後のアップデートで予定されています。
• 非公式の統合。 Telegramのクライアントログインに依存しており、Telegramによって承認されたものではありません。Telegram側のプラットフォーム変更が影響を与える可能性があります。
• アカウントのリスク。 過度または未承諾の自動化は、アカウントの制限やBANにつながる可能性があります。上記の安全ガイドラインに従ってください。

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

ログインコードが届かない #

• Telegramアプリ内の Telegram サービスチャットを確認してください。コードは通常SMSではなく、そこに送信されます。
• 国番号を含め、電話番号が正しく入力されていることを確認してください。
• Telegramは、不審と判断したアカウントや番号に対してコードの送信を制限することがあります。数分待ってから再度試してください。

「コードの有効期限切れ」または「無効なコード」 #

• コードの有効期間は短いです。接続をやり直して新しいコードを要求し、速やかに入力してください。

予期せずパスワードを求められた #

• アカウントで2段階認証が有効になっています。Telegramのパスワードを入力してログインを完了してください。パスワードを忘れた場合は、Telegramの設定 → プライバシーとセキュリティ → 2段階認証からリセットしてください。

メッセージが送信されない #

• 「Channels」（チャンネル）ページで接続ステータスがConnected（接続済み）になっていることを確認してください。
• 送信がタイムアウトで失敗した場合、アプリはすぐに接続を確認し、Telegramが応答していない場合は接続をリセットします。数分後に再度メッセージを送信してみてください。
• その連絡先がTelegramでメッセージを送信できる相手であることを確認してください。
• アカウントが最近スパムとしてフラグを立てられた場合は、送信量を減らし、既存の連絡先のみに限定してください。

アカウントがログアウトされた #

• セッションが終了しました（あなた自身、他のデバイス、またはTelegramによって）。設定 → チャネル → チャネルに移動し、切断をクリックしてから、再度ログインしてください。

ベストプラクティス #

• Telegramですでに顧客とやり取りしているアカウントを接続してください。作成したばかりの使い捨てアカウントは避けてください。
• 最初は自動化の量を少なくし、徐々に増やしてください。
• 見知らぬ人へのコールドメッセージではなく、受信したメッセージや既存の連絡先への返信から始めてください。
• アカウントを健全に保ってください。実在する番号を使用し、通常通りの利用を心がけ、控えめなペースで運用することで、BANのリスクを大幅に軽減できます。