Comment tester la connexion d’un webhook Papo avant d’activer l’automatisation

Pour tester la connexion d’un webhook Papo (https://papo.global/) avant d’activer l’automatisation, vous pouvez utiliser un outil externe comme Webhook.site pour valider l’URL de destination, vérifier le format du payload JSON et corriger les erreurs d’envoi sans affecter de vrais contacts. Ce processus fonctionne aussi bien pour les webhooks natifs du compte que pour l’action « Envoyer un webhook » dans les Flows d’automatisation.

La validation anticipée évite qu’une intégration défaillante ne perde des données ou n’interrompe le parcours client. Avec une URL de test temporaire, vous pouvez inspecter exactement ce que Papo envoie — en-têtes, corps et codes de réponse — et effectuer des ajustements avant de pointer vers le système final.

Résumé du processus de test

Comment tester les webhooks du compte (Intégrations)

Les webhooks natifs de Papo se déclenchent à chaque nouveau message reçu dans une boîte de réception. Pour les valider sans risque :

1. Dans le panneau Papo, accédez à Paramètres > Intégrations > Webhooks et créez un nouveau webhook.
2. Définissez le déclencheur — par exemple, Tous les messages — et dans le champ URL, collez l’adresse temporaire de Webhook.site.
3. Enregistrez le webhook.
4. Envoyez un message de test (via WhatsApp ou un autre canal connecté) vers la boîte de réception surveillée.
5. Dans Webhook.site, actualisez le panneau et localisez la requête qui vient d’arriver. Vérifiez le corps JSON : il doit contenir des données comme le numéro de l’expéditeur, le contenu du message et l’ID de la conversation.
6. Si le JSON est vide ou mal formé, revoyez le déclencheur choisi et confirmez que le message a bien été reçu par la boîte.
7. Après validation, modifiez le webhook et remplacez l’URL par celle de votre système de destination.

Comment tester l’action « Envoyer un webhook » dans les Flows d’automatisation

Dans l’éditeur de Flows, l’action Envoyer un webhook permet d’envoyer des données à une étape précise du parcours. Le test s’effectue avec un flux temporairement actif et un contact de contrôle :

1. Construisez le Flow et ajoutez le nœud Envoyer un webhook à l’endroit souhaité.
2. Dans le panneau de configuration du nœud, renseignez l’URL avec l’adresse de Webhook.site, choisissez la méthode POST et composez le corps JSON à l’aide de variables Papo, comme {{contact.name}} et {{contact.phone}}.
3. Activez le Flow.
4. Dans le CRM, inscrivez manuellement un contact de test dans ce flux (en suivant la même procédure que pour tester des Flows d’automatisation).
5. Suivez l’historique des exécutions du Flow et, en même temps, observez Webhook.site.
6. La requête reçue doit afficher le JSON avec les valeurs réelles du contact de test, en remplacement des variables. Sinon, vérifiez le corps (utilisez "nome": "{{contact.name}}" et assurez-vous que le contact possède les champs renseignés).
7. Si la requête renvoie une erreur 4xx ou 5xx, vérifiez que la méthode est correcte (normalement POST) et que l’en-tête Content-Type: application/json a bien été inclus.
8. Après validation, désactivez le Flow, remplacez l’URL de destination par l’URL de production et réactivez-le.

À qui s’adresse ce processus

• Administrateurs et analystes système qui doivent garantir l’intégrité des intégrations avant de les mettre en service.
• Équipes qui construisent des Flows avec webhook pour des CRM, tableurs ou outils d’automatisation et souhaitent déboguer le payload sans impacter de vrais leads.
• Tout utilisateur qui personnalise les webhooks du compte et veut confirmer que les événements sont bien envoyés.

Questions fréquentes

Puis-je tester le webhook sans envoyer de message réel ?

Non, ce n’est pas possible pour les webhooks du compte, car ils sont déclenchés par des messages entrants. Utilisez un numéro WhatsApp de test (le vôtre ou celui d’un collègue) pour générer l’événement. Pour les Flows, l’inscription manuelle d’un contact de contrôle permet le test sans que le lead soit un vrai client.

Webhook.site est-il gratuit ? Dois-je l’utiliser en production ?

Oui, Webhook.site génère des URL publiques temporaires et affiche le trafic en temps réel, idéal pour le débogage. N’utilisez jamais ces URL en production — après le test, remplacez-les par l’URL de votre système de destination.

Le webhook s’est déclenché mais le payload est vide. Que vérifier ?

Pour les webhooks du compte, vérifiez le déclencheur (s’il capture bien le type de message concerné) et les permissions de la boîte. Pour l’action de Flow, revoyez les variables dans le corps — des champs comme {{contact.name}} ne seront remplis que si le contact a le champ nom renseigné. Testez avec un contact disposant de données complètes.

Comment corriger les erreurs 401 (non autorisé) ou 403 (interdit) ?

Ces erreurs indiquent que le système de destination a refusé la requête. Ajoutez un en-tête d’authentification (par exemple, Authorization: Bearer votre-token) dans le champ Headers de la configuration du webhook, comme indiqué dans la documentation de l’outil externe.

Puis-je tester les webhooks du Kanban de la même manière ?

Oui. Les webhooks configurés dans le module Kanban peuvent être testés avec une URL temporaire de Webhook.site — il suffit de déplacer une carte d’une colonne à une autre (action qui déclenche l’événement) et d’inspecter le payload dans le panneau de test.

Dois-je garder le Flow actif pour tester le webhook ?

Oui. Seuls les Flows dont le statut est Actif traitent le nœud de webhook. Activez le flux, effectuez le test, puis désactivez-le si nécessaire.

À lire aussi

• Comment tester un Flow d’automatisation avant de l’activer
• Comment envoyer les données de nouveaux contacts vers Google Sheets via webhook

Commencer gratuitement →

Avec le premier utilisateur gratuit, vous pouvez déjà créer des webhooks et tester les intégrations sans engagement.