Pour les développeurs
Connectez Workbots à vos outils avec les webhooks et l'API.
Workbots centralise vos formations, vos apprenants et vos documents. Votre organisme utilise sans doute d'autres outils : un CRM, un tableur partagé, un site vitrine, un outil d'automatisation comme Make ou Zapier. La section Développeur sert à faire circuler l'information entre Workbots et ces outils, sans ressaisie.
La section Développeur est en cours de déploiement. L'interface est visible dans votre espace, sous Paramètres → Développeur. Cette page décrit ce que vous y voyez et comment les deux mécanismes sont conçus.
Ce que vous pouvez connecter
Deux mécanismes complémentaires sont proposés. L'un et l'autre s'organisent autour de vos sept bases de données : apprenants, entreprises, intervenants, lieux, financeurs, établissements et maîtres d'apprentissage.
Webhooks
Workbots prévient votre serveur dès qu'un événement se produit. Vous ne demandez rien, l'information arrive toute seule.
Clés API
Votre script interroge Workbots quand il en a besoin, pour lire ou pour écrire des données.
Webhooks ou API, comment choisir
Les deux mécanismes répondent à des besoins différents. Rien ne vous empêche d'utiliser les deux en même temps.
| Votre besoin | Le mécanisme | Le sens de la circulation |
|---|---|---|
| Être averti dès qu'un apprenant est créé | Un webhook | Workbots vers vous |
| Recopier chaque nouvelle entreprise dans votre CRM | Un webhook | Workbots vers vous |
| Déclencher un scénario Make ou Zapier | Un webhook | Workbots vers vous |
| Exporter la liste de vos apprenants chaque mois | Une clé API | Vous vers Workbots |
| Créer des apprenants depuis votre formulaire d'inscription | Une clé API | Vous vers Workbots |
| Alimenter un tableau de bord interne | Une clé API | Vous vers Workbots |
Une image simple : le webhook, c'est la sonnette de votre porte, Workbots vous prévient qu'il se passe quelque chose. La clé API, c'est la clé de la porte, c'est vous qui entrez chercher ce dont vous avez besoin.
Faut-il être développeur
Pas nécessairement.
- Pour les webhooks, un outil sans code comme Make ou Zapier suffit dans la plupart des cas. Vous collez dans Workbots une adresse fournie par l'outil, puis vous construisez votre scénario à la souris.
- Pour les clés API, il faut savoir écrire un script, ou utiliser un outil capable d'appeler une API. L'aide d'un développeur est utile.
Où trouver vos identifiants
Tout se passe au même endroit.
Ouvrez les paramètres
Cliquez sur votre nom en haut à droite, puis sur Paramètres.
Ouvrez l'onglet Développeur
Dans la liste des onglets (Organisme de formation, Organigramme, Procédures Qualité, Intégrations, Développeur, Branding, Facturation), sélectionnez Développeur.
Capture à venir
L'onglet Développeur dans les paramètres
Choisissez la sous-section
Deux sous-onglets sont disponibles : Webhooks et Clés API. Le premier regroupe vos endpoints, votre clé de signature et le journal des livraisons. Le second regroupe vos clés et leurs autorisations.
Le vocabulaire à connaître
Les données concernées
Les événements et les autorisations portent sur les sept bases de la section Mes données.
| Base | Événements | Autorisations |
|---|---|---|
| Apprenants | apprenant.* | read:apprenants, write:apprenants |
| Entreprises | entreprise.* | read:entreprises, write:entreprises |
| Intervenants | intervenant.* | read:intervenants, write:intervenants |
| Lieux | lieu.* | read:lieux, write:lieux |
| Financeurs | financeur.* | read:financeurs, write:financeurs |
| Établissements | etablissement.* | read:etablissements, write:etablissements |
| Maîtres d'apprentissage | maitre_apprentissage.* | read:maitres-apprentissage, write:maitres-apprentissage |
Les données restent cloisonnées par organisme. Un webhook et une clé API ne voient que les données de votre espace.