Publishing from a webhook to Telegram
One POST to the webhook — and the post is in your Telegram channel.
Telegram The problem
You need to publish to a Telegram channel from your service — on an event, on a schedule, from a script. Standing up and maintaining a bot on the Telegram Bot API just for that is unnecessary infrastructure.
How Crosslybot solves it
Crosslybot accepts a post via webhook: you send a POST with text and media — the post goes to the Telegram channel. Idempotency by key, an HMAC signature, automatic retry.
Crosslybot accepts posts via webhook and publishes them to a Telegram channel. You send a single POST with text and media — the post goes to the channel, without standing up your own bot on the Telegram Bot API.
Idempotency by key protects against duplicates, an HMAC signature with timestamp verification against forgery, and failed deliveries are retried automatically. The sandbox endpoint lets you validate the payload without real publishing. It fits backends, scripts, cron and AI agents.
How to set up
Create a webhook endpoint
In the Crosslybot dashboard, create an incoming webhook and attach it to a project with a Telegram target.
Grab the token
Copy the Bearer token and, if needed, the endpoint's HMAC secret.
Send a POST
Send JSON with text, media and idempotency_key. The sandbox endpoint validates the payload without publishing.
Wire it into your pipeline
Call the webhook from your backend, cron, CI/CD or an AI agent.
What's inside
No bot on the Bot API
No need to stand up and maintain your own Telegram bot — publishing goes through the Crosslybot webhook.
Idempotency and retry
A repeated POST with the same key doesn't create a duplicate; failed deliveries are retried automatically.
Endpoint protection
A Bearer token, an optional HMAC signature with timestamp verification and an IP allowlist.
Result
Publishing to Telegram from any code — with a single POST, without maintaining a platform API.
FAQ
Can I publish to a specific channel?
Yes. The endpoint is attached to a project; the payload can specify targets if there are several targets.
What comes in the payload?
Text, media, buttons, entities — the format is symmetric to how Telegram delivers messages.
How do I test?
The /v1/sandbox/test endpoint validates the payload without real publishing — handy for CI/CD.
What plan is needed?
Webhook IN is available on the Pro plan and above.
Ready to try?
Connect the bot in 2 minutes. Free plan — no cards, no signup.
