Trigger Metronomes from inbound Telegram messages

POST/v1/metronomes/telegram/inbound

Webhook endpoint for Telegram Bot API updates or normalized Telegram message payloads. Published workflows with Telegram trigger nodes match on their configured slash command and optional sender, chat, and message filters. If METRONOME_TELEGRAM_WEBHOOK_SECRET is configured, callers must provide the same value in the x-computer-agents-webhook-secret header or secret query parameter.

How to call this endpoint

Every ACP API request uses bearer authentication. The examples here show the actual request path, auth header, and body shape that the platform expects.

Path, query, and header parameters

These parameters control which ACP object the endpoint acts on and how the request is processed.

Path parameters
None.
Query parameters
NameLocationTypeRequiredDescription
secretquerystringNo
Header parameters
NameLocationTypeRequiredDescription
x-computer-agents-webhook-secretheaderstringNo

Body schema

Content type: application/json · Required

FieldTypeRequiredDescription
messageobjectNoMessage text.
edited_messageobjectNo
channel_postobjectNo
textstringNo
captionstringNo
chatIdstringNo
fromUsernamestringNo

What the API returns

Each response code below includes the documented payload shape for the ACP API.

200Inbound Telegram message processedapplication/json
FieldTypeRequiredDescription
successbooleanNoWhether the request succeeded.
objectstringNo
matched_countintegerNo
dataobject[]No
400Invalid inbound Telegram payload
None.
401Invalid webhook secret
None.
Trigger Metronomes from inbound Telegram messages
Loading...
Response 200
Loading...
See the ACP quickstart and SDK flow