Deal webhooks

Wat zijn deal webhooks?

Deal webhooks sturen automatisch een HTTP-verzoek naar een URL wanneer een deal naar een bepaalde fase wordt verplaatst. Hiermee koppel je externe systemen aan je verkoopproces.

Webhook instellen

1. Ga naar Instellingen > Deal fases
2. Klik op de fase waarvoor je een webhook wilt instellen
3. Vul de Webhook URL in
4. Klik op Opslaan

Elke keer dat een deal naar deze fase wordt verplaatst, stuurt Quoty een POST-verzoek naar de ingestelde URL.

Payload

De webhook stuurt een JSON payload met de volgende gegevens:

{
  "event": "deal_stage_changed",
  "deal": {
    "id": "uuid",
    "name": "Website redesign",
    "value": 5000,
    "stage": "Offerte verstuurd",
    "previous_stage": "Lead"
  },
  "contact": {
    "id": "uuid",
    "name": "Jan de Vries",
    "email": "[email protected]"
  },
  "company": {
    "id": "uuid",
    "name": "Voorbeeld BV"
  },
  "timestamp": "2026-02-20T10:30:00Z"
}

Toepassingen

Deal webhooks zijn handig voor:

• Slack notificaties - stuur een bericht naar je team wanneer een deal wordt gewonnen
• CRM sync - houd een extern CRM systeem gesynchroniseerd
• Projectmanagement - maak automatisch een project aan in tools zoals Asana of Trello
• Facturatie - trigger automatisch een factuur bij een gewonnen deal
• Marketing - voeg klanten toe aan een e-maillijst na conversie

Testen

Test je webhook met een tool als webhook.site of cURL:

1. Stel de test URL in als webhook URL
2. Verplaats een test-deal naar de betreffende fase
3. Controleer of het verzoek correct is ontvangen

Foutafhandeling

Als de webhook URL niet bereikbaar is of een foutcode retourneert, wordt het verzoek niet opnieuw geprobeerd. Controleer de URL en zorg dat je endpoint beschikbaar is.

Gerelateerde artikelen

• Deal fases aanpassen - fases configureren
• Deals beheren - deal details en koppelingen
• Webhooks - algemene webhook configuratie