Crear cuenta Mailrelay Crear cuenta Mailrelay Crear cuenta Mailrelay

¿Cómo integrar Mailrelay en tu CRM, APP, plugin? Y ofrecer así más opciones a tus usuarios

Publicado por Mailrelay en noviembre 23, 2017

integrar mailrelay

Si desarrollas un CRM, APP, plugin, u otro tipo de plugin, integrar Mailrelay puede ser una opción muy interesante para destacar tu producto o servicio.

Las ventajas son diversas:

  1. Vas a ofrecer más opciones a tus usuarios, algo que siempre van a ver como positivo
  2. Mailrelay es una herramienta de email marketing líder con cientos de miles de usuarios, puedes aprovechar esa visibilidad
  3. Y que algunos de esos usuarios utilicen tu sistema

Realizar la integración es, de hecho, muy fácil de hacer gracias al API de Mailrelay.

Y además, 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.

¡Comenzamos!

¡Envía hasta 75.000 emails gratis!

¿Qué funciones del API de Mailrelay vamos a necesitar para la integración?

En este ejemplo vamos a pensar en una integración básica, es decir, el paso de los usuarios de tu CRM, APP o plugin a Mailrelay, para que el usuario final los tenga ahí disponibles y pueda enviarles campañas de email marketing.

Integrar Mailrelay de esta forma es muy fácil.

Luego hay más opciones claro, como lanzar campañas de email desde tu propia APP, CRM, etc. Pero esto ya requiere de un desarrollo mayor, y aunque el proceso es el mismo, aumentaría un poco la extensión de este post.

De todas formas, si te parece que sería algo de interés, déjanos un comentario.

Ahora, para la integración que comentábamos, vamos a necesitar estas funciones del API:

Nada más, con esas funciones podemos trabajar, y vamos a ver cómo.

► ¿Cuál es el proceso que vamos a seguir para integrar nuestros usuarios con Mailrelay?

Muy fácil, paso a paso lo que vamos a hacer es esto:

  1. Comprobar si el contacto que queremos pasar ya existe en Mailrelay
  2. Si no existe, lo añadimos como nuevo contacto
  3. Y si existe, lo actualizamos de ser necesario
  4. Opcionalmente podemos borrarlo o darlo de baja si es necesario

Vamos a ir entonces paso a paso.

1) Comprobar si el suscriptor ya existe

Lo primero es comprobar si el contacto ya existe, pues de existir no lo vamos a poder añadir, dado que no podemos tener emails duplicados en Mailrelay.

Para comprobarlo haremos uso de getSubscribers.

En la descripción del API puedes ver un ejemplo del código que puedes utilizar, que viene a ser algo así:

ejemplo API Mailrelay

Es el código básico para consultar si un contacto existe, consultamos utilizando su email.

En caso de existir la consulta nos devolverá un array con todos los datos del contacto, como el nombre, email, grupos en los que aparece, etc.

Y algo más, el ID del suscriptor:

Array
(
[0] => stdClass Object
(
[id] => 2
[name] =>

¿Y en caso de que el contacto no exista?

En ese caso la función devolverá un array vacio.

Array
(
)

Y así sabremos que ese email no existe en el sistema, por lo que podemos proceder a añadirlo.

¿Hasta ahora integrar Mailrelay con cualquier software parece muy sencillo verdad? Pues no se va a complicar demasiado.

2) Añadir un nuevo suscriptor

En caso de que el suscriptor  no exista directamente lo podemos añadir, aunque seguramente te preguntarás ¿qué pasa si intentamos añadir un suscriptor que ya existe? Bueno, nada grave, el sistema simplemente nos avisa:

  1. stdClass Object ( [status] => 0 [error] => email: El email ya existe )

Y por lo tanto, no lo añade.

En este caso para añadir un suscriptor utilizaremos la función addSubscriber. Con un código similar a este:

ejemplo api mailrelay

Los parámetros básicos y obligatorios son:

  1. Nombre
  2. Email
  3. Y el grupo

Importante: el contacto ya estará activo y no necesitará ser activado por email, pues se trata de una importación desde un sistema CRM, ecommerce, etc. En el cual ya se habrá debido de validar el contacto antes de pasarlo a Mailrelay.

En caso de necesitarlo, el contacto se puede inactivar, y se podría generar una programación para activarlo, a través de un email, por ejemplo, pero por defecto se entiende que el uso del API es solo una migración de datos ya validados previamente.

¿Qué devolvería esta llamada?

De efectuarse de forma positiva la llamada, lo que devolvería sería algo así:

object(stdClass)#1 (2) {
[“status”]=>
int(1)
[“data”]=>
int(9)
}

Hemos de fijarnos en que devuelve el ID del suscriptor (en el ejemplo sería el 9).

Bueno, ahora ya hemos hecho dos cosas, comprobar si el suscriptor existe, y en caso de no existir, lo añadimos. Nos queda el siguiente punto, que sería el caso de que ya exista, y debamos de actualizarlo.

3) Actualizar un suscriptor existente

Este es un caso habitual, después de pasar por el punto primero actualizamos, utilizando la función updateSubscriber:

API Mailrelay

Si la función tiene éxito, devolverá:

bool (true)

Este código también es muy sencillo, pero hay algunos puntos a tener en cuenta:

  1. Necesitamos el ID del suscriptor, esto lo podemos obtener en el punto 1 con getSubscribers
  2. Tenemos que pasar todos los grupos en el que queremos que esté el suscriptor

Este último punto es importante, así que haré énfasis en ello.

La actualización 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á al grupo 3.

Si queremos que el suscriptor esté en el grupo 1 y 3 tendremos que pasar ambos valores en el array.

Igual pasa con los campos personalizados (customFields), si no lo pasamos, los campos personalizados se vaciarán. Tenemos que pasar todos los datos que queremos que contenga el suscriptor.

No es problema.

Porque en el punto 1 con getSubscribers habremos obtenido toda la información del suscriptor.

4) unsubscribe y deleteSubscriber

Estas dos funciones unsubscribe y deleteSubscriber son muy sencillas, pues solo tenemos que pasar el email del subscriptor.

¿Cuál es la diferencia?

La baja, unsubscribe permite que en un futuro el subscriptor pueda volver a suscribirse, mientras que si está eliminado no lo podrá hacer. Esa es la diferencia.

Hay más funciones en el API de Mailrelay

Para preparar envíos, obtener estadísticas, realizar importaciones masivas, etc.

Sin embargo en este breve tutorial he querido presentar las opciones mínimas que permiten integrar Mailrelay con muchos tipos de software. Como APPs, plugins de popups, CRMs, etc.

Y en cualquier caso el uso del API es muy sencillo e intuitivo, incluyendo ejemplos de uso en PHP para la mayoría de las funciones.

Motivos para integrar Mailrelay en tu CRM, APP, plugin, o cualquier otro software

Los motivos para integrar Mailrelay son  muchos, por un lado Mailrelay es uno de los programas de email marketing líderes. Por lo que cuenta con un gran volumen de usuarios, lo que hace más rentable el esfuerzo de la integración.

Mailrelay es además un programa utilizado por grandes empresas, bloggers, e infinidad de pequeñas empresas y pymes, con la mayor cuenta gratuita sin restricciones:

Por lo que la integración puede también ayudar a conseguir visibilidad a la empresa integradora.

Además, integrar Mailrelay es muy sencillo gracias al API de desarrollo, y es algo que ya han hecho empresas como:

  1. Thrive Leads
  2. Privy
  3. MyThemeShop
  4. Optingun
  5. Etc.

Que ya están ofreciendo una funcionalidad extra a sus usuarios.

jose-argudo

Suscríbete al blog y recibe los mejores contenidos semana a semana:







Acepto la política de privacidad.



Comentarios

  1. Pedro

    Excelente y clara explicación!
    Gracias

    07/12/2018 - 11:19:06 Publicar una respuesta

Deja un comentario

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *


Menu Title