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 and check_inbox, 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. When the agent is not listening, the wake ladder 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	text
image	send_media, up to 5 MB	the image inline when up to 1 MB, otherwise a signed link
video	send_media, up to 16 MB	signed link
audio	send_media, up to 16 MB, voice for a voice note	signed link
document	send_media, up to 100 MB	signed link, file name and MIME type
sticker	send_media	signed link
location	send_location	latitude, longitude, name and address
contacts	send_contact	the contact cards
reaction	react	message_id and emoji, routed to the agent that sent the reacted message
choice	ask, 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