Почему письма отклоняются (bounce)? | Agent Inbox

Bounce — сервер получателя не принял письмо. Тип отказа подсказывает действия.

Типы

Постоянный (permanent)

Адрес или домен недоступен навсегда: нет ящика, удалённый ящик, несуществующий домен.

Действие: сразу уберите адрес из списков. Повторные отправки бьют по репутации.

Временный (transient)

Временная проблема: переполненный ящик, недоступность сервера, слишком большое письмо, greylisting.

Действие: Agent Inbox повторяет доставку; после неудачных попыток отказ может стать постоянным.

Webhook `message.bounced`

TypeScript

import { serialization  } from "agentinbox";
async function handleWebhook(payload: Record<string, unknown>) {
  if (payload.event_type === "message.bounced") {
    const event = await serialization.events.MessageBouncedEvent.parse(payload);
    console.log(`Bounce type: ${event.bounce.type}`);
    console.log(`Sub type: ${event.bounce.subType}`);
    console.log(`Message: ${event.bounce.messageId}`);
    for (const recipient of event.bounce.recipients) {
      console.log(`Bounced address: ${recipient.address}`);
      if (event.bounce.type === "Permanent") {
        await removeFromList(recipient.address);
      }
    }
  }
}

Регистрация:

TypeScript

import { AgentinboxClient } from "agentinbox";
const client = new AgentinboxClient({ apiKey: "am_..." });
await client.webhooks.create({
  url: "https://your-domain.ngrok-free.app/webhooks",
  events: ["message.bounced"],
});

Автоподавление

Повторная отправка на адреса после bounce, отказа или жалобы в спам блокируется — защита репутации. Держите bounce rate ниже 4%, иначе возможна проверка аккаунта.

Низкий bounce rate

Практика	Зачем
Валидация адресов	Меньше опечаток и «мёртвых» адресов
Удалять permanent сразу	Репутация
Не покупные/спарсенные списки	Много невалидных адресов
Прогрев новых доменов	Резкий всплеск подозрителен
Мониторинг	Цель < 2% для здоровой репутации

Доставляемость.