Email con allegato automatico
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
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. 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.
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.
Prezzo e limiti pratici
Costa come un’email normale: $0.002 a chiamata più $0.0035 per email inviata, $0.0055 in totale, allegato compreso. 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.
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.
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.
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.
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
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
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 '{"input":"…"}'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({
"input": "…"
})
});
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={
"input": "…"
},
)
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" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
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
{
"input": "…"
}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. |