Callback Queries

Complete reference of inline button callback handlers

Callback Queries

This page documents all inline button callback handlers in Alita Robot.

Overview

• Total Callbacks: 26
• Modules with Callbacks: 18

Callback Data Format

Callbacks use a versioned codec with URL-encoded fields:

<namespace>|v1|<url-encoded-fields>

For example: restrict|v1|a=ban&uid=123456789 routes to the restrict namespace handler.

When the payload has no fields, _ is used as placeholder: helpq|v1|_.

Maximum length: 64 bytes (Telegram’s callback_data limit).

Strict Decoding

Handlers accept only the versioned format above. Malformed payloads, unsupported versions, and legacy unversioned dot-notation payloads are rejected.

All Callbacks

Callbacks by Module

Backup

backup

• Handler: backupCallbackHandler
• Source: backup.go

Handles backup import/export operations via inline buttons.

Bans

restrict

• Handler: restrictButtonHandler
• Source: bans.go

unrestrict

• Handler: unrestrictButtonHandler
• Source: bans.go

Blacklists

rmAllBlacklist

• Handler: buttonHandler
• Source: blacklists.go

Bot Updates

anon_admin

• Handler: verifyAnonymousAdmin
• Source: bot_updates.go

Handles anonymous admin verification callbacks for channel messages.

AntiRaid

antiraid

• Handler: callbackHandler
• Source: antiraid.go

Handles anti-raid mode toggle callbacks (enable/disable raid protection).

Approvals

rmAllApprovals

• Handler: unapproveAllCallback
• Source: approvals.go

Handles confirmation callback for removing all approved users.

Captcha

captcha_refresh

• Handler: captchaRefreshCallback
• Source: captcha.go

captcha_verify

• Handler: captchaVerifyCallback
• Source: captcha.go

Connections

connbtns

• Handler: connectionButtons
• Source: connections.go

Filters

filters_overwrite

• Handler: filterOverWriteHandler
• Source: filters.go

rmAllFilters

• Handler: filtersButtonHandler
• Source: filters.go

Formatting

formatting

• Handler: formattingHandler
• Source: formatting.go

Greetings

join_request

• Handler: joinRequestHandler
• Source: greetings.go

Help

about

• Handler: about
• Source: help.go

configuration

• Handler: botConfig
• Source: help.go

helpq

• Handler: helpButtonHandler
• Source: help.go

Languages

change_language

• Handler: langBtnHandler
• Source: language.go

Notes

notes.overwrite

• Handler: noteOverWriteHandler
• Source: notes.go

rmAllNotes

• Handler: notesButtonHandler
• Source: notes.go

Pins

unpinallbtn

• Handler: unpinallCallback
• Source: pins.go

Purges

deleteMsg

• Handler: deleteButtonHandler
• Source: purges.go

Reactions

reactions_help

• Handler: reactionsHelpHandler
• Source: reactions.go

Displays help information for reaction commands.

Reports

report

• Handler: markResolvedButtonHandler
• Source: reports.go

Warns

rmAllChatWarns

• Handler: warnsButtonHandler
• Source: warns.go

rmWarn

• Handler: rmWarnButton
• Source: warns.go

Code Example

Encoding and Decoding Callback Data

// Encode callback data
data, err := callbackcodec.Encode("restrict", map[string]string{
    "a":   "ban",
    "uid": "123456789",
})
// -> "restrict|v1|a=ban&uid=123456789"

// Empty payload
data, err := callbackcodec.Encode("helpq", map[string]string{})
// -> "helpq|v1|_"

// Decode callback data
decoded, err := callbackcodec.Decode("restrict|v1|a=ban&uid=123456789")
namespace := decoded.Namespace  // "restrict"
action, _ := decoded.Field("a") // "ban"
uid, _ := decoded.Field("uid")  // "123456789"

EncodeOrFallback

data := callbackcodec.EncodeOrFallback("restrict", map[string]string{
    "a": "ban",
}, "fallback_data")

Encodes callback data with graceful fallback. If encoding fails, returns the fallback string instead of an error.

Registering a Callback Handler

dispatcher.AddHandler(handlers.NewCallback(
    callbackquery.Prefix("restrict"),
    myModule.restrictHandler,
))