API Mailchimp NodeJS: cómo conectar y crear miembros en lista

Como sabemos uno de los mejores métodos para promover nuestro negocio es email marketing y si usamos la API Mailchimp Nodejs, seguro tendremos excelentes resultados en nuestra app. Aunque tenemos varias empresas para escoger, mailchimp tiene ciertas ventajas cuando un negocio está dando sus primeros pasos.

Hoy veremos cómo podemos conectar la api de mailchimp con nuestro desarrollo en NodeJs para crear nuevos miembros en una lista de contactos predeterminada.

Eduardo Arias

• Repositorio: haz click aquí para ver el repositorio del curso en el commit actual de la sesión 8.
• Mailchimp: aquí debes crear una cuenta para poder conectar con nodejs.
• Documentación mailchimp: haz click aquí para ver la documentación de la API de mailchimp.
• Estructura de API mailchimp: haz click aquí para ver la documentación sobre la estuctura correcta de API.

Solicitar API Key en Mailchimp

El primer paso es solicitar directamente la API KEY en nuestra cuenta de mailchimp. Claro que debes ya tener una cuenta gratuita en mailchimp. Una vez creada, puedes ir a «account & billing» > «Extras» > Api keys. Solicítala y guarda la api en un blog de notas, ya que lo usaremos más adelante.

Creando método POST para suscribir

Bueno este paso es el más complejo, pero en teoría lo que debemos hacer es crear el método que recibe los datos enviados, para poder suscribir al usuario. Enrtonces vamos a iniciar.

let email    = req.body.email;
let nombre   = req.body.nombre;
let apellido = req.body.apellido;

Lo primero será guardar las variables que vienen del formulario enviado y les asignamos un nombre para usar dentro del método.

const data = {
        members: [
            {
                email_address: email,
                status: "subscribed",
                merge_fields: {
                    FNAME: nombre,
                    LNAME: apellido
                }
            }
        ]
    };

Lo siguiente es crear el objeto que será enviado en la API para poder suscribir al usuario. Al inicio del post, puedes ver los links para revisar la información sobre la estructura de los datos que se envían. Aquí dentro de los «merge_fields» ponemos los datos obtenidos, también en la propiedad «email_Address». El estatus por preferencia puede cambiar, pero lo dejamos de una vez suscrito.

const jsonData = JSON.stringify(data);

Por ´ulimo, convertimos los datos en JSON para ser enviado a mailchimp.

Configurar API

Como ya tenemos los datos que se van a enviar y el cómo se enviarán, solo nos falta configurar el camino y para esto usaremos en el proceso el módulo http request. Este nos permitirá usar en la solicitud HTTP el método post.

 const url = "https://us20.api.mailchimp.com/3.0/lists/IDDELALISTA";

Esta URI de API tiene dos puntos que debes buscar en tu propia cuenta:

• Qué numero de «us» es. Puedes observarlo al inicio de la URL de tu cuenta de mailchimp. Si es «us6», cámbialo en la URL.
• ID DE LA LISTA: este id es el de la lista de contactos a la cual llegarán los usuarios suscritos. Puedes encontrarla en «todos los contactos» > «settings» > «Audience name». Una vez dentro, en la parte derecha verás el número del id. Copia y pega en la parte final de la url.

const options = {
        method: "POST",
        auth: "usuario:APIKEY"
    }

El siguiente paso es crear la autenticación de la API y esto se logra con el usuario que se obtiene para ingresar a mailchimp, y la API KEY obtenida en el primer paso, separados por dos puntos y ambos en medio de comillas.

 const request = https.request(url, options, function(response){
        
        
        // EN DADO CASO DE QUE TENGA EXITO
        if(response.statusCode===200){ res.redirect("/gracias");}
        else{res.redirect("/"); }
        
        
        
        //buscar una respuesta
        response.on("data", function(data){
            console.log(JSON.parse(data));
        });
    });

Por último, si usamos HTTP REQUEST, donde como argumento, ponemos la URL creada, y en la función callback tenemos 2 opciones: si tiene o no éxito. Si tiene, redireccione a una página (en mi caso /gracias), si no tiene éxito, entonces que imprima lo obtenido.

// enviar información a mailchimp
    request.write(jsonData);
    // hemos terminado
    request.end();

Por último enviamos y finalizamos la solicitud. Al probar el método, debes ya poder visualizar en la lista de mailchimp, el usuario creado desde el formulario que envió el método post.

Video de ayuda

hice este video para ayudarte en el proceso de la configuración. Haz click para ver y si te gusta, no olvides dar like y suscribirte!

Producto sugerido

Si eres como yo que pasa bastatne tiempo frente al compu, puede que la barra de luz te sirva bastante para cuidar tu vista en esas largas jornadas. También te dejo aquí el post para que veas la reseña completa.

Conclusión

En esta última sesión, conocer la conexión de api mailchimp, es clave para poder promover a nuestros clientes diferentes campañas de email marketing.