Vue d'ensemble
Inklura dispose de trois mécanismes distincts pour le travail récurrent et asynchrone. Ils se situent à différentes couches de la plateforme et s'atteignent de différentes manières. Choisissez celui qui correspond à l'endroit où s'exécute votre code.
Il n'existe aucun système générique d'abonnement à des webhooks sortants pour les tiers — vous ne pouvez pas enregistrer une URL pour qu'Inklura envoie une requête POST à votre service quand « quelque chose se produit ». Voir Sortants pour ce qui existe et ce qui n'existe pas.
Les trois mécanismes
| Mécanisme | Où il s'exécute | Atteint via | À utiliser pour |
|---|---|---|---|
| SDK loopback bext (scheduler / queue / tasks) | Dans une application PRISM | http://127.0.0.1/__bext/sdk/* + en-tête X-Bext-App-Id |
Tâches cron et travail en arrière-plan/relançable appartenant à votre application |
| Files BullMQ du company-manager | Dans le backend Next.js | QUEUE_REGISTRY (interne) |
Diffusion interne à la plateforme (e-mail, SEO, réseaux sociaux, synchronisation commerce, automatisation des workflows) |
| Webhooks entrants des fournisseurs | Récepteurs de la plateforme | https://manage.inklura.fr/api/webhooks/* |
Réception d'événements depuis Stripe, WordPress, fournisseurs e-mail/commerce |
1. SDK loopback bext
Le modèle des applications PRISM. Chaque application atteint le SDK via le loopback de
confiance sur http://127.0.0.1/__bext/sdk/*, authentifié par l'en-tête X-Bext-App-Id
(voir Vue d'ensemble du SDK). Trois surfaces couvrent
le travail récurrent :
- Scheduler — enregistrement de style cron qui envoie une requête POST à l'URL de votre handler selon une cadence. Voir Tâches planifiées.
- Queue — une file de push au moins une fois, avec push-workers, relances et une file de lettres mortes. Voir Queue Workers et SDK → Queue.
- Tasks — un task-executor à chaud pour les jobs de longue durée. Voir SDK → Tasks.
Pour tout travail récurrent au sein d'une application PRISM, préférez le scheduler/queue bext au cron système. Voir Tâches planifiées → Préférer au cron système.
2. Files BullMQ du company-manager
Dans le backend Next.js du company-manager, un QUEUE_REGISTRY déclare un ensemble de files
BullMQ (adossées à Redis). Elles sont internes à la plateforme — vous ne les alimentez pas
depuis une application PRISM ; ce sont les propres routeurs et récepteurs de webhooks du
backend qui le font. Les files déclarées incluent :
webhook,webhook-retryemail-*seo-*,social-*woocommerce,prestashop- files d'automatisation des workflows :
workflow-execution,workflow-node,workflow-scheduled,workflow-webhook
Les webhooks entrants des fournisseurs (mécanisme 3) vérifient leur signature puis
alimentent la file webhook. Un service HTTP autonome de suivi/analytique distinct tourne
à QUEUE_MANAGER_URL (par défaut http://localhost:8085, interne uniquement).
3. Webhooks entrants des fournisseurs
De vrais récepteurs HTTP sous https://manage.inklura.fr/api/webhooks/* pour Stripe,
WordPress, les fournisseurs d'e-mail, les plateformes de commerce, la livraison et les réseaux
sociaux. Chacun vérifie une signature/un secret du fournisseur puis met l'événement en file.
Voir Webhooks entrants pour le catalogue complet.
Lequel me faut-il ?
| Objectif | À utiliser |
|---|---|
| Exécuter quelque chose selon un planning (rapport quotidien, watchdog, tick de facturation) | Tâches planifiées |
| Effectuer un travail en arrière-plan relançable avec diffusion et file de lettres mortes | Queue Workers |
| Exécuter un job long au-delà du délai de rendu | SDK → Tasks |
| Recevoir un événement de Stripe / WordPress / un fournisseur d'e-mail | Webhooks entrants |
| Faire en sorte qu'Inklura appelle votre système externe quand quelque chose se produit | Pas une fonctionnalité en libre-service — voir Sortants |
Sous-pages
| Page | Ce qu'elle couvre |
|---|---|
| Tâches planifiées | Le scheduler bext : enregistrer / lister / annuler, cron, authentification par secret partagé |
| Queue Workers | Enregistrement de push-worker, contrat du handler, file de lettres mortes, enregistrements de jobs durables |
| Webhooks entrants | Le catalogue de récepteurs par fournisseur, vérifier→mettre en file, et le récit honnête des sortants |