Alter connects to Telegram with a bot token from @BotFather. Alter uses long polling on your Mac — you do not configure webhooks or a public URL.
始める前に
- Telegram アカウント。
- Alter が Mac にインストールされ、実行されています。
- Telegram アプリまたは Telegram Web。
- Telegram の @BotFather
- Telegram Bots — Features and BotFather
- Telegram Bot API tutorial
- Bot FAQ — groups and privacy
ステップ 1 — BotFather でボットを作成する
1
Open BotFather
2
Run /newbot
Send 
/newbot. BotFather asks for a display name (shown in contacts) and a username (must end in bot, for example MyAlterHelperBot).3
Copy the HTTP API token
When creation succeeds, BotFather sends a message containing your token (format like 
123456789:ABCdefGHIjklMNOpqrsTUVwxyz). Copy the full string.Telegram documents this flow in the Bot tutorial — Obtain your bot token.オプションの BotFather 設定
ステップ 2 — ボットとのチャットを開始する
1
Open the bot
Tap the link BotFather provides (for example
t.me/YourBotName) or search for your bot’s username in Telegram. The success message in Step 1 includes this link.2
Tap Start
Send
/start so Telegram opens a conversation. You need an active chat before testing Alter.ステップ 3 — オプション: グループでボットを使用する
Alter は、グループ チャットだけでなくプライベート チャットからもメッセージを受信できます。1
Add the bot to a group
In your group, add the bot as a member (you may need admin permission to add bots).
2
Check Group Privacy (if messages are missing)
By default, Telegram bots in groups may only see commands and @mentions. For broader group access, open @BotFather →
/mybots → your bot → Bot Settings → Group Privacy → Turn off.See Bot FAQ — privacy mode.3
Restrict access if needed
If the bot should only respond to certain people or groups, see Secure access — allowlists and IDs below and fill in 許可された Telegram ユーザーまたはチャット ID when you connect Alter.
安全なアクセス — ホワイトリストと ID
設定 → Integrations → Gateways の 許可された Telegram ユーザーまたはチャット ID を使用して、Telegram ゲートウェイを使用できる人を制限します。 Alter は、アクションを実行する前に、すべての受信メッセージとそのリストに対するインライン ボタンのタップをチェックします。Alter matches user IDs, chat IDs, and
@usernames (case-insensitive). Leave the field empty to allow anyone who can message the bot. Enter * to allow everyone explicitly. Messages from users or chats not on the list are silently ignored — Alter does not reply with an error.ユーザー ID とチャット ID
Telegram は人物と会話の両方に数値 ID を使用します。
ボットとの private chat では、チャット ID は通常、ユーザー ID と同じです。グループ内の全員を許可したい場合は、group でグループのチャット ID を追加します (Group Privacy 設定に従います)。
Alter は、その人が公開ユーザー名を持っている場合、
@username 値 (例: @sam) も受け入れます。
Telegram ユーザー ID を確認する方法
1
Use an ID bot (easiest)
In Telegram, open @userinfobot or @getidsbot and tap Start. The bot replies with your numeric Id — that is your user ID.Copy the number (digits only, no
@) into 許可された Telegram ユーザーまたはチャット ID.2
Forward a message (groups or other chats)
To identify someone else, forward one of their messages to @userinfobot or @getidsbot. The bot reports the sender’s user ID.
チャット ID の確認方法
1
Private chat with your bot
Your user ID from Step 1 above is usually enough — private chat IDs match the user’s ID.To confirm, message your bot, then call Telegram’s
getUpdates method with your bot token and look for "chat": {"id": …} and "from": {"id": …} in the JSON. See Telegram Bot API — Chat and User.2
Group or supergroup
Add @getidsbot to the group temporarily (or use @RawDataBot), send any message in the group, and copy the Chat ID from the bot’s reply. Group IDs are negative numbers.Remove the ID bot from the group when you are done if you do not need it there permanently.
3
Bot API getUpdates (no extra bots)
With your bot token, open this URL in a browser (replace
TOKEN with your token):https://api.telegram.org/botTOKEN/getUpdatesSend a test message in the chat you want to identify, refresh the page, and read message.chat.id (chat ID) and message.from.id (sender user ID) from the latest entry.Alter で許可リストを構成します
1
Collect IDs
Gather comma-separated user IDs, chat IDs, and/or
@usernames for everyone (or every group) that should be able to use the bot.2
Paste into Gateways settings
Open 設定 → Integrations → Gateways, edit your Telegram gateway, and enter the values in 許可された Telegram ユーザーまたはチャット ID (for example
123456789, -1001234567890, @sam).3
Save and test
Click 保存して再起動. Message the bot from an allowed account or group — you should get a reply. Messages from IDs not on the list are ignored with no response.
セキュリティのベスト プラクティス
- Treat the bot token like a password. Alter (Keychain) にのみ保管してください。漏洩した場合は、@BotFather で
/revokeを使用してトークンを取り消し、新しいトークンをAlter に貼り付けます。 - Use an allowlist for personal bots. 空の許可リストは、Alter の実行中にボットを発見した人は誰でもメッセージを送信できることを意味します。
- Prefer numeric IDs over
@username. ユーザー名は変更できます。数値 ID は安定しています。 - Limit group exposure. ボットがすべてのグループ メッセージを読み取る必要がある場合を除き、BotFather で Group Privacy をオンにします。信頼できるグループのみを追加し、ボットが複数のグループに属している場合はグループ チャット ID を許可リストに登録します。
- Be cautious with third-party ID bots. 転送されたメッセージとグループのメタデータを確認できます。不要になった場合は、機密グループから削除してください。
Alter に接続します
1
Open Gateways settings
Open 設定 (⌘,) → Integrations → Gateways.
2
Add a Telegram gateway
Click Gateway を追加 → Telegram.
3
Fill in Connection fields
4
Choose デフォルト Action
Ask Anything がデフォルトで、Telegram ですぐ使えます。カスタム Action には Action Editor → Gateways で 可用性 を Telegram または すべて に設定します。
5
Enable and save
Turn 有効 on, then click 保存して再起動. Wait for 接続済み @your_bot_username.
ボットをテストする
1
Confirm Alter is running
Gateways only work while Alter is open on your Mac.
2
Send /help
In your Telegram chat with the bot, send
/help. The bot should list commands.3
Send a message
Send a normal message. Alter should show Thinking…, then stream the reply. In private chats, Alter uses Telegram’s native draft preview when available; otherwise it edits a regular message (rich replies can be up to about 32,000 characters).
4
Try buttons and /stop
Send
/help and use the New chat, Choose action, or Past chats buttons. While Alter is responding in a group, tap Stop or send /stop to cancel the current turn.5
Try attachments
Send a photo or document. Alter downloads supported attachments for the turn and can upload output files from tool runs when the action produces them.
6
Try voice messages
Send a voice message or audio file. Alter transcribes it with your selected voice processor (設定 → Voice) and sends the text to the active action. Audio-only messages work as chat turns even without typed text.