Verstuur een brief vanuit uw AI-assistent

Verbinden

De connector is een externe MCP-server via Streamable HTTP. Inloggen is niet nodig, dus laat authenticatie uit.

• Claude: open Customize → Connectors, kies Add custom connector, noem hem Unopost en plak de server-URL. Zet Unopost in een chat aan via het menu met tools.
• ChatGPT: voeg in de ontwikkelaarsmodus een aangepaste connector toe met de server-URL en zonder authenticatie, en zet hem daarna aan in de chat.
• Claude Code en andere clients: voeg hem toe als externe HTTP-server. Elke client die aangepaste MCP-servers ondersteunt, gebruikt dezelfde URL.

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

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

Zo gaat een brief

1. Adressen bevestigen
2. Brief klaarmaken
3. Wachten op de opmaak
4. De gebruiker betaalt op de website

De assistent bevestigt de adressen met de gebruiker, maakt de brief klaar en geeft de gebruiker een privélink om hem te controleren. Daar bekijkt de gebruiker het voorbeeld, vult een e-mailadres in en betaalt met een kaart. Pas door de betaling wordt de brief verstuurd.

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.

Tools

Assistenten roepen deze zelf aan. Elk resultaat van prepare_letter, finish_letter_upload en get_letter_status bevat reviewUrl, de privépagina waar de gebruiker het voorbeeld controleert en betaalt, en instructions, met wat de gebruiker daarna te horen moet krijgen.

Limieten

pages

Maximaal 80 pagina's per brief. Splits een langer document op in losse brieven.

regular

Gewone post, en elke gevouwen brief, neemt maximaal 12 pagina's. Langere brieven gaan ongevouwen met Express Post.

size

Maximaal 50 MB per bestand.

files

PDF, Word (.doc, .docx), JPEG of PNG. Word-documenten worden op A4 opgemaakt.

letter

Eén bestand per brief via de connector. De website neemt er maximaal 10.

rate

200 brieven per uur vanaf elke AI-host.

Statussen

CREATED

Gereserveerd, wacht op het bestand.

CONVERTING

Wordt opgemaakt.

CONVERTED AWAITING_PAYMENT

Klaar voor de gebruiker om te controleren en te betalen via reviewUrl.

PAID PAYING SENDING RETRYING MANUAL_CHECK

Betaald. Brieven die op een werkdag vóór 14:30 uur Melbourne-tijd zijn betaald, worden dezelfde dag verstuurd.

POSTED UNDELIVERED

Afgegeven bij Australia Post. Het track & trace-nummer is naar de gebruiker gemaild.

DELIVERED

Volgens de track & trace van Australia Post bezorgd.

FAILED

Niet verstuurd. error zegt waarom, en instructions wat de volgende stap is. Een betaalde brief wordt volledig terugbetaald.

PAYMENT_EXPIRED

Niet op tijd betaald. Het document is verwijderd.

REFUNDED

Geannuleerd of niet te versturen, en teruggestort op de kaart.

Fouten

Een tool die mislukt, geeft een foutresultaat terug waarvan de tekst, geschreven voor de assistent, zegt wat er misging en wat te doen. Er zijn geen foutcodes en we kunnen de meldingen anders formuleren, dus handel naar het soort fout, niet naar de exacte woorden.

Een tool betaalt en verstuurt nooit, dus een fout kost de gebruiker nooit iets. Maar zodra een fout een job noemt, bestaat die brief: controleer hem met get_letter_status in plaats van een tweede klaar te maken.

arguments

Een argument ontbreekt of klopt niet: een adres dat de gebruiker moet bevestigen, opties die niet samengaan, een niet-ondersteund bestandstype, een geweigerde preparedFor of een ongeldig e-mailadres. De melding noemt het. Corrigeer het en roep opnieuw aan; er is niets aangemaakt.

file

Het originele bestand kon niet bij de host worden opgehaald: de link is verlopen, werd geweigerd, was te traag of stuurde te vaak door, verwijst naar een privéadres, of het bestand is leeg of groter dan 50 MB. Er is niets verstuurd. Haal een nieuwe bestandsreferentie op, of gebruik create_letter_upload; stuur nooit een tekstkopie in plaats daarvan.

job …

De melding begint met job …: als de brief is aangemaakt maar een latere stap mislukte. Roep get_letter_status aan met die job-ID, en daarna finish_letter_upload als hij nog op zijn adressen wacht. Maak geen nieuwe brief klaar.

