Hoy me ha surgido un caso muy particular en mi labor como desarrollador web y lo quería compartir con todos vosotros. Os pongo en situación. Se trataba de una web cuyos formularios de newsletter estaban creados mediante el popular plugin de Mailchimp ya que utilizaba esta plataforma para realizar sus campañas de mail marketing. El caso es que el cliente estaba cansado de la herramienta del mailing masivo y había conocido Acumbamail, una plataforma similar, pero de origen español. Según su punto de vista, le daba mucha más confianza.
Al indicarme esto, pensé enseguida en el plugin para WordPress que ofrece la propia Acumbamail. Pero el cliente me frenó los pies. Me indicó que en otras webs en las que es administrador utilizaba el plugin Gravity Forms, ya que pagaba la licencia. Me solicitó crear los formularios de newsletter de esta web mediante Gravity Forms y que los registros se enviaran automáticamente a Acumbamail para que se diesen de alta directamente como nuevos suscriptores en una lista específica. ¿Era esto posible? Pues tras investigar un poco me di cuenta de que, a pesar de lo enrevesado de la propuesta, era bastante sencillo. Os cuento como insertar suscriptores en una lista de Acumbamail mediante un formulario creado con Gravity Forms sin utilizar plugins.
Auth_token de Acumbamail
Acumbamail dispone de una API la cual podemos utilizar para nuestros propósitos, como por ejemplo, el de añadir suscriptores. Lo primero que necesitamos es hacernos con un auth_token, que vinculará la API con nuestro usuario en Acumbamail. Así que, para conseguir el auth_token, tendrás que loguearte en la plataforma e ir a esta página. Es importante loguearte antes de entrar en dicha página, de lo contrario no podrás copiar el auth_token.
Una vez dentro de esta página, copia el auth_token que podrás ver en la sección Identificador de cliente. Lo necesitaremos más tarde.
ID de la lista de Acumbamail
Espera, aún no abandones Acumbamail porque necesitamos otro dato de la plataforma. Para ello, ingresa en el backoffice de Acumbamail y ve a la sección Listas. Ahora, edita la lista en la que quieras que ingresen los nuevos suscriptores de tu formulario de newsletter ya que necesitamos su identificador. ¿Cómo localizarlo? Muy sencillo. Una vez entres dentro la lista, fíjate en la URL. Será algo así como: https://acumbamail.com/list/XXXXXX/. Lo que necesitamos es el valor numérico de esa URL. Es decir, lo que he sustituido por XXXXXX en el ejemplo anterior. Copia también este dato, lo necesitaremos después.
Conectar nuestro formulario de Gravity con la API
Ahora ya podemos volver al backoffice de nuestra instalación de WordPress con la información que hemos recabado. Para conectar el formulario de newsletter creado con Gravity Forms con la API de Acumbamail, necesitaremos un addon de dicho plugin. El addon en concreto es Gravity Forms Webhooks. Nos permitirá enviar la información del formulario a la API de Acumbamail de manera totalmente transparente para el usuario, para así agregarlo a la lista.
Descarga el plugin e instálalo en tu WordPress. Una vez instalado, actívalo para que podamos conectarlo con la API.
Ya con el plugin activado, en el backoffice de WordPress, ve a Forms y edita el formulario de newsletter.
Dentro del detalle del formulario, en el menú superior, si despliegas la pestaña Settings, verás una nueva opción llamada Webhooks. Clica en ella para poder configurar la API en el formulario.
A continuación tendrás que crear un nuevo Webhook feed, así que pulsa en el botón Add new.
Ahora, en esta nueva página, tendremos que configurar el Webhook feed. Lo primero que tenemos que hacer es darle un nombre descriptivo mediante el campo «Name». Personalmente te recomendamos el nombre de «Acumbamail».
Ahora viene la parte más importante, introducir la «Request URL». En este campo es donde tendremos que integrar los datos que hemos copiado antes. La URL a ingresar en concreto es esta:
https://acumbamail.com/api/1/addSubscriber/?auth_token=TU_AUTH_TOKEN&list_id=ID_LISTA&merge_fields[email]=CAMPO_EMAIL
En la URL anterior tendrás que sustituir varios parámetros. Te explico:
- Sustituye TU_AUTH_TOKEN por el auth_token que hemos copiado antes
- Sustituye ID_LISTA por el identificador de la lista que en el paso anterior hemos copiado de la URL
- Por último, tendrás que sustituir CAMPO_EMAIL por el campo email del formulario. ¿Cómo? Muy sencillo. Elimina CAMPO_EMAIL de esta URL y pulsa sobre el icono con texto y una flecha hacia abajo que hay a la derecha del campo «Request URL» y selecciona tu campo email. Automáticamente se agregará al campo.
Y… voìla. Ya tendremos la URL formada.
Selecciona la opción GET en el campo «Request Method», y la opción FORM en el campo «Request Format». Ahora pulsa Update Settings para guardar los cambios.
Con esto, cada vez que alguien haga submit en el formulario de newsletter de tu web, se agregará automáticamente en la lista que has seleccionado de Acumbamail. Sencillo, ¿verdad?
Y hasta aquí nuestro artículo sobre cómo insertar suscriptores en una lista de Acumbamail mediante un formulario creado con Gravity Forms sin utilizar plugins. Espero que te haya gustado y, si te ha resultado útil, no dudes en compartirlo en redes sociales. ¡Nos leemos!
