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

# Inbox

> Where owner messages wait for an agent.

Every message from the owner lands first in a durable inbox kept for each agent. Agents pull from it with [get\_messages](https://docs.zapbip.com/mcp-reference/get-messages.md) and [check\_inbox](https://docs.zapbip.com/mcp-reference/check-inbox.md), or receive it as the answer of a waiting call.

Every owner message reaches the agent as `sender: "owner"` and `verified: true`, because clients refuse instructions from an unverified sender. The exception is a forwarded message: it carries `forwarded: true` and `verified: false`, and it never answers an open question.

An owner message is routed to one agent by [the routing rules](https://docs.zapbip.com/concepts/routing.md). When the agent is not listening, [the wake ladder](https://docs.zapbip.com/concepts/wake-ladder.md) decides how it is reached, and the message waits in the inbox meanwhile.

## Message kinds

| Kind | Agent to owner | Owner to agent |
| - | - | - |
| `text` | [send\_message](https://docs.zapbip.com/mcp-reference/send-message.md) | text |
| `image` | [send\_media](https://docs.zapbip.com/mcp-reference/send-media.md), up to 5 MB | the image inline when up to 1 MB, otherwise a signed link |
| `video` | [send\_media](https://docs.zapbip.com/mcp-reference/send-media.md), up to 16 MB | signed link |
| `audio` | [send\_media](https://docs.zapbip.com/mcp-reference/send-media.md), up to 16 MB, `voice` for a voice note | signed link |
| `document` | [send\_media](https://docs.zapbip.com/mcp-reference/send-media.md), up to 100 MB | signed link, file name and MIME type |
| `sticker` | [send\_media](https://docs.zapbip.com/mcp-reference/send-media.md) | signed link |
| `location` | [send\_location](https://docs.zapbip.com/mcp-reference/send-location.md) | latitude, longitude, name and address |
| `contacts` | [send\_contact](https://docs.zapbip.com/mcp-reference/send-contact.md) | the contact cards |
| `reaction` | [react](https://docs.zapbip.com/mcp-reference/react.md) | `message_id` and `emoji`, routed to the agent that sent the reacted message |
| `choice` | [ask](https://docs.zapbip.com/mcp-reference/ask.md), up to 3 options as buttons and 4 to 10 as a list | `option_id`, `title` and optional `description` |
| quote | `reply_to` on every send | `reply_to`, routed to the agent that sent the quoted message |


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