Agent Email
Inbox email per agenti AI, thread, risposte, metriche.
Le Agent Email sono inbox dedicate agli agenti: creale, invia, leggi i thread e rispondi.
| GET/POST | /api/v1/inboxes | Elenca o crea una agent inbox.(scope: inbox:read|write) |
| GET/PATCH/DELETE | /api/v1/inboxes/:id | Dettaglio, aggiorna o elimina una inbox.(scope: inbox:read|write) |
| POST | /api/v1/inboxes/:id/send | Invia un'email dalla inbox.(scope: inbox:send) |
| POST | /api/v1/inboxes/:id/drafts | Crea una bozza nella inbox.(scope: inbox:write) |
| GET | /api/v1/inboxes/:id/threads | Elenca i thread della inbox.(scope: inbox:read) |
| GET | /api/v1/inboxes/:id/threads/:threadId | Dettaglio thread con messaggi.(scope: inbox:read) |
| POST | /api/v1/inboxes/:id/threads/:threadId/reply | Rispondi a un thread.(scope: inbox:send) |
| GET | /api/v1/inboxes/metrics | Metriche agent email (volumi, consegna, bounce).(scope: inbox:read) |
Allegati
POST /api/v1/inboxes/:id/send e POST /api/v1/inboxes/:id/threads/:threadId/reply accettano
il campo attachments con le stesse tre sorgenti degli invii transazionali
({ id }, { filename, content } base64, { filename, url }): vedi Allegati.
curl -X POST "https://sending.dev/api/v1/inboxes/<INBOX_ID>/send" \
-H "Authorization: Bearer <LA_TUA_API_KEY>" \
-H "Content-Type: application/json" \
-d '{ "to": "[email protected]", "subject": "Il preventivo",
"html": "<p>In allegato il preventivo richiesto.</p>",
"attachments": [{ "id": "<ATTACHMENT_ID>" }] }'Gli allegati degli invii dalle inbox finiscono nel thread accanto a quelli ricevuti, quindi la conversazione resta completa in entrambe le direzioni.