¿Te resultó útil este artículo?

Webhooks: eventos y cómo recibirlos

Linkeia E-TransactionalLectura de 2 min

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:

  1. 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.
  2. Consulta por API: con GET https://api.linkeiaemail.com/v1/messages/{id} y tu clave en el encabezado Authorization obtienes el estado actual y los avisos de entrega (entregado, rebote, queja) de un mensaje que todavía está en el registro. El id es 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.

¿Te resultó útil este artículo?

Compartir

Artículos relacionados

¿No encontraste lo que buscabas?

Nuestro equipo te ayuda a resolverlo.