Актуальные обновления API и SDK. Подписка по RSS · Поддержка

July 20, 2025

Кратко

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

Что нового

WebSocket:

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

События:

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

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

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

Сценарии

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

  • отвечают через секунды после входящего
  • мониторят доставляемость по всем ящикам
  • запускают сценарии сразу по событию
  • строят диалоговые сценарии по почте
  • держат высокий объём операций
  • сразу реагируют на отскоки и жалобы
1from agentinbox import Agentinbox
2
3client = Agentinbox(api_key="your-api-key")
4
5# subscribe to events for an inbox
6async with client.websockets.subscribe(
7 inbox_id="support@example.com"
8) as ws:
9 async for event in ws:
10 if event.type == "message.received":
11 print(f"New email from: {event.data.from_}")
12 response = await generate_response(event.data.text)
13 await client.messages.reply(
14 message_id=event.data.message_id,
15 text=response
16 )