Webhooks

Webhooks sturen een JSON-POST-verzoek naar je URL wanneer een gebruiker een geconfigureerde verzendactie voltooit. Je stelt ze per verzendknop in Manager in.

Een webhook inschakelen

1. Open Manager → Data → Inzendingen.
2. Selecteer of maak een inzending.
3. Schakel onder Actieknoppen op een knop POST naar een URL in en voer de URL van je endpoint in.
4. Sla de inzending op.
5. Open Configuraties → je product → Inzending & tracking en selecteer deze inzending onder Inzending.

Je kunt een webhook combineren met PDF, e-mail en postMessage op dezelfde of verschillende knoppen.

Wanneer webhooks afgaan

Webhooks worden verstuurd vanuit de add-quote-API wanneer de gebruiker verzendt via een knop waarvoor de webhook is ingeschakeld. Een knop met webhook vraagt altijd om de contactgegevens van de klant en maakt een offerterecord aan.

Webhooks worden niet verstuurd als de offerte wel is opgeslagen maar de inzendingsacties niet kunnen worden uitgevoerd (bijvoorbeeld als er voor het product geen inzending is geselecteerd), of als je abonnement is verlopen.

Offerte-event

Webhook-event:

{
  "event": "quotation.created",
  "source": "iconfigure",
  "timestamp": "2026-06-17T12:00:00.000Z",
  "data": {
    "quotation_id": "uuid",
    "quotation_number": 1234,
    "pdf_url": "https://...",
    "total_price": 1250.5,
    "language": "NL",
    "status": 0,
    "created_at": "2026-06-17T12:00:00.000Z",
    "customer": {
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "jane@example.com",
      "phone": 612345678,
      "address": {}
    },
    "extra_fields": {},
    "company": {
      "id": "company-uuid",
      "name": "Your Company",
      "email": "info@example.com"
    },
    "product_id": "product-uuid",
    "dealer_id": null,
    "dealer_product_id": null,
    "items": []
  }
}

pdf_url is null als de knop geen PDF genereert.

Knoppen zonder PDF, e-mail of webhook

Een knop met alleen postMessage (geen PDF, geen e-mail, geen webhook) slaat het contactformulier en het aanmaken van een offerte over. Er wordt geen webhook verstuurd; gebruik voor deze flow postMessage.

Verrijkte items-array

Elk item in data.items bevat herleide featurenamen en geselecteerde subfeatures, in de taal van de inzending. Bij multiple_selection-features is selected een array:

{
  "product_id": "uuid",
  "product_name": "Table configurator",
  "image": "https://.../temporary/.../screenshot.png",
  "items": [
    {
      "repetitions": [
        [
          {
            "ID": "material",
            "feature_name": "Material",
            "type": "single_selection",
            "value": "oak",
            "selected": {
              "ID": "oak",
              "name": "Oak",
              "custom_properties": {}
            }
          }
        ]
      ]
    }
  ]
}

HTTP-details

Eigenschap	Waarde
Methode	POST
Content-Type	application/json
Body	JSON-payload hierboven
Herhaalpogingen	Geen (fire-and-forget)
Dubbele URL's	Gededupliceerd per verzoek

Je endpoint moet reageren met een 2xx-status. Mislukkingen worden server-side gelogd maar niet automatisch opnieuw geprobeerd.

Testen

1. Maak een test-endpoint aan op webhook.site of een n8n-/Zapier-webhook.
2. Plak de URL op een test-verzendknop.
3. Voltooi een configuratorverzending.
4. Bekijk de ontvangen JSON.

Verder lezen

• postMessage — Browser-side alternatief voor iframe/inject
• Inzendingen & uitvoer — Configuratie in Manager