How do I test Telegram webhooks without deploying anything?

Create a free endpoint on webhooks.cc — sign in with GitHub or Google, or use a guest endpoint without an account — then configure it as your webhook URL: Bot API → call setWebhook with your endpoint URL. Every delivery shows up live in the dashboard with full headers, body, and query parameters. To hit a local server, run whk tunnel and the CLI forwards each webhook to localhost.

Can I send a sample Telegram webhook without a Telegram account?

Yes. webhooks.cc ships Telegram templates (message, callback_query, edited_message) with realistic payloads and correctly computed signature headers. Send them from the dashboard, the SDK, or the MCP server to exercise your handler end-to-end.

How do I verify Telegram webhook signatures?

Telegram signs each delivery with the x-telegram-bot-api-secret-token header using Shared token comparison. webhooks.cc verifies these signatures for you: add your secret token to the endpoint and every captured request is marked valid or invalid in the dashboard.

Is the Telegram webhook tester free?

Yes. A free account gets you persistent endpoints, 50 requests per day, 7-day retention, and full CLI, SDK, and MCP access — no credit card. You can also try a guest endpoint without an account: up to 25 requests for 12 hours.

Test Telegram webhooks

Telegram bots receive updates — messages, callback queries, edits — via a webhook URL registered with setWebhook. Capture them on a free webhooks.cc endpoint to see exactly what Telegram sends — or fire realistic, correctly signed sample payloads at your own handler without touching a production account.

Start free:

No credit card · 50 requests/day free · or get a guest URL without an account

Prefer a walkthrough? Read the local webhook testing guide.

How to test Telegram webhooks

1
Create a webhook endpoint
Sign in free with GitHub or Google to create a persistent endpoint — or grab an instant guest URL at webhooks.cc/go without an account.
2
Point Telegram at your URL
Paste the endpoint URL into Telegram: Bot API → call setWebhook with your endpoint URL.
3
Inspect what arrives
Each delivery appears live in the dashboard with method, headers, body, query parameters, and source IP.
4
Forward to localhost or assert in CI
Run whk tunnel <port> to forward webhooks to a local server, or use the TypeScript SDK to wait for and assert on deliveries in tests.

Telegram webhook signature

Signature header	x-telegram-bot-api-secret-token
Algorithm	Shared token comparison
Verification in webhooks.cc	Supported — add your secret token and every request is checked automatically

New to signature verification? Read the webhook signature verification guide.

Send sample Telegram events

These Telegram templates ship with realistic payloads and valid signature headers. Send them from the dashboard's Send button, the SDK, or your AI agent via MCP.

messagecallback_queryedited_message

# Send a signed Telegram sample with the SDK
await client.endpoints.sendTemplate( slug, {
  provider: "telegram",
  template: "message",
  secret: "your-test-secret",
});

Everything in one place

Live dashboard — see deliveries the moment they arrive
Forward to localhost with whk tunnel
Replay any captured request to any URL
Mock responses with custom status, headers, and body
TypeScript SDK assertions for CI
MCP server for AI coding agents

Telegram webhook questions

Your Telegram webhook URL is seconds away

No credit card · or try without an account

Test Telegram webhooks

How to test Telegram webhooks

Create a webhook endpoint

Point Telegram at your URL

Inspect what arrives

Forward to localhost or assert in CI

Telegram webhook signature

Send sample Telegram events

Everything in one place

Telegram webhook questions

More providers

Twilio webhooks

Slack webhooks

SendGrid webhooks

Your Telegram webhook URL is seconds away