Receta para agentes
Consultar el estado de una notificación
Saber si llegó, se entregó, se abrió o se descargó.
Esta es la receta que el servidor MCP entrega a los asistentes de IA, tal cual. Está en inglés porque los modelos la siguen mejor así; el asistente le responde en su idioma.
Un asistente la lee con docs({uri:"docs://recipes/check-a-notification-status"})
docs://recipes/check-a-notification-status — what happened to a notification that was sent
Use when the lawyer asks "did it arrive?", "was it delivered?", "did they open it?" about a
notification. For what those words legally mean, read docs://recipes/what-counts-as-delivered
before you answer — the words matter in court.
1. whoami({})
→ orgId
skip if you already hold orgId
2. notificationList({orgId:"<orgId>", limit:50})
→ notification.id, status, subject, case
Newest first. The lawyer named a case or radicado instead? Use
docs://recipes/find-a-case-by-radicado first, then match on the case.
Not in the first 50? Call again with limit:200. Still not there? Stop and ask for more detail.
skip if you already hold notification.id
3. notificationDetail({orgId:"<orgId>", id:"<notification.id>"})
→ status, recipients[] (each with its status), attachments[], timeline[]
status "draft"? It was never sent — say so. An open send request is waiting for the lawyer's
confirmation in the panel if they asked you to send it.
status "freezing" | "frozen" | "sending"? It is on its way; check again in a minute. Do not
poll more than 5 times.
status "failed"? Say so, and quote the timeline's last event.
4. Report per recipient, in plain words, with times in America/Bogota:
- "accepted" = the recipient's mail server took the message (the delivery proof).
- "opened" = a tracking pixel loaded: an INDICIO only, never proof of reading.
- "downloaded" = someone fetched an attachment through the per-recipient link.
- "acknowledged" = the recipient confirmed receipt on the recipient page.
- "bounced" | "complained" | "deferred" = say exactly that, and suggest the lawyer check the address.
Done when every recipient has a status line and a time, or you said why not.
Tips
- Read, don't infer: quote the timeline events, never guess a delivery that is not there.
- A "sent" notification with a recipient still "sent" (not "accepted") usually means the remote
server has not answered yet; minutes are normal, hours are worth mentioning.
- The constancia is issued after delivery events arrive — see
docs://recipes/download-evidence-for-a-perito to fetch it.