Webhooks transaccionals

Els webhooks permeten que la vostra aplicació rebi notificacions en temps real quan passa alguna cosa a un correu electrònic transaccional après d'enviar-lo. En lloc de consultar l'API per comprovar l'estat del lliurament, Flexmail envia una sol·licitud HTTP POST al vostre endpoint en el moment en que es produeix un event.

Això és particularment valuable per al correu electrònic transaccional: podeu prendre mesures immediates quan un restabliment de contrasenya genera un rebot, quan una confirmació de comanda és lliurada, o quan un destinatari informa un missatge com a correu brossa.

Events de webhook

Flexmail envia una notificació de webhook per a cadascun dels events següents:

  • Enviat: el missatge va ser acceptat i lliurat al servidor de correu del destinatari.
  • Lliurat: el servidor de correu del destinatari va confirmar el lliurament a la bústia del destinatari.
  • Rebot: el lliurament ha fallat. Els rebots durs indiquen un problema permanent (l'adreça no existeix); els rebots tous indiquen un problema temporal (bústia plena, servidor no disponible).
  • Obert: el destinatari ha obert el missatge.
  • Fet clic: el destinatari ha fet clic a un enllaç rastresat del missatge.
  • Queixa: el destinatari ha marcat el missatge com a correu brossa.

Nota

El seguiment d'obertures i clics requereix píxels de seguiment i embolcallament d'enllaços habilitats. Els events de lliurament depenen que el servidor de correu del destinatari confirmi el lliurament; no tots els servidors ho fan.

Configurar un endpoint de webhook

El vostre endpoint de webhook és una URL al vostre servidor que accepta sol·licituds HTTP POST i retorna una resposta 200 per acusar rebut.

Requisits per al vostre endpoint

  • Accepta sol·licituds HTTP POST.
  • És accessible públicament a través d'HTTPS.
  • Retorna un codi d'estat HTTP 2xx dins d'un temps d'espera raonable per confirmar la recepció.
  • Processa la càrrega de manera asíncrona si la vostra lògica de gestió és lenta: responeu de seguida i processeu en segon pla per evitar els temps d'espera.

Registrar el vostre endpoint a Flexmail

La configuració de l'endpoint de webhook es fa a través de l'API. El procés de registre complet i les opcions disponibles estan documentats a la documentació de l'API a email-api.flexmail.eu/documentation, a la secció Webhooks.

Càrrega del webhook

Cada notificació de webhook és una sol·licitud HTTP POST amb un cos JSON. La càrrega conté el tipus d'event, una marca de temps, l'ID del missatge i l'adreça de correu electrònic del destinatari. Depenent de l'event, s'inclouen camps addicionals; per exemple, un event de rebot inclou el tipus de rebot i el motiu, i un event de clic inclou l'URL sobre la qual s'ha fet clic.

Una càrrega típica té aquest aspecte:

{ "event": "delivered", "timestamp": "2024-11-15T09:32:00Z", "messageId": "abc123", "recipient": "customer@example.com" }

L'especificació completa de la càrrega per a cada tipus d'event es troba a la documentació de l'API.

Què fer amb els events de webhook

Rebots

Quan rebeu un event de rebot dur, marqueu aquella adreça de correu electrònic al vostre sistema. Deixeu d'enviar-hi i investigueu si l'adreça s'ha introduït correctament. Continuar enviant a adreces amb rebot dur danya la vostra reputació de remitent.

Queixes de correu brossa

Quan un destinatari marca un correu electrònic transaccional com a correu brossa, suprimiu aquella adreça de seguida. Fins i tot si el correu electrònic era genuïnament transaccional (una confirmació de comanda, per exemple), el destinatari ha indicat que no vol rebre correus electrònics vostres. Continuar enviant és tant perjudicial per a la vostra reputació com potencialment un problema legal.

Confirmacions de lliurament

Per als missatges sensibles al temps com els restabliments de contrasenya o els codis d'autenticació de dos factors, podeu usar l'event de lliurament per confirmar que el correu electrònic ha arribat a la safata d'entrada. Si no arriba cap confirmació de lliurament dins d'un termini raonable, podeu mostrar un missatge a la vostra interfície d'usuari suggerint que l'usuari comprovi la carpeta de correu brossa o ho torni a provar.

Consell

Acuseu rebut de les sol·licituds de webhook de seguida amb una resposta 200 i, a continuació, processeu la càrrega en una feina en segon pla o en una cua. Si el vostre gestor tarda massa a respondre, Flexmail pot esgotar el temps i reintentar la sol·licitud, cosa que pot conduir a un processament duplicat.

Reintents

Si el vostre endpoint no retorna una resposta correcta, Flexmail reintenta la notificació del webhook. Feu que el tractament dels vostres events sigui idempotent: processar el mateix event dues vegades hauria de produir el mateix resultat que processar-lo una vegada. Useu l'ID del missatge i el tipus d'event junts per deduplicar.

Passos següents

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.