rate limit

Te veel brieven van deze AI-host dit uur, of de daglimiet van de connector is bereikt. Probeer het niet in een lus opnieuw: zeg de gebruiker het later te proberen, of de brief via de website van Unopost te versturen.

paused

We hebben nieuwe brieven tijdelijk gepauzeerd; brieven die al onderweg zijn, gaan gewoon door. Probeer het later opnieuw.

not found

Geen enkele brief heeft die jobId, of de upload is na 24 uur verlopen. Gebruik alleen een job-ID die Unopost aan deze gebruiker heeft teruggegeven, en begin opnieuw als die verlopen is.

server

Er ging bij ons iets mis: Unopost API returned HTTP 5xx. Wacht een paar seconden en probeer het nog één keer.

FAILED

Een brief die niet geprint kan worden, is geen toolfout: get_letter_status geeft FAILED terug met error en duidelijke instructions, zoals een document van meer dan 80 pagina's opsplitsen of een wachtwoord verwijderen.

Betaling en privacy

• Hij betaalt en verstuurt nooit. De connector geeft geen betaallink terug. De gebruiker betaalt alleen op de website, nadat hij het voorbeeld heeft gezien.
• Het originele bestand, ongewijzigd. Bestanden gaan nooit mee in MCP-berichten en worden nooit vervangen door tekst.
• Privélinks. Een job-ID is de enige sleutel tot een brief, dus assistenten delen die en reviewUrl alleen met de gebruiker.
• Annuleren vóór het printen. Een betaalde brief kan via reviewUrl met volledige terugbetaling worden geannuleerd totdat wij hem beginnen te printen.
• Verwijderd na verzending. Documenten worden verwijderd zodra een brief is verstuurd, en die van een onbetaalde brief na 24 uur.

Webhooks? Gebruik een inbox

De connector heeft geen webhooks. Geef de assistent in plaats daarvan een notifyEmail van een inbox die uw software leest. Elke e-mail over een brief komt van notifications@unopost.com.au en draagt de brief in de headers mee, zodat een maildienst die code uitvoert op binnenkomende mail, zoals Amazon SES, Postmark, Mailgun of SendGrid, op elke update kan reageren zodra die binnenkomt.

1. Laat notifyEmail wijzen naar een adres dat uw maildienst ontvangt, zoals letters@yourbusiness.com.au.
2. Accepteer alleen mail van notifications@unopost.com.au die de DMARC-controle doorstaat, en negeer de rest.
3. Lees de headers, niet de tekst, want die kan veranderen. Negeer een Unopost-Event-Id die u al hebt gezien.

Headers

Unopost-Letter-Id

De jobId van de brief, zoals de connector die teruggaf.

Unopost-Event

Wat er is gebeurd: receipt, posted, tracking, retrying, delayed, awaiting-collection, delivered, cancelled, failed, refunded of refunded-printed.

Unopost-Event-Id

Hetzelfde voor hetzelfde nieuws, hoe vaak het ook wordt verstuurd, zodat u herhalingen kunt negeren.

Unopost-Letter-Status

De status van de brief daarna: TO_POST, POSTED, DELAYED, AWAITING_AT_COLLECTION, DELIVERED, CANCELLED of REFUNDED.

Unopost-Tracking-Number

Het track & trace-nummer van Australia Post, zodra de brief is verstuurd.

Unopost-Copy

business op de kopie die een bedrijf krijgt; niet op de eigen e-mail van de klant.

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'),
  });
};

Kopieën beginnen zodra de klant betaalt, dus voor een brief die nooit wordt betaald komt er niets binnen: controleer tot dan get_letter_status. De e-mails aan de klant zelf bevatten dezelfde headers. We kunnen headers toevoegen, maar deze nooit hernoemen of verwijderen.

Vindbaarheid

Agents kunnen de connector vinden zonder dat iemand het ze vertelt. Hij staat in onze AI-catalogus, die naar de MCP-serverkaart verwijst.

• AI-catalogus /.well-known/ai-catalog.json
• MCP-serverkaart /.well-known/mcp/server-card.json

Prijzen

Elke brief heeft track & trace. De uiteindelijke prijs hangt af van het aantal pagina's, dat bekend is zodra de brief is opgemaakt.

Op brieven die via de connector worden klaargemaakt, zijn net als op alle andere onze Voorwaarden en ons Privacybeleid van toepassing.