ForHosting KIT · Notifications et automatisations

Notifications par webhook

Un webhook est un appel qu’un système envoie à un autre pour le prévenir qu’il vient de se passer quelque chose. Cette capacité déclenche cet appel : à l’événement, le KIT contacte l’adresse que vous indiquez et lui remet les données. Elle sert à relier deux outils pour qu’ils réagissent l’un à l’autre.

● Stablepar requête + par livraison$0.002

Lancer — $0.002 Voir l’API

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

Exécuter en ligne

Exécutez cette tâche sur nos serveurs, avec votre compte. Les outils gratuits tournent dans votre navigateur ; celui-ci est facturé sur votre solde KIT au prix affiché ci-dessus.

Prévenir une machine, pas une personne

Là où l’e-mail avertit un humain, le webhook avertit un logiciel. Vous indiquez l’adresse d’un service — le vôtre ou celui d’un outil tiers — et, chaque fois que l’événement se produit, le KIT y envoie un appel contenant les détails. Le service destinataire reçoit l’information à l’instant et fait ce qu’il a à faire : enregistrer, déclencher une action, mettre à jour un tableau. C’est le fil invisible qui permet à deux applications de se parler sans que personne recopie l’information de l’une à l’autre.

Ce que reçoit le destinataire

L’appel transporte les données de l’événement sous une forme structurée, prête à être lue par un programme. Vous choisissez l’adresse de destination et, selon les besoins du service visé, le format et les en-têtes attendus. Le KIT effectue l’appel et note le résultat : accepté, refusé, injoignable. Cette trace vous dit si l’autre bout a bien reçu la notification, information précieuse quand un maillon reste silencieux et qu’il faut savoir de quel côté chercher.

Configurer et intégrer

Le webhook se met en place depuis cette page, où vous renseignez l’adresse cible et testez l’appel, ou via l’API pour l’inscrire dans un circuit plus large. Il se marie naturellement avec les autres capacités : un traitement se termine, un webhook prévient l’application suivante. Les applications iOS et Android, l’e-mail et Telegram comptent parmi les canaux du KIT en cours d’ouverture, pour toucher aussi bien les machines que les personnes.

Cas d’usage

Relier une commande à un outil interne

À chaque commande sur la boutique d’Atelier Garnier SARL, un webhook prévient le logiciel de préparation, qui ouvre aussitôt le bon de préparation sans ressaisie.

Alimenter un tableau de suivi

Studio Lumen SAS fait notifier son outil de gestion de projet dès qu’un livrable est validé, pour que le suivi se mette à jour tout seul.

Déclencher une action tierce

Menuiserie Rousseau & Fils relie la réception d’un devis signé à un service qui archive le document, l’un prévenant l’autre par webhook au moment exact.

Questions fréquentes

En quoi un webhook diffère-t-il d’un e-mail de notification ?

L’e-mail s’adresse à une personne qui le lit ; le webhook s’adresse à un programme qui l’exploite. Le premier informe, le second déclenche une action automatique chez le destinataire. On choisit selon que la suite est humaine ou logicielle.

Comment savoir si l’autre application a bien reçu l’appel ?

Chaque appel renvoie un résultat : le service destinataire a répondu qu’il acceptait, il a refusé, ou il était injoignable. Cette trace permet de repérer un maillon défaillant et de savoir de quel côté de la chaîne se situe le problème.

Que faire si le service destinataire est momentanément indisponible ?

Un appel peut échouer si l’autre bout ne répond pas. En reliant le webhook à la relance automatique, vous faites retenter l’appel après un délai, ce qui absorbe les indisponibilités passagères sans perdre la notification.

Les données envoyées transitent-elles par vos serveurs ?

Oui : l’appel part de nos serveurs vers l’adresse que vous indiquez, il ne peut pas venir du navigateur. Les données servent à composer et à émettre la notification, sans autre exploitation. Ne transmettez que le nécessaire, conformément au RGPD.

Combien coûte l’envoi d’un webhook ?

$0.002 par appel émis, en dollars US, sans coût par unité supplémentaire. Vous payez à la notification effectivement envoyée, sans abonnement, et une facture reste disponible pour votre comptabilité.

Puis-je sécuriser l’appel pour que le destinataire vérifie l’origine ?

Oui, c’est recommandé. Le service qui reçoit doit pouvoir s’assurer que l’appel vient bien de vous ; une signature jointe à l’appel, vérifiable de l’autre côté, remplit ce rôle et écarte les appels frauduleux.

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/webhook

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

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

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 →