{"id":39121,"date":"2017-11-23T09:00:42","date_gmt":"2017-11-23T09:00:42","guid":{"rendered":"https:\/\/wp.lvh.me\/blog\/2017\/11\/23\/como-integrar-mailrelay-en-tu-crm-app-plugin-y-ofrecer-asi-mas-opciones-a-tus-usuarios\/"},"modified":"2022-05-08T15:27:53","modified_gmt":"2022-05-08T15:27:53","slug":"como-integrar-mailrelay-en-tu-crm-app-plugin-y-ofrecer-asi-mas-opciones-a-tus-usuarios","status":"publish","type":"post","link":"https:\/\/wpstaging.mailrelay.com\/es\/blog\/2017\/11\/23\/como-integrar-mailrelay-en-tu-crm-app-plugin-y-ofrecer-asi-mas-opciones-a-tus-usuarios\/","title":{"rendered":"\u00bfC\u00f3mo integrar Mailrelay en tu CRM, APP, plugin? Y ofrecer as\u00ed m\u00e1s opciones a tus usuarios"},"content":{"rendered":"

\"integrar<\/p>\n

Si desarrollas un CRM, APP, plugin, u otro tipo de plugin, integrar Mailrelay puede ser una opci\u00f3n muy interesante para destacar tu producto o servicio.<\/p>\n

<\/p>\n

Las ventajas son diversas:<\/p>\n

[su_list icon=\u00bbicon: asterisk\u00bb icon_color=\u00bb#008af7″]<\/p>\n

    \n
  1. Vas a ofrecer m\u00e1s opciones a tus usuarios, algo que siempre van a ver como positivo<\/li>\n
  2. Mailrelay es una herramienta de email marketing<\/a> l\u00edder con cientos de miles de usuarios, puedes aprovechar esa visibilidad<\/strong><\/li>\n
  3. Y que algunos de esos usuarios utilicen tu sistema<\/strong><\/li>\n<\/ol>\n

    [\/su_list]<\/p>\n

    Realizar la integraci\u00f3n es, de hecho, muy f\u00e1cil de hacer gracias al API de Mailrelay<\/a>.<\/p>\n

    Y adem\u00e1s, hoy vamos a ver un tutorial que va a aclarar todas las dudas que puedas tener sobre el proceso de integrar Mailrelay con tu sistema.<\/p>\n

    \u00a1Comenzamos!<\/strong><\/p>\n\n

    \"\u00a1Env\u00eda<\/a><\/p>\n

    \u00bfQu\u00e9 funciones del API de Mailrelay vamos a necesitar para la integraci\u00f3n?<\/h2>\n

    En este ejemplo vamos a pensar en una integraci\u00f3n b\u00e1sica, es decir, el paso de los usuarios de tu CRM, APP o plugin a Mailrelay<\/strong>, para que el usuario final los tenga ah\u00ed disponibles y pueda enviarles campa\u00f1as de email marketing<\/a>.<\/p>\n

    Integrar Mailrelay de esta forma es muy f\u00e1cil.<\/p>\n

    Luego hay m\u00e1s opciones claro, como lanzar campa\u00f1as de email desde tu propia APP, CRM, etc. Pero esto ya requiere de un desarrollo mayor, y aunque el proceso es el mismo, aumentar\u00eda un poco la extensi\u00f3n de este post.<\/p>\n

    De todas formas, si te parece que ser\u00eda algo de inter\u00e9s, d\u00e9janos un comentario.<\/strong><\/p>\n

    Ahora, para la integraci\u00f3n que coment\u00e1bamos, vamos a necesitar estas funciones del API:<\/p>\n

    [su_list icon=\u00bbicon: asterisk\u00bb icon_color=\u00bb#008af7″]<\/p>\n

      \n
    1. getSubscribers<\/strong><\/a><\/li>\n
    2. addSubscriber<\/strong><\/a><\/li>\n
    3. updateSubscriber<\/strong><\/a><\/li>\n
    4. unsubscribe<\/strong><\/a><\/li>\n
    5. deleteSubscriber<\/strong><\/a><\/li>\n<\/ol>\n

      [\/su_list]<\/p>\n

      Nada m\u00e1s, con esas funciones podemos trabajar, y vamos a ver c\u00f3mo.<\/p>\n

      \u25ba \u00bfCu\u00e1l es el proceso que vamos a seguir para integrar nuestros usuarios con Mailrelay?<\/h3>\n

      Muy f\u00e1cil, paso a paso lo que vamos a hacer es esto:<\/p>\n

      [su_list icon=\u00bbicon: asterisk\u00bb icon_color=\u00bb#008af7″]<\/p>\n

        \n
      1. Comprobar si el contacto que queremos pasar ya existe en Mailrelay<\/li>\n
      2. Si no existe, lo a\u00f1adimos como nuevo contacto<\/li>\n
      3. Y si existe, lo actualizamos de ser necesario<\/li>\n
      4. Opcionalmente podemos borrarlo o darlo de baja si es necesario<\/li>\n<\/ol>\n

        [\/su_list]<\/p>\n

        Vamos a ir entonces paso a paso.<\/p>\n

        1) Comprobar si el suscriptor ya existe<\/h2>\n

        Lo primero es comprobar si el contacto ya existe, pues de existir no lo vamos a poder a\u00f1adir, dado que no podemos tener emails duplicados en Mailrelay.<\/p>\n

        Para comprobarlo haremos uso de getSubscribers<\/a>.<\/strong><\/p>\n

        En la descripci\u00f3n del API puedes ver un ejemplo del c\u00f3digo que puedes utilizar, que viene a ser algo as\u00ed:<\/p>\n

        \"ejemplo<\/p>\n

        Es el c\u00f3digo b\u00e1sico para consultar si un contacto existe, consultamos utilizando su email.<\/p>\n

        En caso de existir la consulta nos devolver\u00e1 un array con todos los datos del contacto, como el nombre, email, grupos en los que aparece, etc.<\/strong><\/p>\n

        Y algo m\u00e1s, el ID del suscriptor:<\/strong><\/p>\n

        Array<\/em>
        \n(<\/em>
        \n [0] => stdClass Object<\/em>
        \n (<\/em>
        \n [id] => 2<\/em>
        \n [name] => <\/em><\/p>\n

        …<\/em><\/p>\n

        \u00bfY en caso de que el contacto no exista?<\/h3>\n

        En ese caso la funci\u00f3n devolver\u00e1 un array vacio.<\/p>\n

        Array<\/em>
        \n(<\/em>
        \n)<\/em><\/p>\n

        Y as\u00ed sabremos que ese email no existe en el sistema, por lo que podemos proceder a a\u00f1adirlo.<\/p>\n

        \u00bfHasta ahora integrar Mailrelay con cualquier software parece muy sencillo verdad?<\/strong> Pues no se va a complicar demasiado.<\/p>\n

        2) A\u00f1adir un nuevo suscriptor<\/h2>\n

        En caso de que el suscriptor\u00a0 no exista directamente lo podemos a\u00f1adir, aunque seguramente te preguntar\u00e1s \u00bfqu\u00e9 pasa si intentamos a\u00f1adir un suscriptor que ya existe?<\/strong> Bueno, nada grave, el sistema simplemente nos avisa:<\/p>\n

        [su_list icon=\u00bbicon: asterisk\u00bb icon_color=\u00bb#008af7″]<\/p>\n

          \n
        1. stdClass Object ( [status] => 0 [error] => email: El email ya existe )<\/li>\n<\/ol>\n

          [\/su_list]<\/p>\n

          Y por lo tanto, no lo a\u00f1ade.<\/p>\n

          En este caso para a\u00f1adir un suscriptor utilizaremos la funci\u00f3n addSubscriber<\/strong><\/a>. Con un c\u00f3digo similar a este:<\/p>\n

          \"ejemplo<\/p>\n

          Los par\u00e1metros b\u00e1sicos y obligatorios son:<\/p>\n

          [su_list icon=\u00bbicon: asterisk\u00bb icon_color=\u00bb#008af7″]<\/p>\n

            \n
          1. Nombre<\/li>\n
          2. Email<\/li>\n
          3. Y el grupo<\/li>\n<\/ol>\n

            [\/su_list]<\/p>\n

            Importante: el contacto ya estar\u00e1 activo y no necesitar\u00e1 ser activado por email, pues se trata de una importaci\u00f3n desde un sistema CRM, ecommerce, etc. En el cual ya se habr\u00e1 debido de validar el contacto antes de pasarlo a Mailrelay.<\/strong><\/p>\n

            En caso de necesitarlo, el contacto se puede inactivar, y se podr\u00eda generar una programaci\u00f3n para activarlo, a trav\u00e9s de un email, por ejemplo, pero por defecto se entiende que el uso del API es solo una migraci\u00f3n de datos ya validados previamente.<\/p>\n

            \u00bfQu\u00e9 devolver\u00eda esta llamada?<\/h3>\n

            De efectuarse de forma positiva la llamada, lo que devolver\u00eda ser\u00eda algo as\u00ed:<\/p>\n

            object(stdClass)#1 (2) {<\/em>
            \n [\u00abstatus\u00bb]=><\/em>
            \n int(1)<\/em>
            \n [\u00abdata\u00bb]=><\/em>
            \n int(9)<\/em>
            \n }<\/em><\/p>\n

            Hemos de fijarnos en que devuelve el ID del suscriptor<\/span> (en el ejemplo ser\u00eda el 9<\/strong>)<\/em>.<\/p>\n

            Bueno, ahora ya hemos hecho dos cosas, comprobar si el suscriptor existe, y en caso de no existir, lo a\u00f1adimos. Nos queda el siguiente punto, que ser\u00eda el caso de que ya exista, y debamos de actualizarlo.<\/p>\n

            3) Actualizar un suscriptor existente<\/h2>\n

            Este es un caso habitual, despu\u00e9s de pasar por el punto primero actualizamos, utilizando la funci\u00f3n updateSubscriber<\/a>:<\/strong><\/p>\n

            \"API<\/p>\n

            Si la funci\u00f3n tiene \u00e9xito, devolver\u00e1:<\/p>\n

            bool (true)<\/em><\/p>\n

            Este c\u00f3digo tambi\u00e9n es muy sencillo, pero hay algunos puntos a tener en cuenta:<\/p>\n

            [su_list icon=\u00bbicon: asterisk\u00bb icon_color=\u00bb#008af7″]<\/p>\n

              \n
            1. Necesitamos el ID del suscriptor, esto lo podemos obtener en el punto 1 con getSubscribers<\/li>\n
            2. Tenemos que pasar todos<\/strong> los grupos en el que queremos que est\u00e9 el suscriptor<\/li>\n<\/ol>\n

              [\/su_list]<\/p>\n

              Este \u00faltimo punto es importante, as\u00ed que har\u00e9 \u00e9nfasis en ello.<\/p>\n

              La actualizaci\u00f3n requiere de que pasemos todos los valores del suscriptor. Por ejemplo, si el suscriptor ya pertenece al grupo 1, y en el array groups pasamos el valor 3, el suscriptor solo pertenecer\u00e1 al grupo 3.<\/strong><\/p>\n

              Si queremos que el suscriptor est\u00e9 en el grupo 1 y 3 tendremos que pasar ambos valores en el array.<\/p>\n

              Igual pasa con los campos personalizados (customFields)<\/em>, si no lo pasamos, los campos personalizados se vaciar\u00e1n. Tenemos que pasar todos los datos que queremos que contenga el suscriptor.<\/strong><\/p>\n

              No es problema.<\/p>\n

              Porque en el punto 1 con getSubscribers habremos obtenido toda la informaci\u00f3n del suscriptor.<\/strong><\/p>\n

              4) unsubscribe y deleteSubscriber<\/h2>\n

              Estas dos funciones unsubscribe<\/a> y deleteSubscriber<\/a> son muy sencillas, pues solo tenemos que pasar el email del subscriptor.<\/p>\n

              \u00bfCu\u00e1l es la diferencia?<\/strong><\/p>\n

              La baja, unsubscribe permite que en un futuro el subscriptor pueda volver a suscribirse, mientras que si est\u00e1 eliminado no lo podr\u00e1 hacer. Esa es la diferencia.<\/p>\n

              Hay m\u00e1s funciones en el API de Mailrelay<\/h2>\n

              Para preparar env\u00edos, obtener estad\u00edsticas, realizar importaciones masivas, etc.<\/p>\n

              Sin embargo en este breve tutorial he querido presentar las opciones m\u00ednimas que permiten integrar Mailrelay con muchos tipos de software. Como APPs, plugins de popups, CRMs, etc.<\/p>\n

              Y en cualquier caso el uso del API es muy sencillo e intuitivo, incluyendo ejemplos de uso en PHP para la mayor\u00eda de las funciones.<\/p>\n

              Motivos para integrar Mailrelay en tu CRM, APP, plugin, o cualquier otro software<\/h2>\n

              Los motivos para integrar Mailrelay son\u00a0 muchos, por un lado Mailrelay es uno de los programas de email marketing<\/a> l\u00edderes. Por lo que cuenta con un gran volumen de usuarios, lo que hace m\u00e1s rentable el esfuerzo de la integraci\u00f3n.<\/p>\n

              Mailrelay es adem\u00e1s un programa utilizado por grandes empresas, bloggers, e infinidad de peque\u00f1as empresas y pymes, con la mayor cuenta gratuita sin restricciones<\/strong>:<\/p>\n