Luz Chaves
Esta funcionalidad se utiliza para enviar, a través del API de MDirector, emails con contenido que tengamos en otro sistema. De esta forma, los clientes con acceso de API pueden realizar una conexión para enviar el contenido de ese sistema externo a una plantilla previamente definida en MDirector y poder enviar campañas de email a los contactos con ese contenido.
Por ejemplo: una marca quiere crear por API un envío semanal con noticias sobre su mercado. Tiene un html con una estructura general que utilizará para cada envío cuyo contenido rellenará automáticamente desde su sistema. Al crear el envío por API el contenido general, es decir, las noticias de la semana las rellena con la misma llamada API, mientras que si hay personalización de contacto los placeholders permanecerán intactos para que se rellenen a la hora de realizar el envío.
Importante: distinguir los placeholders de contenido de los placeholders de contactos. Si un envío por API se crea con placeholders que tengan el mismo nombre que un campo de contacto (por defecto o personalizado), prevalecerá el de contenido y por tanto no se tendrá en cuenta el de contacto.
Por ejemplo: si se quiere incluir un nombre de newsletter diferente todos los meses por ejemplo “La newsletter de la primavera”, “La newsletter del verano”, etc. y también se quiere personalizar la newsletter con el nombre del contacto que la recibe “Newsletter para Paquita Salas”, el placeholder para nombre de la newsletter no puede ser [Name] sino uno que identifique bien ese campo como [NombreNewsletter] u otro totalmente diferente como el que hemos puesto en el ejemplo de abajo [TituloGrande]
Pasos para programar un envío por API con contenido:
- Crear una plantilla nueva en “Plantillas”:
- El contenido que sea diferente en cada campaña se incluye como placeholders.
En este ejemplo, los placeholders son:
[TituloGrande]
[Titular1]
[ImagenCabeceraGrande]
[Desarrollo1]
También se incluye [Name] y [Lastname1] para personalizar a nivel de contacto (cuidado, si se mandaran estos campos en la llamada al API se rellenaría en la creación del envío y por tanto serían para todos los contactos los mismos).
Los campos que contengan imágenes como en este caso [ImagenCabeceraGrande] se incluyen dentro de la imagen en la opción “URL imagen” del siguiente modo:
- La llamada al API se realizará desde el siguiente enlace: https://api.mdirector.com/api_delivery
Se programa incluyendo estos dos parámetros:
templateId: identificador de la plantilla que se copia y pega desde “plantillas“
templateVariables: un array con los valores para los placeholders de contenido (en este caso todos menos [Name] y [Lastname1]
Ejemplo completo de llamada al API con los parámetros de plantillas en naranja:
{
«type»: «email»,
«name»: «prueba plantilla 05»,
«subject»: «hola mundo 05»,
«campaignName»: «PlantillasAPI»,
«language»: «es»,
«segments»: «[\»574\»]»,
«templateId»: «98c1a5af-ba94-3afd-8d7b-77d3e166133e»,
«templateVariables»: {«TituloGrande»:»Newsletter del Verano»,
«Titular1″:»Noticia1»,
«Desarrollo1″:»Este es el contenido de la noticia 1 jhsh sfh dkfh dkfhdfkd hfkdj hfkjdhf kjdf hkdj hfkdjf hkdjf hkdjf hkdhfdkjhfkdj hfkjd hfkjd f»,
«ImagenCabeceraGrande»:»http://app.mdirector.com/files/user-template-resources/4/4/7/0/4470/56eb9666-1edf-3cd0-9123-59602ac1e7ad/43909974371_752410415f_b.jpg.jpegw:596h358x4y0.pngw:596h327x0y0.png»},
«fromName»: «Mary»,
«replyToName»: «Alex»,
«replyToEmail»: «aarribas@antevenio.com»
}
La respuesta de la llamada (si esta es ok (200)) devuelve entre otras cosas el parámetro “envId” que es el identificador del envío que se ha creado. Este identificador debe utilizarse en la llamada PUT que se haga para programar el envío.
{
«response»: «ok»,
«message»: «The delivery was successfully created»,
«data»: {
«camId»: «102»,
«envId»: «515»,
«subId»: «678»,
«html»: «\n <!DOCTYPE html ……………………………….
}
- Una vez hecha la llamada POST anterior, el envío se ha creado en borrador en MDirector de la siguiente forma:
- La programación del envío puede hacerse de la forma habitual por API con el método PUT con los siguientes parámetros:
{
«envId»: «515»,
«date»: «now»
}
y la respuesta de la llamada si todo ha ido ok es:
{
«response»: «ok»,
«message»: «The delivery ‘515’ was successfully scheduled for ‘2023-07-03 11:49′»
}
El envío llegará con los campos completados, tanto a nivel contacto como a nivel contenido:
NOTA
Trabajamos constantemente para hacer que sea más fácil de usar nuestra plataforma y que puedas sacarle todo el partido posible. Si ya has agotado nuestra ayuda y los recursos de vídeo que te ofrecemos, ponte en contacto con nuestro equipo de asistencia, estaremos encantados de atenderte en soporte@mdirector.com