{"id":39931,"date":"2019-06-27T06:14:50","date_gmt":"2019-06-27T06:14:50","guid":{"rendered":"https:\/\/wp.lvh.me\/blog\/2019\/06\/27\/mailrelay-v3-webhooks-para-conectar-con-sistemas-externos\/"},"modified":"2026-10-01T08:16:29","modified_gmt":"2026-10-01T08:16:29","slug":"mailrelay-v3-webhooks-para-conectar-con-sistemas-externos","status":"publish","type":"post","link":"https:\/\/mailrelay.com\/es\/blog\/2019\/06\/27\/mailrelay-v3-webhooks-para-conectar-con-sistemas-externos\/","title":{"rendered":"Mailrelay v3 Webhooks para conectar con sistemas externos"},"content":{"rendered":"\n

Recientemente hemos a\u00f1adido una nueva funcionalidad a la nueva versi\u00f3n de Mailrelay, los webhooks.<\/strong><\/p>\n\n\n\n

Los webhooks se complementan con el env\u00edo v\u00eda API o servicios SMTP<\/a> para integrar Mailrelay con tus sistemas externos.<\/p>\n\n\n\n

Los webhooks permiten realizar conexiones en tiempo real con sistemas externos,<\/strong> y actualmente hay posibilidad de definir:<\/p>\n\n\n\n

    \n
  1. Cuando un suscriptor se a\u00f1ade a un grupo<\/li>\n\n\n\n
  2. Cuando se elimina del grupo<\/li>\n\n\n\n
  3. O cuando se da de baja<\/li>\n<\/ol>\n\n\n\n

    \u00bfPara que nos pueden servir estos webhooks?<\/strong><\/p>\n\n\n\n

    Te pongo un ejemplo muy sencillo, imagina que tu empresa gestiona todos los contactos, clientes, en un CRM propio donde tiene todos sus datos, compras anteriores, etc. Y para enviarles las campa\u00f1as de email, exportan estos contactos y los importan a Mailrelay, desde donde env\u00edan.<\/p>\n\n\n\n

    El problema, hasta ahora, era que, aunque en Mailrelay los contactos pueden darse de baja a trav\u00e9s de los enlaces en la newsletter, para darlos de baja del CRM (u otro sistema externo)<\/em> hab\u00eda que utilizar el API o hacerlo de forma manual.<\/p>\n\n\n\n

    Con la nueva opci\u00f3n de webhooks es m\u00e1s f\u00e1cil<\/strong> enviar una petici\u00f3n y gestionarla mediante programaci\u00f3n desde el lado del CRM.<\/p>\n\n\n\n

    En este post vamos a ver como definir y probar el funcionamiento de los webhook.<\/p>\n\n\n\n\n\n\n

    \u00b7 Definiendo un webhook para las bajas<\/h2>\n\n\n\n

    Los webhooks se definen en la secci\u00f3n de Automatizaciones:<\/strong><\/p>\n\n\n\n

    \"webhooks<\/figure>\n\n\n\n

    Una vez en esta secci\u00f3n, crearemos una nueva automatizaci\u00f3n:<\/p>\n\n\n\n

    \"nueva<\/figure>\n\n\n\n

    La automatizaci\u00f3n que vamos a crear es de tipo \u00abpersonalizado\u00bb <\/strong>(la otra opci\u00f3n es la de cumplea\u00f1os, pero esa no nos interesa ahora):<\/p>\n\n\n\n

    \"crear<\/figure>\n\n\n\n

    A partir de aqu\u00ed tendremos que realizar la definici\u00f3n b\u00e1sica de la automatizaci\u00f3n.<\/p>\n\n\n\n

    Vamos a comentar los par\u00e1metros m\u00e1s importantes despu\u00e9s de la siguiente imagen:<\/p>\n\n\n\n

    \"definici\u00f3n<\/figure>\n\n\n\n

    Tenemos estas opciones:<\/p>\n\n\n\n

      \n
    1. Nombre:<\/strong> este es solo el nombre interno del trigger, puedes llamarlo como prefieras<\/li>\n\n\n\n
    2. Todos los suscriptores:<\/strong> podr\u00edamos definir un grupo concreto, pero para este ejemplo selecciono a todos<\/li>\n<\/ol>\n\n\n\n

      Tras definir esos puntos tendremos que \u00abA\u00f1adir trigger\u00bb<\/strong>, para definir la acci\u00f3n que desencadenar\u00e1 el evento.<\/p>\n\n\n\n

      Elegiremos la opci\u00f3n de \u00abActividad Del Suscriptor\u00bb:<\/strong><\/p>\n\n\n\n

      \"webhook<\/figure>\n\n\n\n

      Dentro de todas las opciones de actividad del suscriptor tenemos:<\/p>\n\n\n\n

      \"evento<\/figure>\n\n\n\n

      Utilizaremos el evento de cancelaci\u00f3n de la suscripci\u00f3n<\/strong>, que es el que nos interesa en este momento, pero ser\u00eda posible definir eventos para cuando se a\u00f1ade un suscriptor a un grupo, o es eliminado (sin hacer baja) de un grupo:<\/p>\n\n\n\n

      \"webhook<\/figure>\n\n\n\n

      Al trigger le a\u00f1adiremos el nombre que deseemos y, algo importante:<\/strong><\/p>\n\n\n\n

        \n
      1. Webhook url<\/strong>: es decir, la URL a la que se va a enviar la petici\u00f3n, cuando se curse una baja de un contacto.<\/li>\n\n\n\n
      2. La petici\u00f3n se env\u00eda en el array GET normalmente, no en el POST<\/li>\n<\/ol>\n\n\n\n

        La URL destino del webhook es una URL de nuestra web donde podemos recibir la informaci\u00f3n enviada por Mailrelay, con informaci\u00f3n del contacto que ha realizado la baja, y tratar dicha informaci\u00f3n de la forma que necesitemos.<\/p>\n\n\n\n

        Una vez hecho eso te queda Validar y aplicar:<\/strong><\/p>\n\n\n\n

        \"validar<\/figure>\n\n\n\n

        Y ya por \u00faltimo, para crear todo el automatismo, hacer click en el bot\u00f3n \u00abcrear automatizaci\u00f3n\u00bb<\/strong>:<\/p>\n\n\n\n

        \"crear<\/figure>\n\n\n\n

        De esa forma ya estar\u00eda todo listo, y solo queda que desde el lado del CRM o software se gestionen las llamadas que ser\u00e1n lanzadas cuando ocurra alguna baja.<\/p>\n\n\n\n

        \"Webhooks<\/a><\/figure>\n\n\n\n

        \u00b7 Probando el webhook con herramientas de test<\/h2>\n\n\n\n

        Es posible que desees probar el webhook sin tener todav\u00eda la programaci\u00f3n del lado de tu software, para ello puedes utilizar un servicio como el de RequestBin:<\/p>\n\n\n\n

        \"requestbin\"<\/figure>\n\n\n\n

        En esta pantalla solo tienes que hacer click en el bot\u00f3n \u00abCreate a RequestBin\u00bb, <\/strong>te recomiendo tambi\u00e9n que lo crees de forma privada.<\/p>\n\n\n\n

        Una vez hecho eso, ver\u00e1s una pantalla similar a la siguiente:<\/p>\n\n\n\n

        \"requestbin<\/figure>\n\n\n\n

        Puedes copiar esa URL, y pegarla cuando est\u00e9s creando el webhook:<\/p>\n\n\n\n

        \"creando<\/figure>\n\n\n\n

        Solo tenemos que poner la URL en la casilla del formulario, y luego podemos lanzar una prueba desde el bot\u00f3n \u00abWebhook de prueba\u00bb<\/strong>:<\/p>\n\n\n\n

        \"lanzamiento<\/figure>\n\n\n\n

        Si aceptamos el mensaje el webhook se enviar\u00e1, y podremos ver la petici\u00f3n en RequestBin<\/strong>:<\/p>\n\n\n\n

        \"requestbin\"<\/figure>\n\n\n\n

        Es una petici\u00f3n de ejemplo, pero guarda la misma estructura que una petici\u00f3n real:<\/p>\n\n\n\n

        {\u00abunsubscribe_event\u00bb:{\u00absource\u00bb:\u00bbweb\u00bb,\u00bbip\u00bb:\u00bb192.168.1.1\u2033,\u00bbemail\u00bb:\u00bbuser@example.com\u00bb,\u00bbreason\u00bb:null,
        \n\u00abdescription\u00bb:null,\u00bbcreated_at\u00bb:\u00bb2019-06-14T10:48:41.510+02:00\u2033},
        \n\u00abtime\u00bb:\u00bb2019-06-14T10:48:41.511+02:00\u2033,\u00bbautomation_trigger_id\u00bb:0,\u00bbsubscriber\u00bb:{\u00abid\u00bb:null,\u00bbemail\u00bb:\u00bbuser@example.com\u00bb,
        \n\u00abname\u00bb:null,\u00bbscore\u00bb:null,\u00bbstatus\u00bb:\u00bbinactive\u00bb,
        \n\u00absubscribed_at\u00bb:null,\u00bbsubscribed_with_acceptance\u00bb:false,\u00bbsubscribe_ip\u00bb:null,
        \n\u00abunsubscribed\u00bb:false,\u00bbunsubscribed_at\u00bb:null,\u00bbunsubscribe_ip\u00bb:null,
        \n\u00abunsubscribe_sent_email_id\u00bb:null,\u00bbaddress\u00bb:null,\u00bbcity\u00bb:null,\u00bbstate\u00bb:null,
        \n\u00abcountry\u00bb:null,\u00bbbirthday\u00bb:null,\u00bbwebsite\u00bb:null,\u00bbbounced\u00bb:false,\u00bbreported_spam\u00bb:false,
        \n\u00ablocal_ban\u00bb:false,\u00bbglobal_ban\u00bb:false,\u00bbcreated_at\u00bb:\u00bb2019-06-14T10:48:41.507+02:00\u2033,\u00bbupdated_at\u00bb:\u00bb2019-06-14T10:48:41.507+02:00\u2033,
        \n\u00abcustom_fields\u00bb:{}}}<\/p>\n\n\n\n

        De forma que puedes conocer esa estructura para tratarla en tu sistema.<\/p>\n\n\n\n

        Tambi\u00e9n puedes realizar peticiones reales <\/strong>si guardas el automatismo, y generas una baja real.<\/p>\n\n\n\n

        Esas las ver\u00e1s en RequestBin pero ya con la informaci\u00f3n real del contacto.<\/p>\n\n\n\n

        \"Automatizaciones<\/figure>\n\n\n\n

        Entradas relacionadas:<\/p>\n\n\n\n