1.5 KiB
1.5 KiB
Provider runbooks
SMTP
| Symptom | Classification | Action |
|---|---|---|
Final 2xx after DATA |
CONFIRMED_ACCEPTED / PROVIDER_ACCEPTED |
None; this is acceptance, not inbox delivery |
4yz |
TRANSIENT_PROVIDER |
Retry under budget and deadline |
5yz |
PERMANENT_PROVIDER or INVALID_RECIPIENT |
Stop, or invalidate the contact point |
Connection lost after DATA |
AMBIGUOUS_SUBMISSION |
Reconcile or escalate; do not resend automatically |
Connection, read, write and pool-acquire timeouts are all finite. There is no unbounded timeout.
Amazon SES
MessageId is acceptance evidence. SES itself documents that it can accept a request and then not
send, so MessageId is never mapped to DELIVERED.
| Event | Normalized |
|---|---|
Send |
reinforces PROVIDER_ACCEPTED |
Delivery |
DELIVERY_CONFIRMED / NETWORK_OR_CARRIER_ACCEPTED |
DeliveryDelay |
delay fact |
Bounce (permanent) |
BOUNCED_HARD plus hard-bounce suppression |
Bounce (transient) |
BOUNCED_SOFT; retry policy input, not a suppression reason |
Complaint |
complaint fact plus suppression |
Reject |
PROVIDER_REJECTED |
RenderingFailure |
TEMPLATE_FAILURE |
Removed provider families
Twilio, FCM, APNs, Web Push and Webhook adapters were removed because nothing assembled them; their
runbooks went with them. The last commit that had both is named in docs/capability-status.md
(제거된 코드). A deployment that adds one of these providers back writes its runbook here with it.