Hasta ahora, cuando querías importar suscriptores a tu cuenta de Mailrelay, si deseabas hacerlo a través del API, la única opción disponible era utilizar la función «addSubscriber«, y aunque su uso era bastante sencillo y cómodo, para grandes volúmenes de suscriptores podía ocasionar algunas dificultades.
Por eso nuestro equipo técnico a habilitado una nueva función para realizar la importación de grandes volúmenes de suscriptores. Se trata de la función «import«, que puedes ver en detalle en la documentación de la API para «import«.
De todos modos, si te interesa esta función, sigue leyendo, vamos a ver un ejemplo de uso paso a paso.
Para hacer email markting necesitamos suscriptores
Una forma de automatizar este proceso es a través del API, por ejemplo si tienes una tienda online, un CRM, una web, etc. Puedes exportar estos usuarios a un fichero CSV y posteriormente importarlos mediante el API.
Veamos los parámetros de esta función:
– apiKey -> tu clave de API, un parámetro imprescindible. Para generar esta clave, debes de acceder a tu cuenta de Mailrelay, luego al menú «Configuración» -> «acceso a la API» -> «generar» y ya tendrás la clave lista para copiar y pegar.
– fileContent -> el contenido del fichero que deseas importar.
– groups -> los IDs de los grupos a los que quieres importar los usuarios.
– fields -> mapeado entre los campos del fichero y los campos de Mailrelay, por defecto el primer campo es el email y el segundo el nombre del suscriptor.
– delimiter -> separador entre campos, por ejemplo una coma «,» suele ser lo habitual en ficheros CSV.
– enclosure -> delimitador de campos, por ejemplo comillas dobles «». Útil si los campos incluyen el separador, por ejemplo.
– headers -> si el fichero CSV incluye cabeceras defínelo a TRUE para que se ignore esta primera línea.
– existingEmails -> que sucede con los emails existentes «skip» para ignorar o «replace» para sustituir. Por defecto se utiliza «replace».
Sigamos ahora con un ejemplo práctico de uso de esta función, lo primero que necesitaremos es un fichero CSV con los suscriptores que deseamos importar para nuestra campaña de email markting. Por ejemplo algo así:
Como puedes ver los valores están contenidos entre comillas dobles y separados por una coma. Cada suscriptor en su propia línea.
Vamos ahora con el código PHP necesario para efectuar la importación:
Lo primero que hacemos es definir la URL de nuestra cuenta de Mailrelay y el API.
Justo después leemos el contenido del fichero de importación, es importante definir la ruta de forma correcta para que el fichero pueda ser leído.
Después preparamos la llamada a la función, con el contenido del fichero incluido, así como el grupo donde queremos importar los suscriptores.
IMPORTANTE: es necesario utilizar la función base64_encode para preparar el contenido.
El resto del código es el típico que utilizamos en las funciones del API, pero puedes ver todos los detalles en la descripción de la función «import«.
Si todo funciona bien el código devolverá el ID del fichero importado, en el caso del ejemplo el 5:
Luego si vamos a nuestra cuenta de Mailrelay, al menú «Importar» -> «Archivos importados«, podremos ver los ficheros que hemos importado:
Simplemente haciendo doble click en esta entrada podremos ver todos los emails importados en su propia tabla, y el estado de la importación:
Así podemos comprobar si las cuentas ya están listas para nuestra campaña de email markting.
Estos suscriptores también los podremos ver en la lista normal de suscriptores.
Como ves el proceso de importación es realmente sencillo gracias a esta nueva función.
Si quieres ver esta función y otras complementarias lo puedes hacer en nuestra documentación API:
– Import -> función que permite realizar la importación de ficheros.
– getImports -> función que nos devuelve una lista de los ficheros importados.
– getImportData -> devuelve los resultados de una importación concreta.
¡Esperamos que esta información te sea útil en tu email markting!