Skip to content

Receive Telegram topic replies ​

Called by Telegram. Requires the X-Telegram-Bot-Api-Secret-Token header that Managani set with setWebhook. Text, photo, and supported file replies in a chat topic are posted to the visitor; other updates are ignored. Handled updates always return 200.

Request preparation ​

Send a POST request to /integrations/telegram/webhook/{botId} on the appropriate server. Check the API overview for base URL guidance and the server information in the interactive reference. Replace path placeholders with identifiers from the intended account or site; a similarly named record in another workspace is not interchangeable.

The declared request parameters are:

  • botId (path, required): Use the type and constraints shown in the parameter reference.
  • X-Telegram-Bot-Api-Secret-Token (header, required): Use the type and constraints shown in the parameter reference.

No request body is declared in the current specification. Check the route and any documented parameters before sending the request rather than adding an arbitrary JSON payload.

Authentication and scope ​

The specification lists these security alternatives: BearerAuth, AccessToken. Read any operation-specific restrictions as well: browser-session, account-role, and signed-user requirements may impose additional conditions. See authentication before choosing a credential.

Keep credentials in the appropriate private configuration and remove secrets from shared logs. Confirm the target resource belongs to the intended workflow before issuing a request. Authentication alone should not be treated as confirmation that a supplied account, site, or customer identifier is correct.

Response handling ​

The documented responses for Receive Telegram topic replies are:

  • 200: Processed or ignored
  • 401: Invalid secret token
  • 404: No connected project uses this bot

Exercise this operation with controlled test data before enabling it in an automated workflow. Validate the request against the schema and inspect the response before updating local state. Do not assume that a successful response means background processing has finished; follow any documented status or follow-up operation when the action queues additional work.

If a connection fails after submission, investigate the current server state before repeating an action whose outcome is uncertain. When requesting support, retain the method, route, response status, and sanitized error message. The interactive reference below provides the detailed schemas and examples for this specific operation.

Receive Telegram topic replies​

POST
/integrations/telegram/webhook/{botId}

Called by Telegram. Requires the X-Telegram-Bot-Api-Secret-Token header that Managani set with setWebhook. Text, photo, and supported file replies in a chat topic are posted to the visitor; other updates are ignored. Handled updates always return 200.

Authorizations​

BearerAuth

JWT token from login

Type
HTTP (bearer)
or
AccessToken

Personal access token. Value: Token <your-token>

Type
API Key (header: Authorization)

Parameters​

Header Parameters

X-Telegram-Bot-Api-Secret-Token*
Type
string
Required

Path Parameters

botId*
Type
string
Required

Responses​

Processed or ignored

Playground​

Authorization
Headers
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI