Principes Fondamentaux des Webhooks

Interrogation vs. Webhooks

Zapier demande périodiquement à l’application Y a-t-il du nouveau, de la même manière que l’on actualise sa boîte mail toutes les quelques minutes. Cette méthode d’interrogation est intégrée à la plupart des intégrations Zapier et se configure facilement via des options déroulantes simples.

# Event happens in app
    ↓
# [Time passes — 1 to 15 minutes]
    ↓
# Zapier checks and finds the event
    ↓
# Zap runs

Avec les déclencheurs webhook, l’application envoie activement des données à Zapier dès qu’un événement se produit.

# Event happens in app
    ↓
# App immediately sends data to Zapier URL
    ↓
# Zap runs instantly

Ce fonctionnement est similaire aux notifications push sur votre téléphone : dès qu’un événement survient, vous êtes notifié instantanément, sans délai. Cela nécessite une configuration manuelle dans l’application source, l’application doit prendre en charge les webhooks, et cette méthode peut être utilisée même en l’absence d’intégration native Zapier.

Compréhension des données Webhook (JSON)

Lorsque des données arrivent sur votre webhook, elles sont généralement au format JSON (JavaScript Object Notation). Une connaissance approfondie du JSON n'est pas nécessaire, mais comprendre les bases est utile.

Lorsque cela atteint votre webhook, Zapier analyse la charge utile et transforme chaque valeur en un champ exploitable :

• name → "John Smith";
• email → john@example.com;
• company → "Acme Corp";
• deal_value → 15000.

Ces champs apparaissent dans le sélecteur de champs comme les données de tout autre déclencheur. Les webhooks simples envoient seulement quelques champs, ce qui les rend faciles à utiliser directement, tandis que les webhooks complexes envoient des données imbriquées avec des dizaines de champs.

Zapier a généralement tendance à aplatir les données imbriquées afin de les rendre facilement accessibles. Pour des valeurs fortement imbriquées, il peut être nécessaire d'utiliser une étape Formatter ou Code pour les extraire, ce qui sera abordé dans les sections suivantes.

Quand et comment utiliser les webhooks

Utiliser les webhooks pour une automatisation instantanée et en temps réel ou lorsqu'une application ne dispose pas d'intégration Zapier. Ils sont idéaux pour les systèmes internes personnalisés, les outils SaaS spécialisés ou récents, et les plateformes de paiement qui envoient des événements tels que des achats ou des abonnements. Même les applications disposant d'intégrations natives Zapier peuvent proposer des webhooks pour des déclencheurs plus rapides ou des données d'événement plus riches.

Comme une URL de webhook déclenche directement votre Zap, il est important de la garder privée, de tester avec des données réelles et de surveiller l'historique du Zap pour détecter d'éventuelles erreurs. Les paramètres de webhook se trouvent généralement dans les sections Intégrations, API, Notifications ou Paramètres développeur de l'application source.