POST /telegram/webhook
Purpose
Section titled “Purpose”Receive Telegram updates for:
/start <token>account linking- contact-share verification updates
/dev_*developer management commands
Auth requirement
Section titled “Auth requirement”Request must include header:
X-Telegram-Bot-Api-Secret-Token: <configured-secret>Request schema
Section titled “Request schema”Telegram Update JSON payload.
Response schema
Section titled “Response schema”200 OK
{ "ok": true }Error cases
Section titled “Error cases”401 unauthorized: missing/invalid Telegram webhook secret.400 invalid_request: malformed update payload.
Curl example
Section titled “Curl example”curl -X POST "$GATEWAY_BASE_URL/telegram/webhook" \ -H "X-Telegram-Bot-Api-Secret-Token: $TELEGRAM_WEBHOOK_SECRET" \ -H "Content-Type: application/json" \ -d '{"update_id":1}'Notes and limits
Section titled “Notes and limits”- This endpoint is for Telegram platform traffic, not third-party app backends.
- End-user messages are branded with API key label when context is available.