Skip to content

Handle a bounce

Who was not notified because their server refused the message, and what you can do.

This is the recipe the MCP server gives AI assistants, as is. It is in English because models follow it best that way; the assistant answers you in your language.

An assistant reads it with docs({uri:"docs://recipes/handle-a-bounce"})

docs://recipes/handle-a-bounce
docs://recipes/handle-a-bounce — a recipient's server refused the notification

Use when a recipient shows "bounced", "complained" or "failed", or the lawyer asks which
notifications did not get through. A bounce means that person was NOT notified at that address:
no surtida, no term. Never describe a bounced notification as delivered or opened.

1. whoami({})
   → orgId
   skip if you already hold orgId

2. manage_resource({resource:"notifications", action:"bounceAlerts", params:{orgId:"<orgId>"}})
   → recipients newest first: notificationId, email, status (bounced | failed | complained),
     case radicado
   Only those not yet re-issued to another address. One notification only? Add
   notificationId:"<notification.id>" to params: it also shows switched true for those already
   re-issued.
   Empty? Nothing is waiting. Stop.

3. manage_resource({resource:"notifications", action:"getNotification", params:{orgId:"<orgId>", notificationId:"<notification.id>"}})
   → the recipient's timeline, with the receiving server's answer
   Quote the answer (e.g. "550 mailbox unavailable"); never guess why it bounced.

4. Tell the lawyer, per recipient:
   - bounced: the address refused it for good. Check the address, or find another one.
   - failed: our mail transport refused to send it; the address itself may be fine.
   - complained: the recipient marked it as unwanted. It was delivered, and the complaint is
     recorded as an event; ask the lawyer how to proceed.
   A new address the lawyer found? Check it first:
   manage_resource({resource:"notifications", action:"checkAddress", params:{orgId:"<orgId>", email:"<email>"}})
   → verdict ok | warn | block, reasons

5. The next step is the lawyer's, in the panel, on
   https://www.notificado.co/notificaciones/<notification.id>: re-issue to another address they
   swear, or notify by physical means. You cannot add or swear an address, and there is no tool
   for either.

Done when the lawyer knows who was not notified, the server's answer, and their two options.

Tips
- Terms of a bounced recipient are blocked, not late:
  manage_resource({resource:"deadlines", action:"listDeadlines", params:{orgId:"<orgId>", status:"blocked_bounce"}})
- The memorial for the juzgado is refused while a recipient bounced (docs://recipes/draft-a-memorial).
- Keep the address for the next time with docs://recipes/manage-the-address-book once the lawyer
  has a good one.

All recipes · Connect an assistant