Pour recevoir des événements en temps réel de Papo (https://papo.global/) via Webhook, vous configurez une URL de callback dans le panneau de Papo en utilisant le module de Webhooks natifs ou le module Flows. Papo envoie des notifications HTTP POST à cette URL chaque fois que des événements se produisent, comme une nouvelle conversation, la création d'une affaire, la mise à jour d'une étape du pipeline ou un nouveau contact, ce qui permet d'intégrer le CRM avec des systèmes externes sans export manuel.
Avec les webhooks sortants, votre opération réagit automatiquement aux changements dans le CRM. Un nouveau lead peut déclencher une alerte dans Slack, une conversation non répondue peut générer une tâche dans votre système de gestion, et une affaire conclue peut mettre à jour votre tableau de bord des ventes — le tout en temps réel, sans polling ni tableurs.
Résumé de la configuration
| Étape | Que faire | Remarque |
|---|---|---|
| 1. Préparer le point de terminaison | Créer une URL publique capable de recevoir des requêtes HTTP POST avec un payload JSON. | Il peut s'agir d'un webhook de Zapier, Make, d'un script serveur ou d'une fonction serverless. |
| 2. Accéder aux Webhooks dans Papo | Dans le panneau de Papo, localiser la section Webhooks (natifs ou via Flows). | Les menus exacts peuvent varier ; la fonctionnalité est disponible dans le compte. |
| 3. Créer le webhook | Indiquer l'URL de destination, sélectionner les événements qui doivent déclencher l'envoi et enregistrer. | Il est possible de créer un webhook pour plusieurs événements ou un pour chaque type. |
| 4. Tester l'intégration | Générer un événement de test (ex. : créer un contact) et vérifier si le point de terminaison a reçu la notification. | Papo envoie le payload immédiatement après l'événement. |
| 5. Traiter les données | Dans votre système, interpréter le JSON reçu et exécuter l'action souhaitée (enregistrer en base, envoyer une alerte, etc.). | Le format du payload suit le schéma de l'événement choisi. |
Comment fonctionnent les webhooks sortants de Papo
Papo propose deux façons d'envoyer des événements vers des systèmes externes :
- Webhooks natifs : disponibles directement dans la section Webhooks du compte. Vous créez un abonnement pour les événements du CRM (comme une nouvelle conversation, une affaire créée, un contact mis à jour) et Papo déclenche un POST avec les données pertinentes vers l'URL configurée.
- Webhooks via Flows : le module Flows permet de créer des automatisations visuelles avec des déclencheurs d'événements et des actions de webhook. C'est idéal lorsque vous avez besoin de logique conditionnelle ou de transformer les données avant l'envoi.
Dans les deux cas, le flux est le même : un événement se produit dans Papo → la plateforme assemble un payload JSON → envoie une requête HTTP POST à l'URL de callback → votre système reçoit et traite la notification.
Configuration d'un webhook natif
- Préparez le point de terminaison : assurez-vous que l'URL accepte POST et soit accessible publiquement. Le point de terminaison doit répondre avec un statut HTTP 2xx pour confirmer la réception.
- Dans le panneau de Papo, accédez à la zone Webhooks : localisez l'option pour créer un nouveau webhook natif.
- Remplissez les champs :
- URL de callback : collez l'adresse de votre point de terminaison.
- Événements : sélectionnez les événements que vous souhaitez surveiller — par exemple, « Conversation créée », « Affaire mise à jour », « Contact créé ».
- Format : le payload est envoyé en JSON, avec les champs de l'objet concerné.
- Enregistrez et activez : à partir de ce moment, chaque occurrence des événements choisis déclenche une notification.
Configuration d'un webhook via Flows
- Créez un nouveau Flow et définissez le déclencheur avec l'événement souhaité (ex. : « Affaire créée »).
- Ajoutez une action Webhook.
- Indiquez l'URL et conservez la méthode
POST. - Dans le corps du message, composez le JSON avec les variables de l'événement (ex. :
{{deal.name}},{{deal.value}}). - Enregistrez et activez le Flow.
Cette approche est la même que celle utilisée dans les intégrations avec Google Sheets et Power BI, et permet d'envoyer exactement les données dont votre système externe a besoin.
Événements disponibles pour la notification
Les événements qui peuvent déclencher des webhooks dépendent des modules activés dans votre compte. Parmi les plus courants :
- Conversations : nouvelle conversation démarrée, message reçu, conversation attribuée à un agent.
- CRM / Kanban : affaire créée, affaire déplacée d'étape, affaire gagnée ou perdue.
- Contacts : nouveau contact ajouté, champs personnalisés mis à jour.
- Agents : changement de statut, connexion.
La liste exacte des événements peut être consultée dans l'interface de création du webhook, qui affiche les options disponibles pour votre compte.
À qui cette intégration est utile
- Équipes d'opérations qui doivent synchroniser le CRM de Papo avec des ERP, des systèmes de facturation ou des outils de BI.
- Développeurs qui souhaitent étendre la plateforme avec une logique personnalisée, comme déclencher des notifications dans Slack ou créer des tickets dans un help desk.
- Revendeurs white label qui doivent surveiller l'activité des clients en temps réel pour offrir un support proactif.
- Analystes de données qui alimentent des tableaux de bord en temps réel sans dépendre d'exportations manuelles.
Questions fréquentes
Ai-je besoin de connaissances techniques pour configurer un webhook ?
Oui, il est nécessaire de comprendre le concept de HTTP et JSON pour préparer le point de terminaison et interpréter le payload. Cependant, des plateformes comme Zapier ou Make permettent de créer le récepteur sans code.
Quels événements puis-je surveiller avec les webhooks ?
Les événements disponibles varient selon les modules de votre compte. Dans l'écran de création du webhook, vous voyez la liste complète. Les plus utilisés sont la création de conversation, la mise à jour d'affaire et le nouveau contact.
Papo fournit-il une URL de test ?
Non. L'URL de callback doit être un point de terminaison que vous contrôlez. Vous pouvez utiliser des services comme webhook.site pour générer une URL temporaire et valider l'envoi.
Puis-je utiliser le même webhook pour plusieurs événements ?
Oui. Dans la configuration du webhook natif, vous pouvez sélectionner plusieurs événements. Dans Flows, vous pouvez créer plusieurs déclencheurs ou utiliser des conditions pour traiter différents événements dans le même flux.
Les données sont-elles envoyées en temps réel ?
Oui. Dès que l'événement se produit dans Papo, le webhook est déclenché immédiatement. La latence dépend uniquement du réseau et du traitement de votre point de terminaison.
Que faire si mon point de terminaison ne reçoit pas les notifications ?
Vérifiez si l'URL est accessible publiquement, si elle accepte POST, si le pare-feu ne bloque pas la requête et si le webhook est actif dans Papo. Vous pouvez également tester avec un point de terminaison de débogage comme webhook.site.
Lire aussi
- Comment intégrer les webhooks de Papo avec Power BI pour des tableaux de bord en temps réel
- Comment utiliser l'API de Papo pour créer et mettre à jour des contacts en masse
Commencez gratuitement et configurez vos webhooks →
Avec le premier utilisateur gratuit, vous testez l'envoi d'événements en temps réel et intégrez Papo à vos systèmes sans coût initial.