Envíe una carta desde su asistente de IA

Conéctelo

El conector es un servidor MCP remoto sobre Streamable HTTP. No requiere inicio de sesión, así que deje la autenticación desactivada.

• Claude: abra Customize → Connectors, elija Add custom connector, llámelo Unopost y pegue la URL del servidor. En un chat, active Unopost desde el menú de herramientas.
• ChatGPT: añada un conector personalizado en modo desarrollador con la URL del servidor y sin autenticación, y luego actívelo en el chat.
• Claude Code y otros clientes: añádalo como servidor HTTP remoto. Cualquier cliente que admita servidores MCP personalizados usa la misma URL.

claude mcp add --transport http unopost https://unopost.com.au/api/mcp

{
  "mcpServers": {
    "unopost": {
      "type": "http",
      "url": "https://unopost.com.au/api/mcp"
    }
  }
}

Cómo se envía una carta

1. Confirmar las direcciones
2. Preparar la carta
3. Esperar la maquetación
4. El usuario paga en el sitio web

El asistente confirma las direcciones con el usuario, prepara la carta y le da un enlace privado de revisión. Allí el usuario revisa la vista previa, introduce un correo electrónico y paga con tarjeta. El pago es lo que envía la carta.

Post this letter by Express Post to Jane Citizen,
12 Example Street, Southbank VIC 3006.
My return address is 1 Sample Road, Carlton VIC 3053.

Herramientas

Los asistentes las llaman por sí mismos. Cada resultado de prepare_letter, finish_letter_upload y get_letter_status incluye reviewUrl, la página privada donde el usuario revisa la vista previa y paga, e instructions, que indican qué decirle al usuario a continuación.

Límites

pages

Hasta 80 páginas por carta. Divida un documento más largo en cartas separadas.

regular

El correo ordinario, y cualquier carta doblada, admite hasta 12 páginas. Las cartas más largas van por Express Post, sin doblar.

size

Hasta 50 MB por archivo.

files

PDF, Word (.doc, .docx), JPEG o PNG. Los documentos de Word se maquetan en A4.

letter

Un archivo por carta a través del conector. El sitio web admite hasta 10.

rate

200 cartas por hora desde cada host de IA.

Estados

CREATED

Reservada, a la espera de su archivo.

CONVERTING

En maquetación.

CONVERTED AWAITING_PAYMENT

Lista para que el usuario la revise y pague en reviewUrl.

PAID PAYING SENDING RETRYING MANUAL_CHECK

Pagada. Las cartas pagadas antes de las 14:30, hora de Melbourne, de un día hábil se envían ese día.

POSTED UNDELIVERED

Depositada en Australia Post. El número de seguimiento se ha enviado al usuario por correo electrónico.

DELIVERED

El seguimiento de Australia Post la muestra como entregada.

FAILED

No enviada. error indica el motivo, e instructions, qué hacer a continuación. Una carta pagada se reembolsa íntegramente.

PAYMENT_EXPIRED

No se pagó a tiempo. Su documento se ha eliminado.

REFUNDED

Cancelada o imposible de enviar, y reembolsada a la tarjeta.

Errores

Una herramienta que falla devuelve un resultado de error cuyo texto, escrito para el asistente, indica qué salió mal y qué hacer. No hay códigos de error y podemos cambiar la redacción de los mensajes, así que actúe según el tipo de error, no según sus palabras exactas.

Una herramienta nunca cobra ni envía, así que un error nunca le cuesta nada al usuario. Pero en cuanto un error menciona un trabajo, esa carta existe: compruébela con get_letter_status en lugar de preparar una segunda.

arguments

Falta un argumento o es incorrecto: una dirección que el usuario debería confirmar, opciones incompatibles, un tipo de archivo no admitido, un preparedFor rechazado o un correo electrónico mal formado. El mensaje lo indica. Corríjalo y vuelva a llamar; no se ha creado nada.

file

No se pudo obtener el archivo original del host: el enlace caducó, fue rechazado, tardó demasiado o redirigió demasiadas veces, apunta a una dirección privada, o el archivo está vacío o supera los 50 MB. No se ha enviado nada. Consiga una nueva referencia de archivo o use create_letter_upload; nunca envíe una copia en texto en su lugar.

job …

El mensaje empieza por job …: cuando la carta se creó pero falló un paso posterior. Llame a get_letter_status con ese ID de trabajo y luego a finish_letter_upload si aún espera sus direcciones. No prepare otra carta.

rate limit

Demasiadas cartas desde este host de IA en esta hora, o se ha alcanzado el límite diario del conector. No reintente en bucle: dígale al usuario que lo intente más tarde o que la envíe desde el sitio web de Unopost.

paused

Hemos pausado temporalmente las cartas nuevas; las que ya están en curso continúan. Vuelva a intentarlo más tarde.

not found

