Email con allegato automatico
Consegni come allegato, non come link, il documento che il suo sistema ha creato pochi secondi fa: una fattura PDF e una nota possono viaggiare insieme nello stesso messaggio dal suo dominio, e lei sa se è stato consegnato o respinto. Paga solo l’uso, senza abbonamento.
Questa attività non è disponibile al momento, quindi non può essere acquistata. Non viene addebitato nulla.
Vedi l'APIspedisci il PDF appena è pronto
Perché un allegato e non un link
Inviare un documento come link di download sembra moderno, ma aggiunge una dipendenza: il link deve restare valido, il destinatario deve fidarsi a cliccarlo e alcuni filtri aziendali trattano i link sconosciuti con più severità di un semplice allegato. Per ciò che una persona deve conservare, come una ricevuta per i propri archivi o un accordo firmato, un documento dentro il messaggio resta ciò che ci si aspetta e si archivia senza pensarci. Questo strumento prende il documento appena prodotto dal suo sistema, una fattura, una ricevuta o un contratto, e lo invia allegato a un messaggio dal suo dominio.
Usi adatti e cosa controllare
È adatto a contratti firmati consegnati come copia permanente nella casella del firmatario, a report settimanali inviati come piccolo foglio di calcolo o riepilogo PDF a un elenco di interessati, e a ricevute di pagamento spedite appena la transazione va a buon fine. Lei indica destinatario, oggetto, testo e ogni documento con il suo nome; il documento viene preparato per l’email e il messaggio entra subito in coda. L’esito, accettato, consegnato, respinto o fallito, le torna indietro, così sa che la fattura è arrivata e non solo che ne ha chiesto l’invio. Dia a ogni documento un nome chiaro con l’estensione giusta, perché è ciò che vede il destinatario.
Come si allega il file
Passi il documento insieme ai campi normali dell’email — destinatario, oggetto, corpo — indicando nome e contenuto dell’allegato. Il formato più comune è il PDF, ma qualsiasi file va bene: immagine, foglio di calcolo, archivio compresso.
Combinarlo con la generazione del documento
Il caso d’uso più naturale è collegare prima la creazione del PDF — una fattura, un certificato, un report — e poi l’invio con questo passaggio: il file esce da uno strumento del KIT ed entra direttamente nell’allegato, senza scaricarlo e ricaricarlo a mano. In combinazione con un’attività ricorrente programmata, il ciclo intero gira da solo ogni mese, dalla generazione del documento fino alla casella di posta del cliente.
Casi d'uso
Fattura inviata appena emessa
La Tecnoedil Verona S.n.c. genera la fattura del cantiere in PDF e la spedisce al cliente nello stesso momento, senza che qualcuno debba scaricarla e riallegarla in un secondo passaggio.
Report mensile allo studio commercialista
Ogni fine mese, Officina Meccanica Ferrari S.n.c. di Modena manda il riepilogo delle spese in PDF direttamente allo Studio Commercialista Bianchi, come allegato di un’unica email automatica.
Attestato di partecipazione dopo un corso online
Un ente di formazione invia l’attestato in PDF a ogni partecipante appena termina il corso: Chiara Romano riceve il documento pochi minuti dopo aver completato l’ultima lezione.
Domande frequenti
Che dimensione massima può avere l’allegato?
Va bene per documenti tipici come fatture, report e certificati in PDF: file di poche pagine o pochi megabyte. Per allegati molto più pesanti scrivici prima e valutiamo insieme l’approccio migliore, ad esempio un link invece dell’allegato diretto.
Posso allegare più di un file nella stessa email?
Sì, puoi passare più allegati nella stessa chiamata: ad esempio la fattura in PDF e il documento di trasporto insieme.
L’allegato viene conservato da qualche parte dopo l’invio?
Il file viene elaborato per completare la consegna e poi non resta archiviato. Se ti serve una copia permanente, conservala tu prima di inviarla.
Posso generare il PDF e inviarlo in un solo passaggio?
Con questa capacità da sola generi il file altrove e poi lo alleghi qui. Collegandola a un flusso a più passaggi, puoi far uscire il PDF da uno strumento del KIT ed entrare direttamente nell’invio, senza passaggi manuali in mezzo.
È sicuro mandare documenti con dati fiscali come allegato?
Il file viaggia cifrato durante il transito e viene eliminato dopo l’elaborazione. Come per qualunque email, evita comunque di allegare dati più sensibili di quanto serva davvero.
Strumenti correlati
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Un POST autenticato crea l'attività; il risultato arriva via webhook o con un link firmato. Questa capacità è disponibile via API, non come strumento web interattivo.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/notify/email-attachment \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"to":"ada@example.com","subject":"Tu factura","attachments":["https://ejemplo.com/archivo.bin"]}'const res = await fetch("https://api.kit.forhosting.com/notify/email-attachment", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"to": "ada@example.com",
"subject": "Tu factura",
"attachments": [
"https://ejemplo.com/archivo.bin"
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/notify/email-attachment",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"to": "ada@example.com",
"subject": "Tu factura",
"attachments": [
"https://ejemplo.com/archivo.bin"
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/notify/email-attachment", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"to":"ada@example.com","subject":"Tu factura","attachments":["https://ejemplo.com/archivo.bin"]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"to":"ada@example.com","subject":"Tu factura","attachments":["https://ejemplo.com/archivo.bin"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/notify/email-attachment", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"to": "ada@example.com",
"subject": "Tu factura",
"attachments": [
"https://ejemplo.com/archivo.bin"
]
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "notify.email_attachment",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
Note tecniche
notify.email_attachment manda un’email con un file allegato — fattura, ricevuta, report — appena il documento è pronto, senza passaggi manuali. Passi destinatario, testo e allegato in un’unica chiamata dalla pagina o via API; la consegna costa esattamente come un’email normale, allegato compreso.
Il file pronto che nessuno spedisce a mano
Molti flussi generano un documento — una fattura, un report mensile, un attestato — e poi qualcuno deve ricordarsi di allegarlo a un’email e mandarla. È il punto dove le cose si dimenticano. notify.email_attachment chiude il cerchio: appena il file esiste, lo alleghi alla chiamata insieme a destinatario e testo, e la spedizione parte da sola, sempre uguale, senza dimenticanze.
Come si allega il file
Il resto del flusso è identico a un’email semplice: una chiamata, un task_id, la consegna, senza passaggi tecnici aggiuntivi da configurare prima di iniziare a inviare.
Prezzo e limiti pratici
Gli allegati molto pesanti — video, archivi enormi — non sono adatti alla posta elettronica in generale: per file grandi conviene un link di download nel corpo del messaggio invece dell’allegato diretto, così la consegna resta affidabile e veloce per chi la riceve. Costa come un’email normale: $0.002 a chiamata più $0.0035 per email inviata, $0.0055 in totale, allegato compreso.
Domande tecniche
Quanto costa in più rispetto a un’email senza allegato?
Niente: il prezzo è identico, $0.0055 per invio, allegato incluso. Non c’è un supplemento per il file.