ForHosting KIT · Notifications et automatisations

E-mail avec pièce jointe

Cette capacité envoie un e-mail en y joignant un ou plusieurs fichiers — une facture PDF, un devis, un justificatif. Vous fournissez le destinataire, le message et les documents à joindre ; le KIT compose l’e-mail complet et l’expédie. Elle sert dès qu’un envoi doit porter une pièce, pas seulement du texte.

● Stablepar requête + par e-mail$0.002

Voir l’API — $0.002 + $0.0035/e-mail Voir l’API

Utilisez-le depuis WebAPIE-mailApp bientôtTelegram bientôt

Le document part avec le message

Envoyer une facture, c’est rarement envoyer que du texte : il faut le fichier. Cette capacité attache la pièce à l’e-mail au moment de l’expédition, comme vous le feriez à la main, mais déclenché par un événement. Une commande validée, un devis accepté, une échéance atteinte, et le message part avec le bon document joint. Vous décrivez le circuit une fois ; ensuite, chaque envoi transporte sa pièce sans que vous ayez à ouvrir votre messagerie ni à chercher le fichier.

Ce qui peut être joint

La pièce jointe peut être un PDF que vous fournissez, un fichier produit par une autre capacité du KIT — une facture générée, une image convertie — ou un document que vous transmettez au moment de l’envoi. Plusieurs pièces sont possibles dans un même message. Le poids total reste raisonnable : l’e-mail n’est pas fait pour de gros volumes, et un fichier trop lourd risque d’être refusé par la boîte du destinataire, indépendamment de l’expéditeur.

Enchaîner génération et envoi

L’intérêt se révèle quand la pièce jointe est produite juste avant : une facture créée à partir de vos données, puis expédiée au client dans la foulée. En reliant la génération du document et cet envoi, vous obtenez un circuit complet, de la donnée brute à l’e-mail reçu. Le tout se pilote depuis cette page ou via l’API ; l’e-mail et Telegram figurent parmi les canaux du KIT en cours d’ouverture.

Tarif à l’usage

L’envoi coûte $0.002 par requête, plus $0.0035 par e-mail expédié, en dollars US, pièce jointe comprise. Aucun surcoût caché lié à l’attachement, aucun abonnement : vous payez chaque message au moment où il part. Le prix étant affiché d’avance, le coût d’une campagne de factures se calcule simplement en multipliant par le nombre de destinataires. Une facture vous est remise pour votre propre comptabilité.

Cas d’usage

Envoyer la facture au client

Atelier Garnier SARL adresse à chaque client sa facture au format PDF, avec SIRET et n° de TVA, jointe à un e-mail de remerciement, dès que la commande est réglée.

Transmettre un devis signé

Menuiserie Rousseau & Fils renvoie le devis en PDF à Julien Lefèvre pour validation, joint à un message qui rappelle le délai de réalisation.

Fournir un justificatif

Un cabinet envoie à Nadia Benali son attestation en pièce jointe, accompagnée de quelques lignes d’explication, sans avoir à rouvrir le dossier à chaque demande.

Questions fréquentes

Quels formats de pièce jointe sont acceptés ?

Les formats courants d’un envoi professionnel : PDF avant tout, mais aussi images et documents bureautiques. Le PDF reste le plus sûr pour une facture, car il s’affiche à l’identique chez le destinataire, quel que soit son logiciel.

Y a-t-il une limite de taille pour les fichiers joints ?

Oui, l’e-mail impose une limite pratique : au-delà de quelques mégaoctets, la boîte du destinataire peut refuser le message. Pour un document lourd, mieux vaut le compresser au préalable ou transmettre un lien de téléchargement plutôt qu’une pièce trop volumineuse.

La pièce jointe peut-elle être générée à la volée ?

Oui. Vous pouvez produire la facture ou le document avec une autre capacité du KIT, puis l’attacher directement à l’envoi. Cela évite de stocker le fichier entre les deux étapes.

Mes documents joints sont-ils conservés après l’envoi ?

Le fichier transite par nos serveurs le temps de composer et d’expédier l’e-mail, puisque cet envoi ne se fait pas dans le navigateur. Il sert à la remise, pas à autre chose. N’y placez que ce que le destinataire doit recevoir, dans le respect du RGPD.

Combien coûte l’envoi d’un e-mail avec pièce jointe ?

$0.002 par requête et $0.0035 par message, en dollars US, sans supplément pour la pièce jointe. Vous payez à l’usage ; le coût d’un lot de factures se calcule d’avance selon le nombre de destinataires.

Le destinataire verra-t-il un envoi automatique impersonnel ?

Pas nécessairement. Vous fixez l’expéditeur affiché, l’objet et le texte d’accompagnement, et vous pouvez personnaliser chaque message. Un e-mail automatique bien réglé se distingue peu d’un envoi manuel soigné.

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

POSThttps://api.kit.forhosting.com/notify/email-attachment

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/notify/email-attachment \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"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[&#39;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" => &#39;{"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)

Exemple de requête

{
  "input": "…"
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "notify.email_attachment",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

par e-mail$0.0035

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →