ForHosting KIT · Notifications et automatisations

Tâches conditionnelles

Cette capacité introduit un aiguillage dans un circuit de tâches : selon le résultat d’une étape, la suite emprunte un chemin plutôt qu’un autre. Si telle condition est vraie, on fait ceci ; sinon, cela. Elle sert quand un traitement ne doit pas être identique pour tous les cas. Cette fonction est en version bêta.

● Betapar requête + par étape$0.000

Voir l’API — $0.000 Voir l’API

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

Un circuit qui décide

Un enchaînement classique déroule toujours les mêmes étapes dans le même ordre. Le conditionnel ajoute la capacité de choisir : au vu de ce qu’a produit une étape, le circuit prend une branche ou une autre. Un message clair reçoit une réponse automatique ; un message ambigu est mis de côté pour un humain. Une facture conforme part en comptabilité ; une facture douteuse déclenche une alerte. Le traitement cesse d’être uniforme et s’ajuste au contenu réel, ce qui évite d’appliquer la même recette à des situations qui n’ont rien à voir.

Poser la condition

Vous définissez le test qui décide de l’aiguillage : une valeur dépasse-t-elle un seuil, un texte contient-il un mot, un contrôle est-il réussi ? Selon la réponse, vrai ou faux, le circuit exécute la branche correspondante. Chaque branche peut contenir une ou plusieurs étapes, elles-mêmes de simples capacités du KIT. On peut aussi prévoir le cas où aucune condition n’est remplie, pour qu’aucune situation ne reste sans issue. La logique reste lisible : une question, deux chemins.

Version bêta et mise en place

Cette capacité est proposée en bêta : elle est utilisable, mais ses réglages peuvent encore changer, et nous préférons vous en avertir avant que vous ne l’installiez sur un usage sensible. Le conditionnel se compose depuis cette page ou via l’API, et se marie avec l’enchaînement, l’exécution en parallèle et les notifications. Les applications iOS et Android et Telegram comptent parmi les canaux du KIT en cours d’ouverture.

Cas d’usage

Trier les messages entrants

Studio Lumen SAS envoie une réponse automatique aux demandes simples et met de côté, pour un humain, celles dont le contenu sort du cadre prévu.

Contrôler une facture avant traitement

Menuiserie Rousseau & Fils fait passer en comptabilité les factures dont le montant est cohérent, et déclenche une alerte pour celles qui dépassent un seuil inhabituel.

Adapter la suite à un score

Thomas Rousseau oriente une demande vers un suivi prioritaire ou vers la file ordinaire selon un score calculé à l’étape précédente.

Questions fréquentes

Que veut dire « version bêta » ici ?

La capacité fonctionne, mais elle est encore en cours d’ajustement : la manière de poser les conditions ou de décrire les branches peut évoluer. Nous le signalons pour que vous en teniez compte avant un usage critique.

Que se passe-t-il si aucune condition n’est remplie ?

Vous pouvez prévoir une branche par défaut, empruntée quand aucun test n’est vrai. Sans elle, le circuit s’arrête simplement faute de chemin ; définir ce cas garantit qu’aucune situation ne reste sans traitement.

Sur quoi peut porter la condition ?

Sur le résultat de l’étape précédente : une valeur comparée à un seuil, la présence d’un mot dans un texte, la réussite ou l’échec d’un contrôle. Le test rend une réponse vraie ou fausse qui décide de la branche.

Comment le prix est-il établi avec des branches ?

Vous ne payez que les étapes réellement exécutées, c’est-à-dire la branche empruntée, pas celle qui est écartée. Le total suit la même règle que l’enchaînement : somme des étapes parcourues, majorée de 20 %, en dollars US.

Peut-on enchaîner plusieurs conditions ?

Oui, une branche peut à son tour contenir un aiguillage, ce qui permet des décisions plus fines. Il vaut mieux garder l’ensemble lisible : une logique trop ramifiée devient difficile à suivre et à vérifier.

Les données évaluées passent-elles par vos serveurs ?

Oui : l’évaluation de la condition se fait côté serveur, comme le reste du circuit. La donnée testée sert à décider du chemin, sans autre exploitation. Ne confiez au circuit que ce qui est nécessaire, dans le respect du RGPD.

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/flow/conditional

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

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

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 →