Vue d'ensemble
Les fonctionnalités marketing et support d'Inklura sont livrées par des applications outils (SMS Designer, Mail Designer, SEO, la console). Selon la fonctionnalité, vous les pilotez de deux façons :
| Surface | Adresse | Usage typique |
|---|---|---|
| API Plateforme (tRPC) | https://manage.inklura.fr/api/trpc/* |
Campagnes e-mail, statistiques de campagne, journeys, base de connaissances. |
| Routes d'une application outil | par ex. https://smsdesigner.inklura.fr/api/* |
Les actions propres à un outil : campagnes SMS, rapports SEO. |
L'API Plateforme est documentée sous API Plateforme ; ses
conventions d'appel (enveloppes superjson, result.data.json, authentification Bearer)
s'appliquent à chaque procédure tRPC citée dans cette section. Les routes des applications
outils citées dans cette section sont protégées par la session de l'utilisateur connecté (un
cookie posé à la connexion à l'outil, pas un jeton Bearer) : sans cette session, elles
refusent la requête.
Si vous construisez votre propre application sur le framework, le stockage et le travail en arrière-plan passent par le SDK : voir Vue d'ensemble du SDK, KV, Queue et Tasks.
Les surfaces d'intégration
| Surface | Point d'entrée principal |
|---|---|
| Campagnes SMS | POST /api/campaigns (SMS Designer) |
| E-mail et MJML | routers campaigns et emailAnalytics, Mail Designer |
| Journeys marketing | router journeys |
| Rapports SEO | POST /api/seo/reports (application SEO) |
| Helpdesk et base de connaissances | router helpdeskKb, console /manage/helpdesk |
Ce qui est automatique et ce qui ne l'est pas
Certaines fonctionnalités sont partielles. Tenez-en compte avant de construire dessus.
Le taux de livraison SMS est saisi à la main. L'opérateur SMS ne renvoie pas d'accusés de réception. Dans les rapports, « Délivrés » affiche une estimation de référence (95 %) tant que personne n'a saisi le chiffre réel, et « Lus » reste toujours une estimation. Les clics, eux, sont mesurés. Voir Campagnes SMS.
Dans un journey, seule l'étape EMAIL agit. L'étape SMS est ignorée, et les étapes
WEBHOOK, UPDATE_FIELD, ADD_TO_SEGMENT, REMOVE_FROM_SEGMENT, CREATE_TASK et
SEND_NOTIFICATION se contentent de faire avancer le contact. Une étape WEBHOOK n'émet
pas de requête sortante. WAIT, CONDITION et GOAL ne font rien quand ils s'exécutent
(l'attente vient du delayMinutes de chaque étape), et CONDITION n'évalue aucun branchement. Voir Journeys marketing.
La planification SMS est confiée à l'opérateur. Une campagne SMS programmée est remise à l'opérateur avec son heure d'envoi, et c'est lui qui la déclenche.
Où aller ensuite
| Page | Ce qu'elle couvre |
|---|---|
| Campagnes SMS | L'API d'action /api/campaigns, la planification, le taux de livraison, les rapports publics |
| E-mail et MJML | Mail Designer, les routers campaigns et emailAnalytics, le suivi des ouvertures et des clics |
| Journeys marketing | Le router journeys, les déclencheurs, les types d'étapes, les modèles et l'enrôlement |
| Rapports SEO | Les sources de données et la génération de rapports (POST /api/seo/reports + SSE) |
| Helpdesk et base de connaissances | Le router helpdeskKb et les tickets |
Connecter Mahalo
Connecteur Opper / Mahalo — API transactionnelle compatible Opper, configuration Mahalo et événements de livraison.