Automatisations et webhooks

Les automatisations envoient les événements de vos chats vers les autres outils de votre entreprise. Quand une conversation commence, qu'un visiteur envoie un message, que l'IA répond ou qu'un chat se termine, Pingu envoie les détails à l'URL de votre choix.

Pointez-les vers Zapier, Make ou n8n pour connecter Pingu à des milliers d'applications sans code, ou vers votre propre API pour construire exactement le flux dont vous avez besoin.

Configurer un webhook

1. Obtenez une URL de webhook. Créez un déclencheur webhook dans l'outil qui doit recevoir les événements, par exemple Catch Hook dans Zapier, un webhook personnalisé dans Make ou un nœud Webhook dans n8n, et copiez son URL. Vous pouvez aussi utiliser une adresse https:// de votre propre système.
2. Dans le tableau de bord, ouvrez Automatisations et choisissez Ajouter un webhook.
3. Collez l'URL, ajoutez une description et choisissez les événements à envoyer.
4. Choisissez Enregistrer.
5. Choisissez Envoyer un événement de test. L'historique des envois indique si votre système l'a reçu, avec le code de réponse et l'heure.

Événements disponibles

Événement	Quand il est envoyé
conversation.started	Un visiteur commence un nouveau chat
message.received	Un visiteur envoie un message
message.ai_replied	L'IA répond au visiteur
conversation.ended	Un chat est fermé

Vérifier la signature

Chaque webhook a son propre secret de signature. Pingu signe chaque requête dans un en-tête, pour que votre système puisse vérifier que l'événement vient bien de Pingu :

X-Pingu-Signature: t=1760000000,v1=<HMAC-SHA256 of "<t>.<body>">

La vérification de la signature est facultative, mais recommandée pour vos propres API.

Envoi fiable

Si votre système ne répond pas, Pingu réessaie après 1 minute, 5 minutes, 30 minutes, 2 heures et 6 heures. Un webhook qui échoue pendant 3 jours est désactivé automatiquement, et vous pouvez le réactiver en un clic.

Problèmes courants

L'événement de test échoue. Vérifiez que l'URL est correcte, commence par https:// et que l'outil de réception est actif et à l'écoute.

Mon webhook a été désactivé. Il a échoué 3 jours de suite. Corrigez le système de réception, puis réactivez le webhook dans Automatisations.