Журнал изменений Agent Inbox

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

March 18, 2026

Кратко

API-ключи с областью inbox позволяют выдавать учётные данные только для одного ящика. Агенты и интеграции получают минимально необходимый доступ; при компрометации ключа зона риска меньше.

Что нового

Новые endpoints:

GET /v0/inboxes/:inbox_id/api-keys — список ключей, привязанных к ящику
POST /v0/inboxes/:inbox_id/api-keys — создать ключ для ящика
DELETE /v0/inboxes/:inbox_id/api-keys/:api_key — удалить такой ключ

Обновлённые типы:

В ApiKey и CreateApiKeyResponse добавлено необязательное поле inbox_id, если ключ ограничен ящиком

Сценарии

Собирайте системы, где:

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

1 from agentinbox import Agentinbox
2 
3 client = Agentinbox(api_key="your-api-key")
4 
5 # create an api key scoped to a single inbox
6 key = client.inboxes.api_keys.create(
7     inbox_id="user@example.com",
8     name="integration-key"
9 )
10 
11 print(key.api_key)

Подробнее об областях ключей — в справочнике API Keys.

December 22, 2025

Кратко

Вебхуки и события — получайте события почты и доменов по HTTP. Подписка на жизненный цикл сообщений (получено, отправлено, доставлено, отскок, жалоба, отклонение) и на верификацию домена. Проверка подписи через заголовки Svix, фильтрация по ящику или pod. Удобно для агентов, которым нужны надёжные асинхронные уведомления без постоянного WebSocket.

Что нового

События вебхуков:

message.received — новое входящее письмо
message.sent — исходящее отправлено
message.delivered — доставка подтверждена
message.bounced — отскок (тип и получатели)
message.complained — жалоба на спам
message.rejected — отклонение (например валидация)
domain.verified — домен успешно верифицирован

Доставка и проверка:

Заголовки в стиле Svix: svix-id, svix-signature, svix-timestamp
Фильтр по inbox или pod (до 10 на вебхук)
В полезной нагрузке: inbox_id, thread_id, message_id, метки времени и данные по типу события

Сценарии

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

реагируют на новые письма, отскоки и жалобы по HTTP
синхронизируют состояние с БД или очередью
запускают сценарии при верификации домена
проверяют подпись вебхука для безопасности

1 from agentinbox import Agentinbox
2 
3 client = Agentinbox(api_key="your-api-key")
4 
5 # in your webhook handler: verify signature and handle event
6 # (use Svix or the raw headers for verification)
7 def handle_webhook(request):
8     event_id = request.headers.get("svix-id")
9     signature = request.headers.get("svix-signature")
10     payload = request.json()
11     if payload.get("event_type") == "message.received":
12         message = payload.get("message")
13         # process new email
14     elif payload.get("event_type") == "domain.verified":
15         domain = payload.get("domain")
16         # domain is verified

Настройка и проверка вебхуков — в документации по вебхукам.

October 28, 2025

Кратко

Свои домены — добавляйте и верифицируйте домены для отправки и приёма почты. Проверка через DNS (TXT, CNAME, MX), выгрузка zone-файла, настройка доставки отчётов об отскоках и жалобах. Подходит агентам, которым нужна отправка с брендового домена и контроль доставляемости.

Что нового

Новые endpoints:

GET /domains — список доменов
GET /domains/{domain_id} — детали и записи для DNS
POST /domains — добавить домен
DELETE /domains/{domain_id} — удалить домен
GET /domains/{domain_id}/zone-file — скачать zone-файл
POST /domains/{domain_id}/verify — запустить проверку DNS

Возможности:

Верификация через TXT, CNAME, MX
Статусы: NOT_STARTED, PENDING, VERIFYING, VERIFIED, FAILED, INVALID
Статус по каждой записи (MISSING, INVALID, VALID)
Экспорт zone-файла для провайдера DNS
Опционально — доставка bounce/complaint по домену

Сценарии

Собирайте системы, где:

агенты отправляют с верифицированного домена
DNS настраивается централизованно, zone-файл импортируется у регистратора
онбординг или мониторинг завязаны на статус верификации
отскоки и жалобы настраиваются отдельно по доменам

1 from agentinbox import Agentinbox
2 
3 client = Agentinbox(api_key="your-api-key")
4 
5 # create a domain
6 domain = client.domains.create(
7     domain="mail.example.com",
8     feedback_enabled=True
9 )
10 
11 # get verification records and status
12 domain = client.domains.get(domain_id=domain.domain_id)
13 for record in domain.records:
14     print(f"{record.type} {record.name}: {record.status}")
15 
16 # trigger verification after updating DNS
17 client.domains.verify(domain_id=domain.domain_id)

