Vue d'ensemble
Pour le travail récurrent et asynchrone, vous disposez des outils du SDK dans vos propres applications. De son côté, la plateforme reçoit les événements de vos fournisseurs (paiement, commerce, e-mail…) et les traite en arrière-plan.
Il n'existe pas d'abonnement générique à des webhooks sortants : vous ne pouvez pas enregistrer une URL pour qu'Inklura appelle votre service quand un événement de la plateforme se produit. Voir Webhooks entrants pour ce qui existe et les alternatives.
Les mécanismes
| Mécanisme | Où il s'exécute | À utiliser pour |
|---|---|---|
| SDK : scheduler, queue, tasks | Dans votre application | Tâches planifiées et travail en arrière-plan de votre application |
| Traitements de la plateforme | Sur la plateforme | Envois d'e-mails, SEO, réseaux sociaux, synchronisation des boutiques, automatisations. Vous ne les pilotez pas directement. |
| Webhooks entrants | https://manage.inklura.fr/api/webhooks/* |
Recevoir les événements de Stripe, WordPress, des fournisseurs d'e-mail ou de commerce |
Le SDK dans votre application
Le SDK authentifie votre application automatiquement et cloisonne ses données. Trois outils couvrent le travail récurrent et asynchrone :
- Scheduler : exécute une tâche ou appelle une route de votre application selon une expression cron. Voir Tâches planifiées.
- Queue : une file de messages livrés au moins une fois à un handler, avec relances et file de lettres mortes. Voir Queue Workers et SDK → Queue.
- Tasks : des jobs de longue durée avec statut, progression et résultat. Voir SDK → Tasks.
Les traitements de la plateforme
La plateforme traite en arrière-plan ses propres files : envois d'e-mails, rapports SEO, publications sur les réseaux sociaux, synchronisation WooCommerce et PrestaShop, exécution des automatisations. Elles ne sont pas accessibles depuis une application : vous agissez dessus via l'API Plateforme (par exemple en envoyant une campagne), et la plateforme s'occupe du reste.
Les webhooks entrants
Des récepteurs HTTP sous https://manage.inklura.fr/api/webhooks/* reçoivent les événements
de Stripe, WordPress, des fournisseurs d'e-mail, des plateformes de commerce, de livraison et
des réseaux sociaux. Chaque récepteur est propre à son fournisseur : vous configurez le côté
fournisseur en connectant l'intégration. Voir Webhooks entrants pour la
liste et pour la façon dont les récepteurs Stripe, WordPress et PrestaShop authentifient les
requêtes.
Lequel choisir
| Objectif | À utiliser |
|---|---|
| Exécuter quelque chose selon un planning (rapport quotidien, contrôle régulier, facturation mensuelle) | Tâches planifiées |
| Traiter du travail en arrière-plan, avec relances et file de lettres mortes | Queue Workers |
| Exécuter un job long, au-delà du délai d'une requête | SDK → Tasks |
| Recevoir un événement de Stripe, de WordPress ou d'un fournisseur d'e-mail | Webhooks entrants |
| Faire appeler votre système externe par Inklura | Pas disponible en libre-service. Voir Webhooks entrants |
Sous-pages
| Page | Ce qu'elle couvre |
|---|---|
| Tâches planifiées | Le scheduler : enregistrer, lister, annuler, sécuriser la route appelée |
| Queue Workers | Enregistrer un worker, contrat du handler, lettres mortes, suivi des jobs |
| Webhooks entrants | Les récepteurs par fournisseur, l'authentification des requêtes, les envois sortants |