> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Callback Payload Store Protocol • AI Agent SDK

> CallbackPayloadStoreProtocol: Protocol for durable, reference-addressable interactive callback values.

# CallbackPayloadStoreProtocol

> Defined in the [**protocols**](https://praison.ai/docs/sdk/reference/praisonaiagents/modules/protocols.md) module.

AI Agent

Protocol for durable, reference-addressable interactive callback values.

Some channels hard-cap inline callback payloads (e.g. Telegram's 64-byte
inline-callback limit). When an interactive `reply`/`select` value is
too long to travel inline, the framework persists the canonical value under
a short, collision-resistant reference and emits that reference in the
callback instead. On click the registry resolves the reference back to the
exact value — so long option values (URLs, file paths, free-text choices)
round-trip losslessly on every channel.

This mirrors :class:`ApprovalStoreProtocol`: the contract lives in core so
any backend and any channel can interoperate; core ships a bounded
in-memory default (:class:`InMemoryCallbackPayloadStore`) and heavier
durable backends (e.g. SQLite) live in the `praisonai-bot` runtime.

Behaviour is unchanged when no store is configured — values that fit inline
are always sent inline, so this is additive and backward compatible.

## Methods

> [card] [put()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/CallbackPayloadStoreProtocol-put.md)
>
> Persist `value` under `ref` until `expires_at` (epoch seconds).

> [card] [get()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/CallbackPayloadStoreProtocol-get.md)
>
> Return the value stored for `ref`, or `None` if unknown/expired.

## Source

> [card] [View on GitHub](https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai-agents/praisonaiagents/bots/protocols.py#L1596)
>
> `praisonaiagents/bots/protocols.py` at line 1596


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.