Aller au contenu principal

Recevoir et émettre des événements

Metaventus fait circuler les événements par ses scénarios d'automatisation, dans les deux sens : un scénario peut appeler votre système quand quelque chose se produit, et votre système peut déclencher un scénario en appelant Metaventus.

Il n'y a pas d'abonnement à souscrire par API : un scénario se compose dans l'application, puis s'exécute sans intervention.

Metaventus appelle votre système​

Le nœud Requête HTTP / Webhook sortant émet un appel HTTP vers l'URL de votre choix, au moment où le scénario l'atteint. Le déclencheur peut être un changement de donnée, une date, ou l'aboutissement d'une étape.

La réponse de votre serveur est exploitable par la suite du scénario : {{http.status}} porte le code de statut, {{http.body.clé}} les champs du corps renvoyé. Un scénario peut donc décider de la suite en fonction de ce que votre système répond — créer une tâche si vous renvoyez une erreur, poursuivre sinon.

Répondez rapidement et traitez en asynchrone de votre côté : le scénario attend votre réponse avant de continuer.

Votre système appelle Metaventus​

Le déclencheur Réception d'un webhook ouvre l'entrée inverse. Chaque déclencheur porte une clé de webhook que vous choisissez (par exemple erp-commandes) et qui identifie le scénario à démarrer. Votre système poste sur cette entrée, le scénario s'exécute avec les données reçues : créer un contact, mettre à jour une opportunité, envoyer un message.

Choisir entre webhook et interrogation​

Interroger l'API en boucle pour détecter un changement consomme votre quota et introduit un retard égal à la période d'interrogation. Un scénario qui vous appelle au moment de l'événement supprime les deux. Réservez l'interrogation aux rattrapages — après une panne de votre côté, par exemple — en filtrant sur une date de modification.