Подробнее — в руководствах Свои домены и Управление доменами.

October 25, 2025

Кратко

API черновиков — составляйте и ведите черновики до отправки: создавать, обновлять, планировать время отправки и отправлять, когда готово. Подходит агентам, которые собирают ответ по шагам, держат тред ответов или откладывают отправку.

Что нового

Новые endpoints:

GET /drafts — список черновиков (с фильтрами)
GET /drafts/{draft_id} — получить черновик
POST /inboxes/{inbox_id}/drafts — создать в ящике
PATCH /inboxes/{inbox_id}/drafts/{draft_id} — обновить
POST /inboxes/{inbox_id}/drafts/{draft_id}/send — отправить
DELETE /inboxes/{inbox_id}/drafts/{draft_id} — удалить

Возможности черновиков:

Поля to, cc, bcc, тема, текст и HTML
Тред через in_reply_to и references
Отложенная отправка через send_at
Вложения и метки
Список и фильтры по ящику, меткам, времени

Сценарии

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

готовят многошаговые ответы перед отправкой
планируют фоллоу-апы
ставят исходящие в очередь и шлют пакетами
правят черновик по новому контексту
сохраняют корректные треды с in_reply_to

1 from agentinbox import Agentinbox
2 
3 client = Agentinbox(api_key="your-api-key")
4 
5 # create a draft in an inbox
6 draft = client.inboxes.drafts.create(
7     inbox_id="support@example.com",
8     to=["user@example.com"],
9     subject="Re: Your request",
10     text="We're looking into it.",
11     in_reply_to="<message-id@example.com>"
12 )
13 
14 # update the draft
15 client.inboxes.drafts.update(
16     inbox_id="support@example.com",
17     draft_id=draft.draft_id,
18     text="We've resolved your request."
19 )
20 
21 # send the draft
22 client.inboxes.drafts.send(
23     inbox_id="support@example.com",
24     draft_id=draft.draft_id
25 )

Подробнее — в разделе Черновики.

August 13, 2025

Кратко

Добавлены endpoints метрик — два новых способа смотреть доставляемость и работу агентов: отскоки, доставки, отклонения, жалобы с метками времени. Удобно для агентов, которые подстраивают поведение по фактическим метрикам.

Что нового

Новые endpoints:

GET /metrics — сводные метрики по всем ящикам
GET /inboxes/{inbox_id}/metrics — метрики по одному ящику

Что считается:

Отправка и доставка: sent, delivered, bounced, rejected
Ошибки: жалобы, спам-репорты
Временные ряды с детальными отметками времени

Сценарии

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

следят за долей отскоков в реальном времени
подбирают время отправки по истории
меняют поведение при падении доставляемости
останавливают кампании при порогах
используют умные повторы для попадания во «Входящие»

См. справочник Metrics API.

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)
Много одновременных соединений

Сценарии

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

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

1 from agentinbox import Agentinbox
2 
3 client = Agentinbox(api_key="your-api-key")
4 
5 # subscribe to events for an inbox
6 async 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             )

Старт — в документации WebSocket.

June 15, 2025

Кратко

Pods — рабочие области для команд в Agent Inbox: общие ящики, домены и ресурсы с гибким контролем. Удобно командам, которые строят мультиагентную почту и хотят порядок в ресурсах.

Что нового

Новые endpoints:

POST /pods — создать pod
GET /pods — список pod в организации
GET /pods/{pod_id} — детали pod
DELETE /pods/{pod_id} — удалить pod
POST /pods/{pod_id}/inboxes — ящик в pod
POST /pods/{pod_id}/domains — домен в pod
GET /pods/{pod_id}/threads — треды pod
GET /pods/{pod_id}/metrics — метрики pod

Возможности:

Общий доступ к ящикам в команде
Домены на уровне pod
Метрики и аналитика по pod
Иерархия ресурсов

Сценарии

Собирайте системы, где:

несколько агентов делят инфраструктуру почты
команды ведут ящики независимо
ресурсы сгруппированы по отделам или проектам
аналитика в разрезе рабочей области
учёт использования и биллинг по командам

1 from agentinbox import Agentinbox
2 
3 client = Agentinbox(api_key="your-api-key")
4 
5 # create a pod for your sales team
6 pod = client.pods.create(
7     name="Sales Team",
8     description="Shared resources for sales agents"
9 )
10 
11 # create an inbox in the pod
12 inbox = client.pods.inboxes.create(
13     pod_id=pod.pod_id,
14     inbox_id="sales@example.com"
15 )
16 
17 # list all pods
18 pods = client.pods.list()
19 for pod in pods.pods:
20     print(f"Pod: {pod.name} ({len(pod.inbox_ids)} inboxes)")

