¿Cómo integrar Mailrelay en su complemento, CRM o APLICACIÓN? Y ofrece más opciones para tus usuarios.

Si estás desarrollando 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 muchas:

Esta integración es, de hecho, un proceso muy sencillo, gracias a la API Mailrelay.

Sin embargo, para facilitarte aún más tu trabajo, hoy veremos un tutorial que aclarará todas las dudas que puedas tener en el proceso de integración de Mailrelay con tu sistema.

¡Empecemos!

¿Qué funciones de la API de Mailrelay necesitaremos durante el proceso de integración?

En este artículo veremos un ejemplo de integración básica, es decir, cómo sincronizar los usuarios de tu CRM, APP o plugin con Mailrelay, para que tus clientes tengan sus contactos disponibles en su cuenta y puedan enviarles newsletters.

Integrar Mailrelay de esta manera es muy fácil.

Además, existen opciones avanzadas, como el envío de campañas de correo electrónico desde tu APP, CRM, etc. Pero esto ya requiere un mayor desarrollo, y aunque el proceso es el mismo, aumentaría algo la extensión de este artículo.

De todos modos, si crees que sería algo de interés, puedes dejar un comentario, e intentaremos preparar otro post en el futuro sobre esto.

Ahora, para la integración que mencionamos, necesitaremos estas funciones de API:

Nada más, con estas funciones podemos integrar el software, y veremos cómo hacerlo.

► ¿Cuál es el proceso que debe seguir para integrar a los suscriptores con Mailrelay?

Es muy fácil, paso a paso, lo que haremos es:

Veamos el proceso paso a paso.

1) Verifique que el suscriptor ya exista

Lo primero es comprobar si el contacto ya existe, porque si no existe se puede agregar, ya que no es posible tener correos electrónicos duplicados en Mailrelay.

Para verificar esto, usaremos getSubscribers.

En la descripción de la API, puede ver un ejemplo del código que puede usar, que es algo como esto:

Es el código básico para comprobar si ya existe un contacto, la consulta se realizará utilizando la dirección de correo electrónico.

Si el contacto existe, el sistema devolverá una matriz con toda la información del suscriptor como nombre, correo electrónico, grupos en los que está registrado, etc.

Y también, el ID de suscriptor:

Formación
(
[0] => objeto stdClass
(
[id] => 2
[nombre] =>

...

¿Y en caso de que el contacto no exista?

En este caso, la función devuelve una matriz vacía.

Formación
(
)

Como está vacío, sabrá que este correo electrónico no existe en el sistema y podrá agregarlo.

Hasta ahora, la integración de Mailrelay con cualquier software parece muy fácil, ¿no? Bueno, no te preocupes, no será complicado.

2) Agregar un nuevo suscriptor

Si el suscriptor no existe podemos agregarlo, aunque seguro te preguntarás ¿qué pasa si intentamos agregar un suscriptor que ya existe? Bueno, nada serio, el sistema simplemente te advertiría que no se puede hacer:

Y por lo tanto no lo agregaría.

En este caso, para agregar un suscriptor, usaremos la función addSubscriber con un código similar al siguiente:

Los parámetros básicos y requeridos son:

Importante: El contacto ya estará activo y no necesitará ser confirmado por correo electrónico, ya que se está importando desde un sistema CRM, e-commerce, etc. Por lo que el contacto ya debería haber sido validado antes de ser registrado en nuestro software.

Si es necesario, el contacto puede ser desactivado y activado a través de un correo electrónico de confirmación, por ejemplo, pero por defecto, se entiende que el uso de la API es solo para la migración de datos previamente validados.

¿Qué devolvería esta llamada?

Si la llamada se realiza de forma positiva, lo que devolvería sería algo como:

object (stdClass) # 1 (2) {
["Estado"] =>
int (1)
["Datos"] =>
int (9)
}

Debemos prestar atención al hecho de que devolverá el ID de suscriptor (en el ejemplo sería 9).

Bueno, hasta ahora se han hecho dos procesos, verificamos que exista el suscriptor, y si no existe, lo agregamos. El siguiente paso es actualizar un suscriptor que ya existe.

3) Actualizar un suscriptor existente

Este es un caso habitual, después de pasar por el primer paso, podemos actualizar el suscriptor usando la función updateSubscriber:

Si la función funciona, devuelve:

bool (verdadero)

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

Este último punto es fundamental para que lo enfatice.

Esta función requiere que todos los datos del abonado estén informados. Por ejemplo, si el suscriptor ya pertenece al grupo 1 y en los grupos de arreglos indicas el valor 3, el suscriptor pertenecería solo al grupo 3.

Si desea que el suscriptor se registre para el grupo 1 y el grupo 3, debe indicar ambos valores en la matriz.

Lo mismo ocurre con los campos personalizados (customFields), si no están indicados, los campos personalizados estarán vacíos. Deberá indicar todos los datos que desea agregar para el suscriptor.

No es un problema.

Porque en el paso 1, con getSubscribers, ya se obtuvieron todos los datos.

4) darse de baja y eliminar suscriptor

Estas dos funciones, dar de baja y eliminar suscriptor se pueden utilizar sin ningún problema, solo inserta la dirección de correo electrónico del suscriptor.

¿Cual es la diferencia?

Darse de baja, darse de baja, permite al suscriptor volver a suscribirse en el futuro, mientras que si se elimina, no se puede volver a agregar.

Esa es la diferencia. Hay más funciones en la API de Mailrelay para crear un correo electrónico, obtener estadísticas, importar una base de datos, etc.

Sin embargo, en este breve tutorial, quería explicar solo las funciones que le permiten integrar Mailrelay con varios tipos de software, como APP, complementos, CRM, etc.

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

Razones para integrar Mailrelay en su CRM, APP, plugin o cualquier otro software.

Las razones para integrar Mailrelay son muchas, por un lado, Mailrelay es una de las principales herramientas de marketing por correo electrónico. Esto significa que un gran número de usuarios están utilizando nuestro software y el proceso de integración será aún más rentable.

Mailrelay también es un software utilizado por grandes empresas, blogueros e innumerables pequeñas empresas y pymes, con la mayor cuenta gratuita:

Por tanto, la integración también puede ayudar a ganar visibilidad.

Además, integrar Mailrelay es muy fácil gracias a la API para desarrolladores, y es algo que ya han hecho varias empresas, como por ejemplo:

Ya ofrecen funciones adicionales a sus usuarios.