Skip to main content
API reference

Guide · Telegram

Telegram bot

Link a Telegram chat, group or channel to your 1322 account and the bot sends an alert for each new event from the accounts you track. In a linked chat you can also check your plan, list, add and remove tracked accounts, and change how alerts look.

All 8 sources · up to 2 linked chats · 15 commands
Bot
@X1322Bot
Link code
8 characters, 10 minutes
Configure
Settings > Telegram
Updated

How it works

  • When a new event arrives for an account you track, the bot sends it to every linked chat that routes that source. It works on all eight sources: X, Truth Social, Instagram, YouTube, TikTok, Binance Square, News and FOMO.
  • A chat receives events for what your account tracks, the same list your dashboard feed uses. For FOMO that means the traders, coins and global feeds on your list, after your trade filters.
  • On X posts and TikTok uploads, when a fuller version of the same post arrives a moment later (its media, for example), the bot edits the message it already sent instead of posting a second one.
  • Alerts are sent from 1322's servers, so the dashboard does not need to be open. Telegram is separate from the WebSocket and webhooks: use any of them together.

Groups and channels

Group. Add @X1322Bot to the group, then send /link CODE in the group. The person who sends it becomes the chat's linker.

  • The linker can run every command.
  • Telegram user ids you add under allowed user ids can run every command except /add, /remove, /settext and /buttons.
  • The bot ignores commands from anyone else, without a reply.
  • Account details stay hidden in a group: /status, /plans, /invoices, /renew, /addons, /list, /add and /remove answer with a notice until you turn on show data here for that chat. Only turn it on in groups you trust.
  • If a group has more than one bot, address the command to this one, for example /status@X1322Bot. Commands addressed to another bot are ignored.

Channel. Add @X1322Bot as an admin of the channel. Then, in Settings > Telegram, open Add a channel and paste the channel's numeric id, for example -1001234567890.

  • A channel receives alerts only. Commands never run in a channel.
  • A new channel starts with notifications and rich cards on.
  • A channel can be linked to one 1322 account only.

Limits and routing

  • Each account can link up to 2 chats, at most one of each type: one private chat, one group and one channel. Linking a chat that is already linked again does not count as a new one. To add a different chat, unlink one first.
  • Each linked chat routes all platforms or one source. Pick a source to make the chat that source's destination. Only one linked chat can route a given source.

Alert settings

Each linked chat has these settings under Linked chats in Settings > Telegram. The alert line and buttons can also be set from the chat with /settext and /buttons.

SettingWhat it does
commandsLets the chat run commands. On after /link. Channels never run commands.
notificationsSends alerts to this chat or stops them. /notifications in the chat does the same.
rich cardsOff: alerts are text only. On: alerts carry the post's images or video, as the media mode below says.
media modefirst_media: the first image (or a video's poster) with the text as its caption, and a +N more line when the post has more. media_group: an album of up to 10 images and videos, with the text in a separate message. text_only: no media.
routingAll platforms, or one source. Only one linked chat can be the chat for a given source.
buttonsdefault: Open post, Open dashboard and Notifications (plus Open @handle on X follow alerts, and the coin on FOMO alerts). raid: Like, Repost and Reply on X posts, plus Open post. Alerts that are not X posts keep the default buttons.
alert lineYour own text on top of every alert, up to 300 characters and 4 lines. {handle}, {name} and {platform} are filled in per alert.
show data hereGroups only. Lets account commands answer in this group (see Groups and channels).
allowed user idsGroups only. Telegram user ids that may run the commands marked Linker and allowed users.
Test cardSends one sample alert to the chat with its current settings.

For example, /settext 🚨 {handle} just posted puts that line, with the account's handle filled in, on top of every alert in the chat.

Commands

Type / in a chat with @X1322Bot to see the menu. Every command except /start, /link and /help needs a linked chat.

CommandWhat it doesWho can run it in a group
/startWelcome message and how to link this chat.Anyone
/link CODELink this chat to your account with a one-time code from the dashboard.Anyone
/statusYour access on each source, with the expiry date.Linker and allowed users
/plansYour current plans. Same answer as /status.Linker and allowed users
/list [platform]Your tracked accounts per source, or for one source. Shows up to 30 per source.Linker and allowed users
/add <platform> @handleStart tracking an account.Linker only
/remove <platform> @handleStop tracking an account.Linker only
/invoicesOpen invoices with their amounts, and a Pay button for up to 5 of them.Linker and allowed users
/renewA button to your billing page, where you renew by crypto or card.Linker and allowed users
/addonsAdd-ons you can buy for your current plans.Linker and allowed users
/notificationsTurn alerts in this chat on or off.Linker and allowed users
/settext <text>Put your own line on top of every alert. /settext alone shows it, /settext off removes it.Linker only
/buttons raid|defaultChoose the buttons under each alert. /buttons alone shows the current choice.Linker only
/helpThe command list.Anyone
/unlinkDisconnect this chat. Alerts and commands stop.Linker and allowed users

In a private chat, the person who linked it can run every command.

Add and remove accounts

/add and /remove take a source and a handle, for example /add x @elonmusk or /remove tiktok @creator.

  • Sources: x (or twitter), instagram (ig, insta), truth, binance, youtube (yt), tiktok (tt) and fomo. News is changed from the dashboard, not from the bot.
  • The handle can be written with or without @. It may use letters, numbers, _, . and -, up to 40 characters.
  • Your account needs an active plan for that source, or your own API key for it. Your plan's account limit still applies: when it is full, the bot tells you so and offers the billing page.
  • Access that 1322 manages for you by hand, and X Ultimate, cannot be changed from the bot. Contact support to change those lists.
  • A suspended or expired account cannot change tracked accounts until it is renewed.

Chat id destinations

Settings > Telegram also has Connect a chat, a simpler route without a link code or commands: pick one source, add @X1322Bot to the chat and enter the chat's numeric id.

  • Each destination sends alerts for one source. Your account needs access to that source.
  • Each account can have up to 20 of them. View delivery log shows recent sends and errors.
  • If the same chat is also a linked chat for that source, it gets each alert once.

Common questions

Which sources can send alerts to Telegram?

All eight: X, Truth Social, Instagram, YouTube, TikTok, Binance Square, News and FOMO. A chat gets alerts for the accounts you track, on the sources your account has access to.

Does the dashboard need to stay open?

No. Alerts are sent from 1322's servers, so they keep arriving with the dashboard closed. Telegram works next to the WebSocket and webhooks; you can use any of them together.

My link code does not work. What should I do?

A code works once and expires 10 minutes after you generate it. Generate a new one in Settings > Telegram and send /link with it to the bot in the chat you want to link. Letter case does not matter.

Why does the bot not answer in my group?

In a group, the bot answers only the person who linked it and the user ids on the chat's allowed list; it ignores everyone else without a reply. It also ignores commands addressed to another bot, such as /status@OtherBot, and it never runs commands in a channel.

Can I get alerts in more than one chat?

Yes, in up to two linked chats per account, of different types: a private chat and a group, a private chat and a channel, or a group and a channel. Give each its own source under routing, or keep both on all platforms.

How do I stop alerts?

Send /notifications in the chat to pause them, or /unlink to disconnect the chat. Settings > Telegram has the same switches and an Unlink button.

Related