Ontvangen

Labels en buckets

Sorteer verzonden en ontvangen e-mail automatisch in labels en geef een agent een bucket die zijn conversaties nooit verlaten.

Labels

Een label werkt als een map in Gmail. Een bericht kan maximaal 10 labels hebben en een workspace maximaal 200. Maak er een aan met POST /labels, vraag ze op met het aantal berichten en ongelezen berichten via GET /labels en lees er een met GET /emails?label=Billing. Je kunt overal naar labels verwijzen met hun naam of hun lbl_-ID.

Verzenden naar een label

Body van POST /emails
{
  "from": "Orders <orders@example.com>",
  "to": [
    "customer@example.net"
  ],
  "subject": "Order 1042",
  "text": "Reply with a delivery window.",
  "labels": [
    "Agent/Orders"
  ]
}

Onbekende labelnamen worden aangemaakt. Elk later bericht in de conversatie, inclusief de antwoorden van de klant, krijgt de labels van de conversatie.

Buckets

Maak een label met "skip_inbox": true om er een bucket van te maken. Ontvangen e-mail die een bucketlabel krijgt, via een sorteerregel, een antwoord op een gelabelde conversatie of POST /emails/:id/labels, wordt gearchiveerd zodat hij alleen in het label verschijnt en nooit in de Inbox. Verzonden e-mail verschijnt nooit in de Inbox. Samen zorgt dat ervoor dat de taakconversaties van een agent in beide richtingen op één plek blijven.

Body van POST /labels
{
  "name": "Agent/Orders",
  "skip_inbox": true,
  "rules": [
    {
      "inbox_id": "inb_…"
    }
  ],
  "apply_to_existing": true
}

Sorteerregels

Regels sorteren nieuwe e-mail automatisch. Elke voorwaarde die op een regel is ingesteld moet overeenkomen: inbox_id (het ontvangende adres), direction (in of out) en hoofdletterongevoelige deelstrings van from, to (To en Cc) en subject. De eigen skip_inbox van een regel archiveert alleen de ontvangen e-mail die ermee overeenkomt. Voeg regels toe met POST /labels/:id/rules; met apply_to_existing wordt ook bewaarde e-mail gesorteerd.

Een bucket afwerken

Poll GET /emails?label=Agent%2FOrders&direction=in&unread=true, lees de conversatie met GET /threads/:id, antwoord met reply_to_email_id en markeer het bericht daarna als afgehandeld met PATCH /emails/:id {"read": true}. Verplaats een bericht naar een label of eruit met POST /emails/:id/labels {"add": [...], "remove": [...]}. De MCP-server biedt dezelfde bewerkingen aan als create_label, create_label_rule, label_email en list_emails.