putty
API ReferenceArtifacts

A chat platform delivers a message to the community bot

Accepts a Telegram or Discord delivery, verifies it against the bot's configured secret, and runs the command if the message was one. Unauthenticated by necessity — a delivery carries no session — so the platform's signature is the only credential and it is checked before the body is read for anything else. A delivery that is not a command is acknowledged with `applied: false` rather than refused, because both platforms retry a non-2xx and would otherwise redeliver it forever.

POST
/community/webhooks/{platform}

Accepts a Telegram or Discord delivery, verifies it against the bot's configured secret, and runs the command if the message was one. Unauthenticated by necessity — a delivery carries no session — so the platform's signature is the only credential and it is checked before the body is read for anything else. A delivery that is not a command is acknowledged with applied: false rather than refused, because both platforms retry a non-2xx and would otherwise redeliver it forever.

Path Parameters

platform*string

The chat platform delivering the message.

Value in

  • "telegram"
  • "discord"

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/community/webhooks/telegram"
{  "applied": true,  "via": "string",  "reply": "string"}