Créer un déclencheur
Sur la page d’édition de votre app, cliquez sur Create Trigger. Nommez-le d’après les données qu’il recevra, par exemple « New application » ou « Candidate updated ». Le déclencheur s’ouvre dans son éditeur. En haut, vous trouverez :- Le nom du déclencheur et sa barre d’adresse avec la méthode de requête
- Try It pour envoyer une requête de test
- Automate This pour créer une automatisation à partir du déclencheur
- Le bouton Activate ou Pause
Choisir la méthode et partager l’adresse
Cliquez sur Copy address et collez l’adresse dans l’outil qui enverra les données. La méthode de requête indique à HireData le type de requête à attendre :
Les requêtes ayant une méthode différente de celle configurée sont rejetées.
Décrire les champs que vous recevrez
La liste Fields we receive indique à HireData ce que contiennent les données, afin que vous puissiez les utiliser dans les automatisations et en tant que variables. Chaque champ possède :- Label : un nom lisible, comme « Contact: First Name »
- Key : l’identifiant dans les données, avec des points pour les valeurs imbriquées, comme
contact.firstName - Type : le type de valeur attendu, comme du texte, un nombre ou une date
- Coller un échantillon
- Envoyer une requête
- Ajouter des champs manuellement
Tant que le déclencheur n’a pas encore de champs, cliquez sur Upload Sample Object et collez ou téléversez un exemple JSON des données que vous enverrez. HireData crée les champs pour vous et détecte automatiquement les e-mails, numéros de téléphone, dates et URL.
Une fois qu’un déclencheur a des champs, les nouvelles requêtes ne les modifient plus. Modifiez la liste manuellement ou effacez-la avant de téléverser un nouvel échantillon.
Le tester avec Try It
Cliquez sur Try It dans l’en-tête du déclencheur pour envoyer une requête sans quitter HireData :- Le formulaire est pré-rempli avec des valeurs d’exemple basées sur vos champs. Ajustez ce que vous voulez.
- Cliquez sur Send.
- Vérifiez la requête à gauche et la réponse à droite.
- Test (par défaut) : crée un événement de test et exécute vos automatisations dans un sandbox sûr. Vous pouvez suivre chaque étape et son résultat, mais rien n’est créé, modifié ou envoyé.
- Live : envoie une vraie requête, exactement comme le ferait votre autre outil.
Le confier à votre développeur
Si quelqu’un d’autre gère l’outil qui enverra les données, les Request Examples en bas du déclencheur lui donnent tout ce dont il a besoin. Vous pouvez copier :- cURL : un exemple de requête prêt à l’emploi pour la ligne de commande
- JSON : un exemple des données attendues par le déclencheur
- OpenAPI : un schéma qui s’importe dans des outils comme Postman
- Copy for LLMs : un document unique décrivant le déclencheur, prêt à être collé dans un assistant IA qui construit l’intégration pour vous
Envoyer des requêtes de test
Toute requête peut être marquée comme un test en ajoutant un en-tête :Synchroniser des personnes
Si les données entrantes décrivent une personne, comme un candidat ou un contact, la section People les mappe sur les enregistrements de personnes dans HireData :- Cliquez sur Add Person et mappez les champs.
- Chaque requête au déclencheur synchronise désormais cette personne automatiquement.
- Les automatisations utilisant le déclencheur peuvent utiliser la personne directement, par exemple comme destinataire d’un e-mail, sans avoir à remapper les champs.
Le transformer en automatisations
Cliquez sur Automate This dans l’en-tête du déclencheur pour créer un brouillon d’automatisation qui démarre chaque fois que le déclencheur reçoit des données. Vous pouvez configurer ses étapes juste après. Les onglets du déclencheur montrent tout ce qu’il fait à un seul endroit :- Automations : les automatisations connectées à ce déclencheur, avec activation, pause, duplication et suppression en masse
- Events : chaque requête reçue par le déclencheur
- Runs : les exécutions d’automatisations lancées par ces événements
- Tasks : les tâches individuelles que ces exécutions ont réalisées
Comment les requêtes sont traitées
Une référence rapide pour quand quelque chose ne se comporte pas comme prévu :- La méthode de la requête doit correspondre à la méthode configurée du déclencheur, sinon elle est rejetée.
- Chaque requête valide est stockée en tant qu’événement, même lorsque l’app ou le déclencheur est en pause. Vous la verrez toujours dans l’onglet Events.
- Les automatisations ne s’exécutent que lorsque l’app et le déclencheur sont tous deux actifs. Si rien ne se passe, vérifiez d’abord ces deux interrupteurs, puis le statut de l’automatisation elle-même et ses filtres de démarrage.
- Les requêtes avec l’en-tête
X-HireData-Test: truesont stockées en tant qu’événements de test et exécutent les automatisations dans un sandbox, sans modifications en direct. - Tant qu’un déclencheur n’a pas de champs, sa première requête est utilisée pour les créer automatiquement.
Besoin d’aide supplémentaire ?
Si un déclencheur ne se comporte pas comme prévu, contactez notre équipe à support@hiredata.com et incluez :- Un lien vers le déclencheur
- L’événement, depuis l’onglet Events
- L’automatisation que vous vous attendiez à voir s’exécuter