Webhooks

Actito a pour vocation de vous proposer une grande connectivité dans votre approche marketing. De ce fait, nous veillons particulièrement à permettre les échanges de données entre Actito et les autres systèmes, propres à votre activité.

Plusieurs solutions vous permettent d'interagir directement avec Actito sans devoir passer par l'interface. L'API publique d'Actito vous permettaient déjà d'appeler des données présentes dans Actito et d'envoyer des données vers Actito.

Les Webhooks vous offrent le service inverse des Webservices. Il n'est plus nécessaire de faire un appel à chaque fois que vous avez besoin d'une information. En effet, les Webhooks sont à l'écoute de l'information. En vous abonnant à des Webhooks, ceux-ci vous permettent d'être notifié directement d'événements survenus sur un profil ou une entrée dans une table mauve. Ces événements seront communiqués sur une URL que vous avez renseignée.

Avertissement

Cette section de la documentation plateforme sert à vous donner une perspective business de ce qui est possible de faire à travers la plateforme d'intégration d'Actito

Pour les détails d'implémentation, les dévelopeurs doivent toujours se référer aux spécifications sur le Developers Portal.

Contexte

Événements concernés

Les Webhooks vous permettent d'être notifié des événements concernant les tables de profils et les tables personnalisées du modèle de données.

Ces événements sont de la nature suivante :

• CREATE : Ceci vous permet d'être notifié lors de la création d'un nouveau profil ou d'un nouvel enregistrement de données

• UPDATE : Ceci vous permet d'être notifié à chaque changement sur un profil ou sur un enregistrement de données. Il est possible de spécifier exactement quels champs de la table doivent être pris en compte

• DELETE : Ceci vous permet d'être notifié lors de la suppression d’un profil ou d’un enregistrement

• UPDATED_SEGMENT et UPDATED_SUBSCRIPTION : Ces événements sont spécifiques aux tables de profils. Ils vous permettent d'être notifié lors d'un changement d'abonnement ou de segmentation

A savoir

Pour les tables personnalisées du modèle en étoile, il est nécessaire que les événements soient précisés dans le fichier JSON de définition de la table (dans le paramètre "eventToTrigger").
Un événement CREATE existe toujours par défaut dans les tables personnalisées, mais les événements d'UPDATE doivent être définis (notamment pour définir les mises à jour de quels champs déclenchent un événement).
N'hésitez pas à contacter votre gestionnaire de compte si vous avez besoin d'aide pour mettre en place des événements dans vos tables.

En plus de récupérer les informations de vos tables, les webhooks peuvent aussi récupérer les statuts de vos ETLs et synchronisation de de fichier, ou connecter vos scenarios à des systèmes externes grâce aux custom actions.

Protocole

Chaque fois qu'un événement correspondant à la définition de l'abonnement Webhook est enregistré dans Actito, le Webhook va pousser l'information sur l'URL que vous avez renseignée.

Pour vous aider à gérer les plus gros volumes, les appels peuvent être faits en mode unitaire ou en masse. Le mode de masse est utile quand plusieurs éléments sont impactés en même temps (comme dans un import par fichier), pour regrouper les mises à jours dans un appel. Néanmoins, lew webhooks récupèrent toujours l'information en temps réel : même en mode de masse, si 1 événement est enregistré et qu'un 2em événement n'est pas enregistré dans les secondes qui suivent, la notification par webhook sera envoyée.

Accès

Pour recevoir des notifications chaque fois qu'un des événements survient dans la table écoutée, il est nécessaire de créer un abonnement à un Webhook. Un abonnement Webhook doit être créé par événement écouté et par table écoutée.

La création et la gestion de ces abonnements se fait via les APIs d'Actito. Leur définition est disponible sur la documentation technique.