Webhooks: fouten
Als je notificaties wil ontvangen over verzendfouten, kan je een Webhook voor fouten instellen. Je ontvangt dan een notificatie van zowel synchrone fouten (fouten tijdens de SMTP handshake) als asynchrone fouten (fouten die in eerste instantie geaccepteerd werden, maar waarvoor vervolgens een foutmelding ontvangen werd).
Synchroon vs asynchroon
Het SMTP protocol stelt servers in staat om een bericht te accepteren of af te wijzen. Als een bericht afgewezen wordt stuurt Copernica een POST bericht naar de URL die je voor de Webhook hebt ingesteld. Het is ook mogelijk dat een bericht geaccepteerd wordt, maar dat de ontvangende server later een bounce-email terugstuurt om te melden dat het verzenden toch niet gelukt is. Deze asynchrone fouten worden ook door Copernica opgevangen als ze herkend worden.
Mailservers gebruiken meestal de officiële Delivery Status Notification (DNS) standaard om bounce-berichten terug te sturen. Bounces in dit standaardformaat worden automatisch door Copernica herkend, gelogd en naar de Webhook doorgestuurd. Helaas hebben niet alle mailservers deze standaard overgenomen en sommige grote mailservers sturen notificaties in een format dat zij zelf ontworpen hebben. Alhoewel we ons best doen om alle soorten bounce-berichten te herkennen en door te sturen naar de Webhooks, is dit niet altijd mogelijk voor asynchrone bounce-berichten die niet aan de standaard voldoen.
Als je alle bounces wilt ontvangen kan je naast een Webhook voor fouten ook een Webhook voor bounces instellen.
Variabelen
De Marketing Suite stuurt via HTTP of via HTTPS een POST bericht naar jouw server. Met elk POST bericht worden de volgende variabelen meegestuurd:
| Variabele | Description |
|---|---|
| id | Unieke id van het bericht dat de failure triggerde |
| type | Type van de actie die de Webhook triggerde ('failure') |
| timestamp | Tijdstempel van de failure (YYYY-MM-DD HH:MM:SS formaat) |
| time | Unix tijd van de failure |
| recipient | E-mailadres van de ontvanger die de failure triggerde |
| action | Actie die voorgekomen is ('failure' of 'failed') |
| state | Staat in het SMTP protocol van de fout ("bounce" voor asynchrone bounces) |
| code | Optionele SMTP error code |
| extended | Optionele extended SMTP status code |
| description | Optionele omschrijving van de fout |
| tags | Tags geassocieerd met het bericht |
De variabelen 'id', 'recipient' en 'tags' stellen je in staat om de foutmelding te koppelen aan de oorspronkelijke mail.