Ninguna carta tiene ese jobId, o su subida caducó tras 24 horas. Use solo un ID de trabajo que Unopost haya devuelto a este usuario, y empiece de nuevo si caducó.

server

Algo ha fallado por nuestra parte: Unopost API returned HTTP 5xx. Espere unos segundos y vuelva a intentarlo una vez.

FAILED

Una carta que no se puede imprimir no es un error de la herramienta: get_letter_status devuelve FAILED con error e instructions claras, como dividir un documento de más de 80 páginas o quitar una contraseña.

Pago y privacidad

• Nunca paga ni envía. El conector no devuelve ningún enlace de pago. El usuario solo paga en el sitio web, después de ver la vista previa.
• El archivo original, sin cambios. Los archivos nunca viajan dentro de mensajes MCP ni se sustituyen por texto.
• Enlaces privados. Un ID de trabajo es la única llave de una carta, así que los asistentes lo comparten, junto con reviewUrl, solo con el usuario.
• Cancelación antes de imprimir. Una carta pagada puede cancelarse con reembolso íntegro desde reviewUrl hasta que empecemos a imprimirla.
• Eliminados tras el envío. Los documentos se eliminan una vez enviada la carta, y los de una carta sin pagar, a las 24 horas.

¿Webhooks? Use una bandeja de entrada

El conector no tiene webhooks. En su lugar, dé al asistente un notifyEmail de una bandeja de entrada que lea su software. Cada correo sobre una carta procede de notifications@unopost.com.au y lleva la carta en sus encabezados, así que un servicio de correo que ejecute código con el correo entrante, como Amazon SES, Postmark, Mailgun o SendGrid, puede actuar ante cada novedad en cuanto llega.

1. Apunte notifyEmail a una dirección que reciba su servicio de correo, como letters@yourbusiness.com.au.
2. Acepte solo el correo de notifications@unopost.com.au que supere la verificación DMARC y descarte el resto.
3. Lea los encabezados, no el texto, que puede cambiar. Descarte un Unopost-Event-Id que ya haya visto.

Encabezados

Unopost-Letter-Id

El jobId de la carta, tal como lo devolvió el conector.

Unopost-Event

Lo que ha pasado: receipt, posted, tracking, retrying, delayed, awaiting-collection, delivered, cancelled, failed, refunded o refunded-printed.

Unopost-Event-Id

Es el mismo para la misma novedad, se envíe las veces que se envíe, así que puede descartar las repeticiones.

Unopost-Letter-Status

El estado de la carta después: TO_POST, POSTED, DELAYED, AWAITING_AT_COLLECTION, DELIVERED, CANCELLED o REFUNDED.

Unopost-Tracking-Number

El número de seguimiento de Australia Post, una vez enviada la carta.

Unopost-Copy

business en la copia que recibe una empresa; no en el correo del propio cliente.

From: Unopost <notifications@unopost.com.au>
Unopost-Letter-Id: 019d7a7f-a183-752d-9b3b-11511179033b
Unopost-Event: tracking
Unopost-Event-Id: evt_3f9a1c0b7e2d4a6b8c1d0e2f
Unopost-Letter-Status: POSTED
Unopost-Tracking-Number: 33LQV507012301000935005
Unopost-Copy: business

export const handler = async (event) => {
  const { mail, receipt } = event.Records[0].ses;
  const { from } = mail.commonHeaders;
  const fromUs = from.length === 1 && /(^|<)notifications@unopost\.com\.au>?$/i.test(from[0]);
  // DMARC, not DKIM alone: only a DMARC pass means unopost.com.au signed it.
  if (!fromUs || receipt.dmarcVerdict.status !== 'PASS') return;
  const header = name =>
    mail.headers.find(h => h.name.toLowerCase() === name.toLowerCase())?.value;
  await recordUpdate({
    letterId: header('Unopost-Letter-Id'),
    event: header('Unopost-Event'),
    eventId: header('Unopost-Event-Id'), // drop one you've seen
    status: header('Unopost-Letter-Status'),
    trackingNumber: header('Unopost-Tracking-Number'),
  });
};

Las copias empiezan cuando el cliente paga, así que no llega nada de una carta que nunca se paga: consulte get_letter_status hasta entonces. Los correos que recibe el propio cliente llevan los mismos encabezados. Podemos añadir encabezados, pero nunca cambiaremos el nombre de estos ni los eliminaremos.

Descubrimiento

Los agentes pueden encontrar el conector sin que nadie se lo indique. Figura en nuestro catálogo de IA, que remite a su tarjeta de servidor MCP.

• Catálogo de IA /.well-known/ai-catalog.json
• Tarjeta de servidor MCP /.well-known/mcp/server-card.json

Precios

Todas las cartas llevan seguimiento. El precio final depende del número de páginas, que se conoce una vez maquetada la carta.

Las cartas preparadas a través del conector se rigen, como cualquier otra, por nuestros Términos y nuestra Política de privacidad.