Ricezione

Etichette e bucket

Archivia automaticamente in etichette la posta inviata e ricevuta e dai a un agente un bucket da cui le sue conversazioni non escono mai.

Etichette

Un'etichetta funziona come una cartella di Gmail. Un messaggio può avere fino a 10 etichette e un workspace fino a 200. Creane una con POST /labels, elencale con il numero di messaggi e di non letti con GET /labels e leggine una con GET /emails?label=Billing. Ovunque, le etichette possono essere indicate per nome o per ID lbl_.

Inviare in un'etichetta

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

I nomi di etichetta sconosciuti vengono creati. Ogni messaggio successivo della conversazione, comprese le risposte del cliente, eredita le etichette della conversazione.

Bucket

Crea un'etichetta con "skip_inbox": true per trasformarla in un bucket. La posta ricevuta che ottiene l'etichetta di un bucket, tramite una regola di archiviazione, una risposta a una conversazione etichettata o POST /emails/:id/labels, viene archiviata, così compare solo nell'etichetta e mai nella Inbox. La posta inviata non compare mai nella Inbox. In questo modo le conversazioni di lavoro di un agente restano in un unico posto in entrambe le direzioni.

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

Regole di archiviazione

Le regole archiviano automaticamente la nuova posta. Ogni condizione impostata su una regola deve corrispondere: inbox_id (l'indirizzo di ricezione), direction (in o out) e sottostringhe, senza distinzione tra maiuscole e minuscole, di from, to (To e Cc) e subject. Lo skip_inbox di una regola archivia solo la posta ricevuta che corrisponde alla regola. Aggiungi regole con POST /labels/:id/rules; apply_to_existing archivia anche la posta già conservata.

Lavorare su un bucket

Interroga periodicamente GET /emails?label=Agent%2FOrders&direction=in&unread=true, leggi la conversazione con GET /threads/:id, rispondi con reply_to_email_id e poi segna il messaggio come gestito con PATCH /emails/:id {"read": true}. Sposta un messaggio dentro o fuori con POST /emails/:id/labels {"add": [...], "remove": [...]}. Il server MCP espone le stesse operazioni come create_label, create_label_rule, label_email e list_emails.