Domini e deliverability

Aggiungi e verifica un dominio, gestisci suppression e ricezione inbound.

L'invio e consentito solo da un dominio verificato.

Aggiungi il dominio

POST /api/v1/domains ritorna i record DNS da impostare.

Imposta i record DNS

SPF, DKIM e MAIL FROM presso il tuo provider DNS.

Verifica

POST /api/v1/domains/:id/verify controlla SPF, DKIM, DMARC.

Con l'SDK

// 1. Aggiungi il dominio (ritorna i record DNS in `dnsRecords`)
const { id, dnsRecords } = await sending.domains.create({ name: "tuodominio.dev" });
 
// 2. Imposta i record DNS presso il tuo provider, poi verifica
await sending.domains.verify(id);
 
// 3. (opzionale) Abilita la ricezione inbound per le Agent Email
await sending.domains.enableInbound(id);

Nome mittente

Per default il destinatario vede solo l'indirizzo: da [email protected] Gmail mostra "ciao". Imposta un nome mittente sul dominio e le email partono come Federico <[email protected]>.

Vale per ogni email inviata da un indirizzo del dominio: transazionali, campagne e automazioni. Se l'invio indica gia' un mittente per esteso (from: "Marketing <[email protected]>") quello vince sul default del dominio. Dalla dashboard: Comunicazione › Domini › dettaglio › tab Mittente.

await sending.domains.update(id, { defaultFromName: "Federico" });
 
// Rimuovi il default (torna l'indirizzo nudo)
await sending.domains.update(id, { defaultFromName: null });

Un agente puo' fare lo stesso via MCP con set_domain_sender_name, e leggere il valore corrente con list_domains.

Suppression

Gli indirizzi in bounce permanente, complaint o unsubscribe finiscono in suppression e gli invii verso di loro vengono bloccati automaticamente.

Ricezione inbound

Abilita la ricezione (MX) per un dominio con POST /api/v1/domains/:id/inbound, per usare le Agent Email su un tuo dominio.