> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xquik.com/llms.txt
> Use this file to discover all available pages before exploring further.

# X (Twitter) Telegram bot to get tweets in a chat

> Get each new tweet from an X (Twitter) account or search in Telegram. Pick posts, replies or every event, then press Start in @XquikBot. See the steps.

> For the complete documentation index, see [llms.txt](https://docs.xquik.com/llms.txt).

@XquikBot sends each new X (Twitter) post from your monitors to a Telegram chat. You run no server and write no code. This guide sets it up from the dashboard or the API.




New to Xquik? [Create an account](https://dashboard.xquik.com/signup?ref=docs-telegram-bot) before the steps below.

## What arrives in Telegram

An account monitor checks 1 X account every second. A keyword monitor does the same for a search, a hashtag or a mention. Each match arrives as a message from @XquikBot.

* The message shows the account and the event in bold.
* It shows the post's text or the profile change, and a link.
* With `tweet.media` on, a post with media arrives as 1 alert.
* Alerts that wait together come as 1 digest.
* A busy chat gets 5 quick messages, then 1 every 30 seconds.
* Only the first message of a minute rings. The rest arrive silently.




@XquikBot works in private chats. It answers in English, Spanish, Turkish, Japanese, Korean or Chinese, by your Telegram language. Other languages get English.

## Set it up in the dashboard

**1. Add a monitor**

Open [account monitors](https://dashboard.xquik.com/en/monitors/accounts) and press Add Account Monitor. Enter the X username. For a search or hashtag, use [keyword monitors](https://dashboard.xquik.com/en/monitors/keywords) instead.

**2. Connect Telegram**

Open [webhooks](https://dashboard.xquik.com/en/monitors/webhooks) and press Connect Telegram. Pick what the chat gets, from "New posts" to "Everything".

**3. Press Start**

Press Open Telegram, then Start in @XquikBot. The bot answers "Connected." and alerts start.




A link works once, within 15 minutes. Make a new one if it expires. Connect again anytime to change what the chat gets.

## Set it up with the API

Create the monitor first.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/bash.json","/languages/csharp.json","/languages/go.json","/languages/java.json","/languages/javascript.json","/languages/kotlin.json","/languages/php.json","/languages/python.json","/languages/ruby.json","/languages/typescript.json"]}}
curl -X POST https://xquik.com/api/v1/monitors \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "NASA",
    "eventTypes": ["tweet.new", "tweet.reply"]
  }' | jq
```

Then ask for a Telegram link and open it.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/bash.json","/languages/csharp.json","/languages/go.json","/languages/java.json","/languages/javascript.json","/languages/kotlin.json","/languages/php.json","/languages/python.json","/languages/ruby.json","/languages/typescript.json"]}}
curl -X POST https://xquik.com/api/v1/webhooks/telegram \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"eventTypes": ["tweet.new", "tweet.reply"]}' \
  | jq -r '.url'
```

The link looks like `https://t.me/XquikBot?start=...`. Omit `eventTypes` to get new posts only. [Connect Telegram](https://docs.xquik.com/api-reference/webhooks/telegram.md) lists every field.

## Control alerts from the chat

| Command | What it does |
| - | - |
| `/stop` | Pauses alerts to this chat. |
| `/status` | Shows whether alerts are on. |




A new link turns alerts on again. The chat shows in your webhook list as `telegram:<chat ID>`. Deliveries, retries, resume and test deliveries work as for any webhook.

## Price

Connecting a chat and its messages cost no credits. Each active monitor costs 30 credits per hour, or 720 credits per day. The USD 20 plan includes 140,000 credits a month. That keeps 6 monitors on all month.




Pause a monitor to stop its hourly credits. Creating or resuming one needs at least 30 credits.

## Send the same alerts to Discord or Slack

A Discord channel webhook or a Slack incoming webhook URL gets the same alerts. Add it on the webhooks page.

> [card] [Discord alerts](https://docs.xquik.com/guides/twitter-discord-bot.md)
>
> Post each new tweet in a Discord channel.

> [card] [Connect Telegram API](https://docs.xquik.com/api-reference/webhooks/telegram.md)
>
> Ask for a Telegram link from code.

> [card] [Keyword monitors](https://docs.xquik.com/api-reference/monitors/create-keyword.md)
>
> Watch a search, a hashtag or a mention.

> [card] [Monitor billing](https://docs.xquik.com/guides/billing.md)
>
> Plan credits for each active monitor.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.