Met webhooks ontvang je automatisch notificaties van Hix wanneer bepaalde events plaatsvinden. Hix stuurt dan een HTTP POST-request naar jouw endpoint.
Webhook registreren
POST /api/v1/webhooks/add
Content-Type: application/json
{
"webhooks": [
{
"url": "https://jouw-systeem.nl/webhook",
"events": ["company_created", "question_status_change"]
}
]
}Beschikbare events
| Event | Beschrijving |
|---|---|
service_task_status_change | Status van een taak is gewijzigd |
service_task_response_status_change | Reactiestatus van een taak is gewijzigd |
task_file_placeholder_applied | Een placeholder in een taakbestand is ingevuld |
logius_request_final_state | Aangifte bij de Belastingdienst heeft een definitieve status bereikt |
sbr_status_change | SBR-status is gewijzigd |
company_created | Nieuw bedrijf aangemaakt |
company_updated | Bedrijfsgegevens bijgewerkt |
company_deleted | Bedrijf verwijderd |
company_archived | Bedrijf gearchiveerd |
question_status_change | Status van een vraag is gewijzigd |
template_answer_comment_added | Reactie toegevoegd bij een template-antwoord |
template_answer_status_change | Status van een template-antwoord is gewijzigd |
Jouw endpoint
Jouw webhook-endpoint moet:
- Bereikbaar zijn via HTTPS
- Binnen 5 seconden antwoorden met HTTP
200 - Zware verwerking asynchroon afhandelen (bijv. via een queue)
Webhook-logs inzien
In Hix Instellingen → Integraties → Webhooks zie je een overzicht van verzonden webhook-events, inclusief de HTTP-status van de aflevering. Dit helpt bij het debuggen van mislukte afleverpogingen.