Подробнее — в разделе Pods.

Кратко

Что нового

События вебхуков:

message.received — новое входящее письмо
message.sent — исходящее отправлено
message.delivered — доставка подтверждена
message.bounced — отскок (тип и получатели)
message.complained — жалоба на спам
message.rejected — отклонение (например валидация)
domain.verified — домен успешно верифицирован

Доставка и проверка:

Заголовки в стиле Svix: svix-id, svix-signature, svix-timestamp
Фильтр по inbox или pod (до 10 на вебхук)
В полезной нагрузке: inbox_id, thread_id, message_id, метки времени и данные по типу события

Сценарии

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

реагируют на новые письма, отскоки и жалобы по HTTP
синхронизируют состояние с БД или очередью
запускают сценарии при верификации домена
проверяют подпись вебхука для безопасности

1 from agentinbox import Agentinbox
2 
3 client = Agentinbox(api_key="your-api-key")
4 
5 # in your webhook handler: verify signature and handle event
6 # (use Svix or the raw headers for verification)
7 def handle_webhook(request):
8     event_id = request.headers.get("svix-id")
9     signature = request.headers.get("svix-signature")
10     payload = request.json()
11     if payload.get("event_type") == "message.received":
12         message = payload.get("message")
13         # process new email
14     elif payload.get("event_type") == "domain.verified":
15         domain = payload.get("domain")
16         # domain is verified

Настройка и проверка вебхуков — в документации по вебхукам.

1	from agentinbox import Agentinbox
2
3	client = Agentinbox(api_key="your-api-key")
4
5	# create an api key scoped to a single inbox
6	key = client.inboxes.api_keys.create(
7	inbox_id="user@example.com",
8	name="integration-key"
9	)
10
11	print(key.api_key)

1	from agentinbox import Agentinbox
2
3	client = Agentinbox(api_key="your-api-key")
4
5	# in your webhook handler: verify signature and handle event
6	# (use Svix or the raw headers for verification)
7	def handle_webhook(request):
8	event_id = request.headers.get("svix-id")
9	signature = request.headers.get("svix-signature")
10	payload = request.json()
11	if payload.get("event_type") == "message.received":
12	message = payload.get("message")
13	# process new email
14	elif payload.get("event_type") == "domain.verified":
15	domain = payload.get("domain")
16	# domain is verified

1	from agentinbox import Agentinbox
2
3	client = Agentinbox(api_key="your-api-key")
4
5	# create a domain
6	domain = client.domains.create(
7	domain="mail.example.com",
8	feedback_enabled=True
9	)
10
11	# get verification records and status
12	domain = client.domains.get(domain_id=domain.domain_id)
13	for record in domain.records:
14	print(f"{record.type} {record.name}: {record.status}")
15
16	# trigger verification after updating DNS
17	client.domains.verify(domain_id=domain.domain_id)

1	from agentinbox import Agentinbox
2
3	client = Agentinbox(api_key="your-api-key")
4
5	# create a draft in an inbox
6	draft = client.inboxes.drafts.create(
7	inbox_id="support@example.com",
8	to=["user@example.com"],
9	subject="Re: Your request",
10	text="We're looking into it.",
11	in_reply_to="<message-id@example.com>"
12	)
13
14	# update the draft
15	client.inboxes.drafts.update(
16	inbox_id="support@example.com",
17	draft_id=draft.draft_id,
18	text="We've resolved your request."
19	)
20
21	# send the draft
22	client.inboxes.drafts.send(
23	inbox_id="support@example.com",
24	draft_id=draft.draft_id
25	)

1	from agentinbox import Agentinbox
2
3	client = Agentinbox(api_key="your-api-key")
4
5	# subscribe to events for an inbox
6	async 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	)

1	from agentinbox import Agentinbox
2
3	client = Agentinbox(api_key="your-api-key")
4
5	# create a pod for your sales team
6	pod = client.pods.create(
7	name="Sales Team",
8	description="Shared resources for sales agents"
9	)
10
11	# create an inbox in the pod
12	inbox = client.pods.inboxes.create(
13	pod_id=pod.pod_id,
14	inbox_id="sales@example.com"
15	)
16
17	# list all pods
18	pods = client.pods.list()
19	for pod in pods.pods:
20	print(f"Pod: {pod.name} ({len(pod.inbox_ids)} inboxes)")