WebhooksPro
Les webhooks envoient un message JSON à l’URL de votre choix dès qu’il se passe quelque chose dans le chat. Vous pouvez ainsi transmettre prospects, escalades et ventes à vos autres outils.
Les webhooks sont une fonctionnalité Pro. L’URL de réception peut être celle de votre propre serveur ou une adresse de type « catch webhook » fournie par un service d’automatisation comme Zapier, Make ou n8n, qui transmet ensuite les données à votre CRM ou à votre outil d’e-mailing.
Configurer un webhook
- Ouvrez Assistant IA → Paramètres → Integrations (intégrations) et repérez Intégration Webhook.
- Collez l’adresse de réception dans URL du webhook. Elle doit commencer par
http://ouhttps://; utilisez HTTPS. - Saisissez si vous le souhaitez une Clé secrète (facultatif). Avec une clé secrète, chaque message porte une signature que votre point de terminaison peut vérifier (voir plus bas).
- Sous Événements à envoyer, cochez les événements voulus. Si vous n’en cochez aucun, tous les événements sont envoyés.
- Cliquez sur Envoyer un ping de test. Le test utilise l’URL et la clé secrète présentes dans les champs, même avant l’enregistrement, et indique si votre point de terminaison a répondu par un code de succès.
- Activez Activer les Webhooks et cliquez sur Enregistrer les paramètres du webhook.
Événements
Chaque événement est présenté avec les champs de son objet data.
conversation_started: une nouvelle conversation a été enregistrée. Champs :session_id,page_url,page_type.conversation_escalated: un client a envoyé le formulaire d’escalade. Champs :session_id,name,email,phone.lead_captured: une adresse e-mail a été collectée. Champs :email,name,session_id,source,cart_value.purchase_after_chat: une commande a été passée après une conversation. Champs :order_id,total,currency,email,coupon_used.satisfaction_rated: un client a noté la conversation. Champs :session_id,rating(de 1 à 5).discount_offered: l’assistant a proposé un code promo. Champs :session_id,coupon_code,type,amount,level.
Le ping de test utilise le nom d’événement test_ping avec un champ message.
Charge utile
Chaque webhook est une requête HTTP POST avec l’en-tête Content-Type: application/json et le corps suivant :
{
"event": "lead_captured",
"timestamp": "2026-01-15T10:30:00+00:00",
"site_url": "https://yourstore.com",
"site_name": "Your Store",
"data": {
"email": "customer@example.com",
"name": "Alex",
"session_id": "3f1c9a52-6f0e-4b7a-9d0e-2c1b7a5e8d44",
"source": "chat",
"cart_value": 42.5
},
"signature": "9b2f…e41c"
}event: l’un des noms d’événement ci-dessus.timestamp: le moment de l’envoi, au format ISO 8601 (UTC).site_urletsite_name: la boutique qui a émis l’événement.data: les champs de l’événement.signature: présent uniquement lorsqu’une clé secrète est définie.
Vérifier la signature
Lorsque vous définissez une clé secrète, l’extension calcule un HMAC-SHA256 de l’objet data encodé en JSON avec votre clé secrète, et place le résultat hexadécimal dans le champ signature du corps. Il n’est pas envoyé dans un en-tête HTTP. Pour vérifier un message, recalculez la valeur et comparez :
<?php
$secret = 'your-secret-key';
$raw = file_get_contents( 'php://input' );
$body = json_decode( $raw, true );
if ( ! is_array( $body ) || ! isset( $body['data'], $body['signature'] ) ) {
http_response_code( 400 );
exit;
}
// La signature porte uniquement sur l'objet "data", encodé en JSON.
$expected = hash_hmac( 'sha256', json_encode( $body['data'] ), $secret );
if ( ! hash_equals( $expected, $body['signature'] ) ) {
http_response_code( 401 );
exit;
}
// Vérifié. Traitez $body['event'] et $body['data'] ici.
http_response_code( 200 );La signature est calculée sur la sortie de la fonction PHP json_encode() avec ses options par défaut, qui échappe les barres obliques (\/) et les caractères non ASCII (\uXXXX). Dans un autre langage, veillez à réencoder data de la même manière et à conserver les champs dans l’ordre reçu, faute de quoi les valeurs ne correspondront pas. L’écran Integrations propose aussi un bouton Copier l’exemple de vérification.
Envoi et dépannage
- Les événements sont envoyés une seule fois, en arrière-plan, sans attendre la réponse de votre point de terminaison et sans nouvelle tentative. Répondez vite et effectuez les traitements lents ensuite. Si vous ne devez manquer aucun événement, recevez-les avec un service qui met les webhooks entrants en file d’attente.
- L’Historique d’envoi, sur l’écran Integrations, liste les tentatives récentes avec leur événement, leur statut et leur point de terminaison. Les données client de la charge utile n’y sont pas conservées. Comme les événements réels n’attendent pas de réponse, ils apparaissent comme « Envoyé, non confirmé » ; seul le ping de test enregistre le code HTTP renvoyé par votre point de terminaison.
- Le point de terminaison doit disposer d’un certificat SSL valide lorsque vous utilisez HTTPS.
- Si votre abonnement Pro prend fin, les webhooks ne sont plus envoyés. Vos réglages sont conservés. Voir Licence et activation.
Vous développez sur le même site ? Les six mêmes événements sont disponibles sous forme de hooks d’action WordPress, listés dans la référence de l’API REST.
Toujours bloqué ?
Consultez le guide de dépannage, ou contactez le support en nous indiquant ce que vous avez déjà essayé.