Aller au contenu

Webhook : contenu et champs

Référence pour développeurs. La structure du message JSON du webhook meetpiloot, les événements disponibles et les champs que vous recevez.

PlusPour les développeurs1 min de lecture
Sur cette page3
  1. Événements
  2. Exemple
  3. Champs d'origine
Disponible avec Plus.

Chaque message est un POST avec un corps JSON. Les en-têtes X-Meetpiloot-Signature et X-Meetpiloot-Timestamp servent à vérifier le message. L'en-tête X-Meetpiloot-Delivery est l'identifiant fixe de la livraison, qui permet de reconnaître un message répété (voir livraison).

Événements

ÉvénementQuand
lead.createdUn nouveau lead est arrivé.
lead.status_changedLe statut d'un lead a changé, par exemple de devis envoyé à gagné. Contient aussi previous_status.
lead.testUn message de test depuis votre tableau de bord. Ne créez pas de fiche dans votre CRM pour ce message.

Exemple

JSON
{
  "event": "lead.created",
  "sent_at": "2026-09-22T10:00:00.000Z",
  "company_id": "0c9f...",
  "lead": {
    "id": "8f2a...",
    "reference_number": "MP-1042",
    "created_at": "2026-09-22T09:59:00.000Z",
    "status": "new",
    "lead_source": "configurator",
    "product_type": "veranda",
    "customer_name": "Jean Dupont",
    "customer_email": "[email protected]",
    "customer_phone": "+32470123456",
    "customer_address": "Rue de la Station 1",
    "customer_country": "BE",
    "quoted_price": 7450.5,
    "currency": "EUR",
    "width_m": 4,
    "depth_m": 3,
    "calculated_area_sqm": 12
  },
  "attribution": {
    "utm_source": "google",
    "utm_medium": "cpc",
    "utm_campaign": "veranda-automne",
    "utm_term": "veranda sur mesure",
    "utm_content": "annonce-a",
    "gclid": "Cj0KCQ...",
    "landing_page_url": "https://votresite.be/devis?utm_source=google",
    "referrer": "https://www.google.com/"
  }
}

Champs d'origine

Les clés de attribution sont à plat, sans imbrication, pour que vous puissiez les mapper une à une dans Zapier ou Make. Clés possibles :

GroupeClés
Identifiants de clicgclid, gbraid, wbraid, msclkid, fbclid, ttclid
Campagneutm_source, utm_medium, utm_campaign, utm_term, utm_content
Contextelanding_page_url, referrer

Un champ non mesuré est tout simplement absent : il n'est jamais envoyé sous forme de texte vide. Les champs de lead sont toujours présents et peuvent valoir null.

Vous êtes bloqué ?

Envoyez-nous un e-mail ou ouvrez un ticket depuis votre tableau de bord. Nous répondons sous 1 à 2 jours ouvrables.