Configurar un webhook

Un webhook es una dirección en su propio servidor a la que 2Mail envía un mensaje en cuanto ocurre algo con un correo: entregado, rebotado, abierto. Así su tienda online o su CRM sabe en pocos minutos qué ha pasado con un mensaje, sin que usted tenga que mirar el panel.

Qué necesita

• una dirección en su servidor accesible por https y capaz de recibir peticiones; con https los datos viajan cifrados
• un trozo de código detrás de esa dirección que procese los datos
• permisos de administrador en su cuenta de 2mail

Paso 1: crear el webhook

1. Abra en el panel el apartado de webhooks y cree uno nuevo.
2. Escriba la dirección de su extremo.
3. Elija los eventos que quiere recibir: entrega, rebote, apertura, o una combinación. Empiece por los rebotes: es el evento ante el que antes hay que hacer algo.
4. Guarde. El panel muestra una clave secreta con la que se firma cada llamada. Guárdela en la configuración de su aplicación.

Paso 2: comprobar la firma

Cualquiera puede enviar una petición a su dirección. Por eso cada llamada de 2Mail lleva una firma en la cabecera, calculada con la clave secreta sobre el contenido. Recalcule esa firma en su lado y rechace las peticiones en las que no cuadre. No se salte este paso: sin comprobación, alguien de fuera puede hacer creer a su sistema que un mensaje ha rebotado.

Paso 3: responder rápido

Responda al momento con un código de estado de la serie 200 y procese los datos después, por ejemplo mediante una cola. Si su procesamiento tarda demasiado o responde con un error, 2Mail considera la llamada fallida y lo reintenta más tarde. Procure que su código pueda recibir dos veces el mismo mensaje sin duplicar acciones: use el identificador del mensaje para reconocer las repeticiones.

Paso 4: probar

Envíe un mensaje de prueba a una dirección que controle y compruebe si la entrega llega a su extremo. Para un rebote, pruebe con una dirección que seguro no existe en un dominio que sí existe. El panel muestra por webhook las últimas llamadas, con la respuesta de su servidor: ahí ve al momento si su extremo devolvió algo distinto de un 200.

Qué hacer con ello

• Ante un rebote duro, marcar la dirección en su CRM para que un comercial no la siga usando.
• Ante una entrega, mostrar en el historial de pedidos que la confirmación llegó: eso ahorra llamadas.
• Ante una apertura, planificar una tarea de seguimiento, por ejemplo tras un presupuesto.

Dónde se tuerce

• Ninguna llamada — la dirección solo es accesible internamente, o un cortafuegos bloquea las peticiones de fuera.
• La firma nunca cuadra — la calcula sobre un contenido modificado; use el contenido en bruto de la petición.
• Acciones duplicadas — su extremo responde demasiado despacio y por eso recibe repeticiones.

Los webhooks forman parte de la API de correo; crear una clave de API es el primer paso si su aplicación también quiere enviar.

¿No lo consigue?

Indíquenos a través de contacto la dirección de su extremo y la hora de la prueba. Le mostramos qué nos respondió su servidor.