ForHosting KIT · Notifications et automatisations

E-mail entrant

Cette capacité fournit une adresse qui reçoit des e-mails et les transforme en déclencheurs. À l’arrivée d’un message, son objet, son texte et ses pièces jointes sont mis à disposition pour la suite : enregistrer, extraire, réexpédier. Elle sert quand ce sont vos correspondants qui écrivent, et que chaque message doit lancer un traitement.

● 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

L’e-mail comme point d’entrée

Habituellement, on pense l’e-mail dans le sens sortant. Ici c’est l’inverse : vous obtenez une adresse à laquelle vos correspondants — ou un système automatique — envoient des messages, et chaque arrivée devient un événement exploitable. L’objet, le corps, l’expéditeur et les pièces jointes sont séparés et remis à disposition. Un formulaire qui envoie sa réponse par e-mail, un fournisseur qui transmet ses factures par message, un service qui notifie par courrier : tout cela cesse de dormir dans une boîte pour alimenter un traitement.

Ce qui est extrait de chaque message

À réception, le message est décomposé en éléments nets : l’expéditeur, la date, l’objet, le texte lisible et la liste des pièces jointes. Ces éléments peuvent ensuite nourrir une autre capacité — extraire les données d’une facture jointe, classer le message, en tirer les points clés. Vous ne travaillez plus sur un e-mail brut mais sur des champs propres. Le HTML des messages est ramené à un texte exploitable, ce qui évite d’avoir à démêler le code de mise en forme.

Enchaîner avec la suite

La force de l’e-mail entrant tient à ce qui vient après : relié à d’autres capacités, il ouvre un circuit complet. Une facture reçue par message est lue, ses montants extraits, un accusé renvoyé — sans qu’une main humaine ouvre la pièce jointe. La configuration se fait depuis cette page ou via l’API. Les applications iOS et Android, l’e-mail et Telegram font partie des canaux du KIT en cours d’ouverture.

Cas d’usage

Recevoir les factures fournisseurs

Menuiserie Rousseau & Fils communique une adresse dédiée à ses fournisseurs ; chaque facture reçue par e-mail est lue et ses données préparées pour la comptabilité, sans saisie manuelle.

Collecter les réponses d’un formulaire

Un formulaire de contact envoie ses réponses à l’adresse dédiée de Studio Lumen SAS, où chaque message est décomposé en champs propres et rangé pour traitement.

Transformer un e-mail en tâche

Élodie Garnier transfère à cette adresse les demandes clients reçues ; chacune déclenche automatiquement l’ouverture d’un suivi, plutôt que de rester à relire à la main.

Questions fréquentes

Comment obtient-on l’adresse de réception ?

Le KIT vous attribue une adresse dédiée à cet usage. Vous la communiquez à vos correspondants ou vous la renseignez dans le système qui doit vous écrire ; tout message qui y arrive est aussitôt pris en charge.

Les pièces jointes des messages reçus sont-elles récupérées ?

Oui. Les fichiers joints sont séparés du message et mis à disposition pour la suite du traitement, par exemple pour lire une facture PDF ou archiver un justificatif. Objet, texte et pièces sont distingués proprement.

Que devient un message une fois traité ?

Il transite par nos serveurs le temps d’être décomposé et transmis à la suite du circuit, puisque cette lecture ne peut pas se faire dans le navigateur. Les contenus servent au traitement demandé et ne sont pas exploités au-delà, dans le respect du RGPD.

Puis-je filtrer les messages indésirables qui arrivent ?

Une adresse publique reçoit forcément du courrier non sollicité. Vous pouvez conditionner la suite du traitement à des critères — expéditeur attendu, objet contenant un mot précis — pour ne déclencher une action que sur les messages légitimes.

Combien coûte la réception d’un e-mail ?

$0.002 par requête et $0.0035 par message traité, en dollars US, selon le même barème que l’envoi. Vous payez à l’usage, sans abonnement, et une facture reste disponible pour votre comptabilité.

L’expéditeur sait-il que son message est traité automatiquement ?

Rien ne l’indique par défaut ; il écrit à une adresse ordinaire. Si vous le souhaitez, vous pouvez renvoyer un accusé de réception automatique pour lui confirmer que son message est bien arrivé.

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-in

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-in \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"input":"…"}'

const res = await fetch("https://api.kit.forhosting.com/notify/email-in", {
  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-in",
    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-in", 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-in", 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_in",
  "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 →