Un webhook es una dirección de tu sistema que recibe avisos automáticos cuando un correo transaccional se entrega, rebota o genera una queja. Con ellos tu aplicación puede reaccionar sola: por ejemplo, marcar en tu tienda que el correo de un pedido rebotó para pedirle al cliente otra dirección.
Estado actual
Los webhooks están disponibles pronto. Ya puedes ver la página Webhooks en el menú de E-Transactional, pero el botón Agregar webhook todavía está desactivado. Cuando se habiliten, estarán disponibles desde el plan T1.
Cómo funcionarán
- Una URL por webhook: una dirección de tu sistema, por ejemplo
https://tutienda.com/linkeia/eventos. - Eventos: Entregado, Rebote y Queja.
- Firma: cada aviso incluye el encabezado
Linkeia-Signature, un HMAC-SHA256 del cuerpo con tu secreto, para que verifiques que viene de nosotros. Tu sistema calcula esa misma firma con tu secreto y la compara con la del encabezado; si no coincide, descarta el aviso. - Reintentos: si tu sistema no responde, el aviso se reintenta.
En la página verás, para cada webhook, su URL, los eventos que recibe, la fecha del último aviso y su estado.
Mientras tanto: cómo seguir tus envíos
Hoy tienes dos formas de saber qué pasó con cada correo:
- Registro de mensajes: en Registro de mensajes buscas por destinatario, asunto o ID de mensaje y ves el estado y el historial de entrega de cada envío.
- Consulta por API: con
GET https://api.linkeiaemail.com/v1/messages/{id}y tu clave en el encabezadoAuthorizationobtienes el estado actual y los avisos de entrega (entregado, rebote, queja) de un mensaje que todavía está en el registro. Elides el que te devolvió la API al enviar.
Ten en cuenta que el registro guarda los mensajes según tu plan (3, 7 o 30 días). Si tu sistema necesita el estado, consúltalo dentro de ese plazo.
Lo que ya ocurre sin webhooks
No necesitas un webhook para proteger tu reputación: cuando una dirección rebota de forma permanente o marca tu correo como spam, la agregamos a tus Supresiones y los siguientes envíos a esa dirección se omiten y no cuentan en tu plan.
