Recipes
Recipes are pre-built, parameterized building blocks for common bot patterns — guards, confirmations, pagination, retries, broadcasts. Each takes named parameters and provides named handler blocks you fill in.
The recipe insertion palette offers preset templates — pre-filled calls with sensible defaults — so you can drop in a recipe and edit only what differs. The editor also detects common verbose patterns and suggests the equivalent recipe. For example, if you write send.answer_callback(...) immediately followed by edit.text(...), the editor offers to replace the pair with a single telegram.answerAndEditOrigin call.
guard.adminOnly() {
body { send.text("Secret admin command ran.") }
onDeny { send.text("🚫 Admins only.") }
}
A recipe's handlers (body, onDeny, on_select, …) are written as blocks inside the call. Parameters with ! are required.
Guards
Gate a body so it runs only when a condition holds; otherwise the deny handler runs.
| Recipe | Signature | Handlers |
|---|---|---|
guard.adminOnly() | — | body, onDeny |
guard.groupOnly() | — | body, onDeny |
guard.privateChatOnly() | — | body, onDeny |
guard.subscribedOnly() | — | body, onDeny |
guard.callbackPayloadMatches(pattern!) | pattern: string | body, onDeny |
flow secret on command "/secret" {
guard.adminOnly() {
body { send.text("🔐 The launch code is 1234.") }
onDeny { send.text("🚫 You can't run this.") }
}
}
Flow helpers
| Recipe | Signature | Handlers |
|---|---|---|
flow.confirm(prompt!, yesLabel, noLabel, timeout) | a yes/no dialog | on_confirm, on_cancel |
flow.paginate(items!, page_size, header, doneLabel, timeout) | a paginated list | on_select, on_done |
flow.rateLimit(key!, max!) | a shared counter gate | body, on_limited |
flow.validateInput(prompt!, validatorExpr!, errorPrompt, max_retries, timeout, localName) | ask + validate with retries | on_valid, on_exhausted |
flow delete_all on command "/wipe" {
flow.confirm(prompt: "Delete everything? This can't be undone.", yesLabel: "Yes, delete", noLabel: "Cancel", timeout: "60s") {
on_confirm {
set { user.items = [] }
send.text("🗑 All items deleted.")
}
on_cancel { send.text("Cancelled.") }
}
}
flow set_age on command "/age" {
flow.validateInput(prompt: "How old are you?", validatorExpr: "types.int(value) >= 13", errorPrompt: "Please enter a number 13 or older.", max_retries: 3, timeout: "120s", localName: "age") {
on_valid { send.text(`Thanks! You're ${age}.`) }
on_exhausted { send.text("Too many invalid tries — start over with /age.") }
}
}
HTTP
| Recipe | Signature | Handlers |
|---|---|---|
http.retry(url!, method, body, headers, max_attempts, backoff, localName) | request with backoff | onSuccess, onFailed |
http.retry(url: "https://api.example.com/data", method: "GET", max_attempts: 3, backoff: "2s", localName: "res") {
onSuccess { send.text(`✅ ${res.status_code}`) }
onFailed { send.text("❌ Still failing after retries.") }
}
Telegram helpers
| Recipe | Signature | Notes |
|---|---|---|
telegram.broadcastMessage(text!) | broadcast text to the audience (paced) | — |
telegram.broadcastMedia() | broadcast a photo/video/document | — |
telegram.broadcastFlow() | run a subflow per audience member | — |
telegram.statusMessage(text!) | send a status message, capture its ref for editing | — |
telegram.safeEdit(text!, messageRef, fallbackSend) | edit a message, fall back to sending if it fails | — |
telegram.replyAndAutoDelete(text!, ttl) | reply, then auto-delete after a delay | — |
telegram.answerAndEditOrigin(newText!, callbackText) | answer a callback and edit its origin message | — |
flow loading on command "/work" {
telegram.statusMessage(text: "⏳ Working…")
// … do the work …
telegram.safeEdit(text: "✅ Done!", fallbackSend: true)
}