Send X monitor alerts to a Telegram chat with a bot

{
  "url": "https://t.me/XquikBot?start=Q2hhdExpbmtDb2RlRXhhbXBsZTAx",
  "expiresAt": "2025-01-15T12:15:00.000Z"
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "telegram_unavailable",
  "message": "Telegram alerts are off right now. Try again later."
}

POST

webhooks

Send X monitor alerts to a Telegram chat with a bot

curl --request POST \
  --url https://xquik.com/api/v1/webhooks/telegram \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "eventTypes": [
    "<string>"
  ]
}
'

import requests

url = "https://xquik.com/api/v1/webhooks/telegram"

payload = { "eventTypes": ["<string>"] }
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({eventTypes: ['<string>']})
};

fetch('https://xquik.com/api/v1/webhooks/telegram', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/webhooks/telegram"

	payload := strings.NewReader("{\n  \"eventTypes\": [\n    \"<string>\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "url": "<string>",
  "expiresAt": "<string>"
}

Free. Connecting a chat and its messages cost no credits.

Get your monitor events in Telegram with no server of your own. The call returns a link to @XquikBot. Open it and press Start. The chat is connected.

How it works

Call this endpoint. It returns a url like https://t.me/XquikBot?start=....
Open the link on a phone or computer with Telegram, then press Start.
@XquikBot answers “Connected.” Each new event of your monitors arrives as a message: the account and event type in bold, the post’s text or the profile change, and a link to the post.

A link works once, within 15 minutes. Make a new one if it expires.
The chat appears in List webhooks with the URL telegram:<chat ID>. Deliveries, retries, Resume and Test webhook work as for any webhook.
In the chat, send /stop to pause alerts and /status to check them. A new link turns them on again.
When Telegram asks Xquik to slow down, the retry waits as long as it asks.
@XquikBot works in private chats. It answers in English, Turkish or Spanish, by your Telegram language.

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'

const response = await fetch("https://xquik.com/api/v1/webhooks/telegram", {
  method: "POST",
  headers: {
    "x-api-key": "xq_YOUR_KEY_HERE",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ eventTypes: ["tweet.new", "tweet.reply"] }),
});
const link = await response.json();
console.log(`Open ${link.url} before ${link.expiresAt}`);

import requests

response = requests.post(
    "https://xquik.com/api/v1/webhooks/telegram",
    headers={"x-api-key": "xq_YOUR_KEY_HERE"},
    json={"eventTypes": ["tweet.new", "tweet.reply"]},
)
link = response.json()
print(f"Open {link['url']} before {link['expiresAt']}")

Body

string[]

The event types the chat gets, like tweet.new or profile.bio.changed. Omit the body or this field to get every event type.

Headers

string

required

Your API key.

Response

201 Created

{
  "url": "https://t.me/XquikBot?start=Q2hhdExpbmtDb2RlRXhhbXBsZTAx",
  "expiresAt": "2025-01-15T12:15:00.000Z"
}

string

Opens @XquikBot with the link’s code. Open it and press Start.

string

When the link stops working, 15 minutes after it was made.

400 Invalid input

{
  "error": "invalid_input",
  "message": "Pick at least 1 valid event type, like tweet.new."
}

An event type is unknown. Use the types the monitor endpoints list.

401 Unauthenticated

{ "error": "unauthenticated" }

Missing or invalid API key. Check the x-api-key header value.

503 Telegram unavailable

{
  "error": "telegram_unavailable",
  "message": "Telegram alerts are off right now. Try again later."
}

Telegram delivery is off for now. Try again later.

Related. Webhooks overview · List webhooks · Webhook deliveries

{
  "url": "https://t.me/XquikBot?start=Q2hhdExpbmtDb2RlRXhhbXBsZTAx",
  "expiresAt": "2025-01-15T12:15:00.000Z"
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "telegram_unavailable",
  "message": "Telegram alerts are off right now. Try again later."
}

Send X monitor alerts to a Telegram chat with a bot

curl --request POST \
  --url https://xquik.com/api/v1/webhooks/telegram \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "eventTypes": [
    "<string>"
  ]
}
'

import requests

url = "https://xquik.com/api/v1/webhooks/telegram"

payload = { "eventTypes": ["<string>"] }
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({eventTypes: ['<string>']})
};

fetch('https://xquik.com/api/v1/webhooks/telegram', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/webhooks/telegram"

	payload := strings.NewReader("{\n  \"eventTypes\": [\n    \"<string>\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "url": "<string>",
  "expiresAt": "<string>"
}

Overview

X API

X write

Trends

Radar

Account

API keys

Guest wallets

Credits

X accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

Send X monitor alerts to a Telegram chat with a bot

How it works

Body

Headers

Response

201 Created

400 Invalid input

401 Unauthenticated

503 Telegram unavailable

​How it works

​Body

​Headers

​Response

​201 Created

​400 Invalid input

​401 Unauthenticated

​503 Telegram unavailable

How it works

Body

Headers

Response

201 Created

400 Invalid input

401 Unauthenticated

503 Telegram unavailable