Configura tus webhooks para todo tu equipo, varios proyectos o rutas individuales
Publicado el:
Con los webhooks, tu aplicación recibe aviso al instante cuando pasa algo con tus correos. Un correo transaccional que rebota, una baja de tu newsletter o un correo entrante que hay que procesar. Tu aplicación reacciona en el momento, sin tener que comprobar por su cuenta si ha pasado algo.
Hasta ahora, cada webhook estaba vinculado a un solo sitio. Para recibir los mismos events en varios sitios, creabas un webhook separado para cada uno. Con unas pocas rutas es manejable. Pero imagina que llevas una agencia con un proyecto por cliente. Entonces montas la misma integración una y otra vez, para cada cliente.
Eso cambia hoy. Al crear un webhook, eliges tú mismo el scope: todo tu equipo, uno o varios proyectos, o una o varias rutas.
Cómo funciona
Los webhooks ahora tienen su propio sitio en la barra lateral. En la vista general de webhooks (se abre en una ventana nueva) ves todos los webhooks de tu equipo en un solo lugar, incluido el scope de cada uno. En un proyecto o una ruta sigues viendo los webhooks que le corresponden, como antes.
Para cada webhook eliges ahora uno de tres scopes:
- Equipo: el webhook recibe events de todos tus proyectos y rutas, también de los proyectos que crees más adelante.
- Proyecto: elige uno o varios proyectos. El webhook recibe events de todas las rutas de esos proyectos, también de las que añadas más adelante.
- Ruta: elige una o varias rutas. Pueden estar en proyectos distintos.
Como siempre, cada webhook tiene una URL y un signing secret. ¿Quieres cambiar el scope después de crearlo y ampliar el webhook? Puedes hacerlo.
Mira de dónde vienen los events
Cuando tu webhook recibe events de varios proyectos o rutas, quieres saber a cuál pertenece cada uno. Por eso cada payload incluye ahora un context con el scope del webhook y los identificadores de tu equipo, proyecto y ruta:
{
"context": {
"scope": "route",
"team_id": "9f4e3d2c-1b0a-4987-9654-3210fedcba98",
"project_id": "7d6c5b4a-3210-4987-9654-fedcba987654",
"route_id": "1a2b3c4d-5678-4987-9654-abcdef123456"
}
}
Así lo procesas todo en un solo endpoint y filtras por proyecto o cliente en tu propio código.
Disponible desde hoy
Tus webhooks actuales siguen funcionando, con el scope que ya tenían. ¿Quieres ampliar alguno? Cambia su scope en el dashboard.
También hemos ampliado la lista de events. Con suppression.added y suppression.removed recibes aviso en cuanto una dirección entra en tu suppression list o sale de ella. Así tu propio sistema sabe siempre a qué direcciones ya no escribimos.
Y como ya sabes de nosotros: tus webhooks también salen de servidores europeos. Como proveedor de correo europeo, mantenemos tus datos de events, direcciones de correo incluidas, dentro de la UE.
¿Quieres saber más sobre webhooks, como verificar el signing secret y todos los events disponibles? Consulta la documentación de webhooks.