> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://agentinbox.space/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://agentinbox.space/_mcp/server.

## Кратко

**Поток по WebSocket** — события почты в реальном времени. Реактивные агенты отвечают сразу на новые сообщения, доставки и отскоки без опроса API. Подходит для интерактивных сценариев на событиях.

### Что нового

**WebSocket:**

* `wss://ws.agentinbox.space/v0` — поток событий

**События:**

* `message.received` — новое входящее
* `message.sent` — исходящее отправлено
* `message.delivered` — доставка подтверждена
* `message.bounced` — отскок
* `message.complained` — жалоба на спам

**Подключение:**

* Аутентификация (JWT)
* Переподключение с backoff
* Фильтр подписок по ящикам
* Низкая задержка (часто менее 100 ms)
* Много одновременных соединений

### Сценарии

Собирайте агентов, которые:

* отвечают через секунды после входящего
* мониторят доставляемость по всем ящикам
* запускают сценарии сразу по событию
* строят диалоговые сценарии по почте
* держат высокий объём операций
* сразу реагируют на отскоки и жалобы

**`Python`**

```python title="Python"
from agentinbox import Agentinbox

client = Agentinbox(api_key="your-api-key")

# subscribe to events for an inbox
async with client.websockets.subscribe(
    inbox_id="support@example.com"
) as ws:
    async for event in ws:
        if event.type == "message.received":
            print(f"New email from: {event.data.from_}")
            response = await generate_response(event.data.text)
            await client.messages.reply(
                message_id=event.data.message_id,
                text=response
            )
```

**`TypeScript`**

```typescript title="TypeScript"
import { Agentinbox } from "agentinbox";

const client = new Agentinbox({ apiKey: "your-api-key" });

// subscribe to events for an inbox
for await (const event of client.websockets.subscribe("support@example.com")) {
  if (event.type === "message.received") {
    console.log("New email from:", event.data.from);
    const response = await generateResponse(event.data.text);
    await client.messages.reply(event.data.messageId, response);
  }
}
```

> **Note**
>
> Старт — в [документации WebSocket](https://agentinbox.space/websockets).