Envios mailing transaccionales
Introducción
Los envíos de email transaccionales son envíos que se realizan automáticamente al ejecutarse una acción preestablecida. En esta documentación se detalla la integración que ha de realizar en su plataforma para poder utilizar este servicio. Será necesario:
- Ser propietario de una base de datos.
- Configurar una dirección de IP válida desde la que enviar los emails.
- Configurar un dominio y una dirección de email desde la que enviar.
- Integrar el código en su plataforma.
Bases de datos
Para poder realizar envíos transaccionales, debe ser propietario de, al menos, una base de datos (BBDD) en Mobeleader. Si no lo es, cree una base de datos en la sección Integración BBDD o consulte con su administrador. Introduzca los datos de su BBDD:
Una vez creada, podrá consultar las características de su BBDD desde la sección BBDD del Panel Mobeleader:
Configuración de IPs válidas
Si ya es propietario de una BBDD, lo siguiente que debe hacer es asociar una dirección IP a la BBDD que quiera usar como referencia. Esta dirección IP ha de coincidir con la dirección IP desde la que envíe el email transaccional, es decir, la dirección IP del servidor en el que se aloje el archivo desde el que se ejecute el envío.
Para asociar una IP a su base de datos, deberá hacerlo desde la sección IPs válidas del Panel Mobeleader. Se mostrará una lista con sus bases de datos (siempre y cuando haya creado una).
Pulse el botón Añadir nueva IP e introduzca el valor de la dirección IP en el cuadro de texto.
Una vez introducida la dirección IP, pulse el botón Guardar IP y ésta quedará asociada a la BBDD. Puede eliminar o cambiar el valor de cualquier dirección IP cuando lo desee.
Configuración del dominio y la dirección de email de envío
Para que el sistema reconozcan el email adress (dirección de email) desde el que quiera realizar sus envíos transaccionales, debe configurar al menos un dominio y asignar el email adress a ese dominio. Para crear el dominio, deberá hacerlo desde la sección Crear Dominio.
Al asociar los senders externos al dominio, asegúrese de que al menos uno de ellos pueda realizar envíos transaccionales. Puede comprobar los tipos de envío de cada sender externo en la sección Senders externos.
Una vez tenga asociado el dominio a la BBDD, ha de asignar a ese dominio el email adress desde el cual realizar sus envíos transaccionales. Para crear y asignar el email adress, debe hacerlo desde la sección Crear Email.
Al asociar el sender externo al email adress, asegúrese de que éste pueda realizar envíos transaccionales.
Integración del código en su plataforma
Una vez tenga la dirección IP, el dominio y el email configurados correctamente y asociados a una base de datos, deberá descargar el archivo Mobeleadermailing e implementarlo al archivo PHP desde el que quiera realizar el envío transaccional. Puede descargar el archivo desde aquí.
Para realizar el envío desde su archivo, cree un objeto de la clase MobeleaderMailing, añadiendo el código hash de la BBDD que vaya a utilizar como referencia en el constructor de la clase. Obtenga el código hash de la BBDD desde la sección IPs Válidas, pulsando en el icono Archivo Eye.png Ver Hash de la BBDD que corresponda.
Recuerde que la dirección IP desde la que vaya a realizar el envío ha de estar previamente asociada a la BBDD de referencia.