Les webhooks vous permettent de recevoir automatiquement des données depuis Pinpo dès qu'un événement a lieu (fin de traitement d'une qualification, appel entrant, etc.). C'est le canal de sortie de Pinpo : chaque fois qu'une qualification change d'état, Pinpo envoie les données en temps réel vers l'URL de votre choix, sans intervention manuelle.
Pour y accéder, cliquez sur Intégration dans le menu latéral gauche, puis sur le bouton Accéder de la carte Connexion via Webhook.
---
Comment fonctionne un webhook ?
Comment fonctionne un webhook ?
Le principe est simple : vous indiquez à Pinpo une URL (celle de votre CRM, de votre outil d'automatisation ou de votre serveur), vous choisissez un agent et un type d'événement, et Pinpo envoie automatiquement un payload JSON via une requête HTTP POST à cette URL, chaque fois que l'événement se produit pour cet agent.
Votre système reçoit les données en temps réel et peut les traiter immédiatement (mise à jour du CRM, déclenchement d'un workflow, notification, etc.).
Quels sont les types d'événements disponibles ?
Quels sont les types d'événements disponibles ?
Chaque webhook est déclenché par un type d'événement spécifique :
Remarque : Vous pouvez configurer plusieurs webhooks pour le même type d'événement sur des agents différents, et plusieurs webhooks pour le même agent sur des événements différents. Chaque combinaison agent + événement + URL constitue un webhook distinct.
Comment ajouter un webhook ?
Comment ajouter un webhook ?
Cliquez sur le bouton + Ajouter en haut à droite de la section.
Renseignez les informations demandées :
URL — L'endpoint qui recevra les données. Il doit accepter des requêtes HTTP POST avec un payload JSON.
Agent — L'agent dont vous souhaitez recevoir les événements.
Type d'événement — L'événement déclencheur.
Validez. Le webhook apparaît dans le tableau avec le toggle Actif activé par défaut.
Comment lire la liste des webhooks ?
Comment lire la liste des webhooks ?
La section Vos webhooks affiche un tableau récapitulatif de tous les webhooks configurés pour votre organisation :
Comment récupérer des JSON d’exemples de sortie webhook ou tester la bonne réception du JSON sur votre URL?
Comment récupérer des JSON d’exemples de sortie webhook ou tester la bonne réception du JSON sur votre URL?
Ouvrez la liste des webhooks.
Cliquez sur Voir
Cliquez sur **Tester. **
Vous trouverez dans la liste déroulante des Type de contact, plusieurs exemples de JSON.
Sélectionnez l’exemple désiré.
Vous pouvez récupérer le JSON OU vous pouvez cliquer sur le bouton **Tester la configuration. **
Vous recevrez sur votre URL le JSON.
Comment gérer un webhook existant ?
Comment gérer un webhook existant ?
Activer ou désactiver un webhook
Activer ou désactiver un webhook
Cliquez sur le toggle dans la colonne Actif pour activer ou désactiver un webhook. Un webhook désactivé reste configuré mais n'envoie plus de données. C'est utile pour suspendre temporairement la réception sans perdre la configuration (par exemple pendant une maintenance de votre système).
Consulter le détail d'un webhook
Consulter le détail d'un webhook
Cliquez sur le lien Voir à droite de la ligne pour accéder au détail du webhook : URL complète, historique des envois, statut des dernières livraisons, etc.
Comment incorporer les données dans votre environnement ?
Comment incorporer les données dans votre environnement ?
Après avoir configuré sur la plateforme la ou les URL(s) sur lesquelles vous souhaitez recevoir les mises à jour, vous recevrez sur le webhook de votre choix (votre point de terminaison) des requêtes contenant un payload JSON respectant la structure indiquée dans notre documentation API.
Il vous appartient désormais d'intégrer ces données dans votre environnement.N'oubliez pas qu'en raison de la nature asynchrone des conversations, vous pouvez recevoir, au fil du temps, plusieurs informations différentes concernant un même prospect. Cela signifie que :
un même prospect peut être envoyé plusieurs fois sur votre webhook au fil du temps.
les champs
summaryet/ousegmentationqui vous sont renvoyés pour un même prospect peuvent évoluer au fil du temps.
Voici ce que nous vous recommandons de faire dans votre intégration en fonction de chaque segmentation :
REMARQUE : La segmentation est unique ; il n'y a toujours au maximum qu'une seule valeur, et une seule. Si vous souhaitez obtenir tous les détails concernant vos prospects, consultez les autres parties du JSON.
🌟 - Bonnes pratiques
ℹ️ Vous pouvez récupérer différents exemples des différents cas de figure directement sur la plateforme.
Un webhook par agent pour la fin de traitement. C'est la configuration de base. Elle garantit que chaque qualification terminée remonte dans votre système, quel que soit l'agent.
Testez votre endpoint avant de l'activer. Envoyez un contact de test à l'agent, laissez la conversation se terminer, et vérifiez que votre endpoint reçoit bien le payload attendu avec les bonnes données.
Gérez les erreurs côté réception. Votre endpoint doit répondre avec un code HTTP 200 pour confirmer la bonne réception. En cas d'erreur (500, timeout), Pinpo peut retenter l'envoi, mais un endpoint durablement en erreur entraînera une perte de données.
Ne désactivez pas un webhook sans raison. Un webhook désactivé signifie que les données ne remontent plus. Si vous devez intervenir sur votre système, désactivez-le temporairement, puis réactivez-le dès que possible.
Surveillez le compteur de webhooks actifs. Depuis la page principale d'Intégration API, le compteur (par exemple : 16 webhooks actifs) vous donne une vue rapide. Si ce nombre diminue de manière inattendue, un webhook a pu être désactivé par erreur.