API, webhooks et formulaire d'inscription : relier Kaliio à votre site
Vérifié sur l'application le
À quoi ça sert
Trois outils relient Kaliio à votre site internet ou à vos automatisations (Zapier, Make, n8n…), sans ressaisie :
- l'API REST lit votre catalogue, vos sessions à venir et leurs places restantes, vos clients, et crée clients, sessions et inscriptions ;
- les webhooks préviennent votre outil dès qu'un événement se produit : inscription, dossier validé, session programmée ou terminée, document signé, questionnaire rempli, émargement signé ;
- le formulaire d'inscription en ligne, à intégrer dans votre site, transforme une demande de stagiaire en dossier « À valider ».
Ces outils sont inclus dans le plan gratuit. La documentation technique, avec des exemples, est sur la page Développeurs.
Où le trouver
Paramètres > onglet Intégrations : cartes Clés d'API, Webhooks et Formulaire d'inscription en ligne
Documentation technique : page Développeurs du site (kaliio.fr/developpeurs)
Pas à pas
Créez une clé d'API
Carte Clés d'API : cliquez sur Nouvelle clé, donnez un Nom de la clé, choisissez les Permissions (Lecture seule pour afficher vos sessions, Lecture et écriture (recommandé) pour inscrire des stagiaires), puis Créer la clé. Copiez-la avec Copier la clé : elle ne sera plus jamais affichée. Transmettez-la à la personne qui gère votre site.
Branchez votre site sur l'API
La clé s'envoie dans l'en-tête « Authorization: Bearer » suivi de la clé, à chaque requête, depuis le serveur de votre site, jamais depuis une page web. Les adresses, les champs et des exemples prêts à copier sont sur la page Développeurs.
Ajoutez un webhook
Carte Webhooks : cliquez sur Nouveau webhook, saisissez l'Adresse (URL) de votre outil (elle commence par https://), cochez les Événements envoyés, puis Enregistrer. Copiez le secret de signature avec Copier le secret : votre outil s'en sert pour vérifier que chaque envoi vient bien de Kaliio.
Testez et suivez les envois
Dans le menu d'actions d'un webhook, Envoyer un test envoie un événement d'essai et affiche la réponse de votre outil. Le tableau Dernières livraisons montre chaque envoi : Livré, En attente d'un nouvel essai, Échec ou Annulé.
Ouvrez le formulaire d'inscription en ligne
Carte Formulaire d'inscription en ligne : activez Ouvrir le formulaire. Partagez le Lien à partager, ou collez le Code à coller dans votre site (bouton Copier le code) dans une page de votre site. Il faut d'abord avoir choisi l'adresse de votre vitrine dans l'onglet Vitrine.
Ce que fait une demande d'inscription en ligne
Le formulaire propose vos sessions programmées, à venir et non complètes. Le stagiaire choisit sa session, saisit ses coordonnées (et son entreprise s'il en a une), accepte l'utilisation de ses informations et envoie.
Kaliio crée alors le client (l'entreprise indiquée, sinon un particulier au nom du stagiaire), le stagiaire et un dossier au statut À valider, avec le message éventuel du stagiaire dans les notes. Vous recevez un email. Comme tout dossier d'une session programmée, ce dossier « À valider » reçoit déjà les envois automatiques de la session : la convocation lui indique que son inscription reste à confirmer. Si la demande ne vous convient pas, annulez ou supprimez le dossier : ses envois en attente sont annulés.
Le formulaire reprend votre logo et votre couleur de marque. Il est protégé contre les robots, et une même connexion ne peut pas envoyer plus de 5 demandes en 10 minutes.
Quand votre outil ne répond pas
Un envoi est réussi quand votre outil répond par un code 2xx en moins de 10 secondes. Sinon, Kaliio réessaie 1 minute, 5 minutes, 30 minutes puis 2 heures plus tard : 5 essais au plus.
Après 3 événements de suite non livrés, le webhook est Désactivé et vous êtes prévenu par email. Corrigez votre outil, puis choisissez Réactiver dans le menu d'actions du webhook. Pour changer de secret (par exemple s'il a été divulgué), choisissez Nouveau secret : l'ancien cesse aussitôt de signer.
Sécurité et limites
- Une clé ne donne accès qu'aux données de votre organisme. Une clé Lecture seule ne peut rien modifier. Révoquer coupe l'accès immédiatement.
- L'API ne supprime rien : les suppressions se font dans l'application, et les preuves signées restent conservées 5 ans.
- Une clé peut faire 120 requêtes par minute.
- Les webhooks ne partent que vers une adresse HTTPS publique : jamais vers un réseau interne.
Indicateurs Qualiopi concernés
Cette fonction ne correspond pas directement à un indicateur Qualiopi : elle facilite l'usage de Kaliio.
Questions fréquentes
Non. Ils sont inclus dans le plan gratuit, comme le formulaire d'inscription en ligne.
Oui : une clé créée dans Clés d'API ouvre à la fois l'API REST et le serveur MCP. Créez une clé par outil pour pouvoir les révoquer séparément.
Non, par défaut le dossier est créé À valider, et votre site peut demander un dossier déjà validé. Dans les deux cas, comme dans l'application, les stagiaires d'une session programmée reçoivent les envois automatiques ; la convocation d'un dossier À valider indique que l'inscription reste à confirmer.
Ajoutez l'identifiant de la session à la fin du lien du formulaire (lien à partager, puis /identifiant). L'identifiant figure dans l'adresse de la session dans Kaliio et dans les réponses de l'API.
Essayez dans votre espace Kaliio
Toutes les fonctions Qualiopi sont incluses dans le plan gratuit, sans carte bancaire. Premium ajoute l'espace illimité, le support prioritaire et votre marque sur les emails et le catalogue.
Créer mon compte gratuitSans carte bancaire · Sans engagement
En savoir plus sur le logiciel Qualiopi gratuit