SMTP proprio

Invia tramite il tuo server SMTP (per esempio Gmail) per progetto.

Ogni progetto puo inviare tramite il tuo server SMTP invece del trasporto condiviso — utile per la casella Gmail/Workspace di un cliente o un relay esistente. Quando un progetto ha SMTP configurato, i suoi invii escono da li: ha priorita e non torna al trasporto condiviso.

Configurare

Imposta i campi SMTP su un progetto via API (scope projects:write) o dal pannello:

PATCH /projects/{projectId}
Authorization: Bearer <apiKey o accessToken>
X-Tenant-Id: {tenantId}
Content-Type: application/json

{
  "fromEmail": "[email protected]",
  "fromName": "Il Tuo Brand",
  "smtpHost": "smtp.gmail.com",
  "smtpPort": 465,
  "smtpSecure": true,
  "replyTo": "[email protected]"
}

Invia il tuo smtpUser e smtpPassword nello stesso body — entrambi sono documentati nella tabella qui sotto.

Campo	Note
`smtpHost` / `smtpPort`	Il tuo server. Porta `465` + `smtpSecure: true`, oppure `587` + `smtpSecure: false`
`smtpUser` / `smtpPassword`	Credenziali. La password e cifrata a riposo (AES-256-GCM) e mai restituita
`smtpSecure`	TLS alla connessione. Predefinito `true`
`fromEmail` / `fromName` / `replyTo`	Identita mittente di questo progetto

La password e in sola scrittura: le letture restituiscono smtpConfigured: true/false invece del valore. Invia "smtpPassword": "" per cancellarla e tornare al trasporto condiviso.

Verificare le credenziali

POST /projects/{projectId}/verify-smtp

Esegue un handshake di login dal vivo contro il tuo server SMTP e restituisce un errore se fallisce — il modo piu rapido per confermare che una app password di Gmail funzioni.

Gmail

Usa una app password di Gmail (non la password dell'account) e imposta host e porta in modo esplicito:

smtp.gmail.com, porta 465, smtpSecure: true, oppure
smtp.gmail.com, porta 587, smtpSecure: false.

Come viene scelto il trasporto all'invio

Quando invii con un projectId che ha SMTP configurato, il messaggio esce da quel server SMTP (provider: smtp). Altrimenti MailingCore usa il suo trasporto condiviso e autenticato. Vedi Inviare email.