Questa funzionalità viene utilizzata per inviare, attraverso l'API di MDirector, e-mail con contenuti presenti in un altro sistema. In questo modo, i clienti con accesso alle API possono effettuare una connessione per inviare il contenuto di quel sistema esterno a un modello precedentemente definito in MDirector ed essere in grado di inviare campagne e-mail ai contatti con quel contenuto.
Ad esempio: un marchio vuole creare tramite API un mailing settimanale con notizie sul suo mercato. Ha un html con una struttura generale che sarà utilizzata per ogni mailing il cui contenuto sarà riempito automaticamente dal vostro sistema. Quando si crea il mailing tramite API, il contenuto generale, cioè le notizie della settimana, verrà compilato con la stessa chiamata API, mentre se c'è una personalizzazione dei contatti, i placeholder rimarranno intatti in modo da poter essere compilati al momento dell'invio del mailing.
Importante: distinguere i placeholder di contenuto dai placeholder di contatto. Se viene creato un invio API con campi che hanno lo stesso nome di un campi di contatto (predefinito o personalizzato), il placeholder contenuto prevarrà e quindi il placeholder contatto non verrà preso in considerazione.
Ad esempio: se si vuole inserire un nome di newsletter diverso ogni mese, ad esempio "Newsletter di primavera", "Newsletter d'estate", ecc. e si vuole anche personalizzare la newsletter con il nome del contatto che la riceve "Newsletter per Paquita Salas", il placeholder per il nome della newsletter non può essere [Name], ma uno che identifichi bene questo campo, come [NameNewsletter] o un altro completamente diverso, come quello che abbiamo usato nell'esempio qui sotto [TituloGrande].
Passi per programmare un invio API con contenuti:
- Creare un nuovo modello in "Modelli":
- I contenuti diversi per ogni campagna sono inclusi come placeholder.
In questo esempio, i placeholder sono:
[TituloGrande]
[Titular1]
[ImagenCabeceraGrande]
[Desarrollo1]
[Name] e [Lastname1] sono inclusi anche per personalizzare a livello di contatto (attenzione, se questi campi fossero inviati nella chiamata API, verrebbero compilati al momento della creazione dell'invio e sarebbero quindi gli stessi per tutti i contatti).
I campi contenenti immagini, come in questo caso [ImagenCabeceraGrande], sono inclusi all'interno dell'immagine nell'opzione "URL immagine" come segue:
- La chiamata API sarà effettuata dal seguente link: https://api.mdirector.com/api_delivery
Si programma includendo questi due parametri:
templateId: identificatore del modello che viene copiato e incollato da "templates".
templateVariables: un array con i valori dei placeholder del contenuto (in questo caso tutti tranne [Name] e [Lastname1]).
Esempio completo di chiamata API con parametri del modello in arancione:
{
"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 risposta della chiamata (se è ok (200)) restituisce tra l'altro il parametro "envId", che è l'identificativo dell'invio che è stato creato. Questo identificativo deve essere utilizzato nella chiamata PUT effettuata per programmare l'invio.
{
"response": "ok",
"message": "The delivery was successfully created",
"data": {
"camId": "102",
"envId": "515",
"subId": "678",
"html": "\n <!DOCTYPE html ……………………………….
}
- Una volta effettuata la chiamata POST di cui sopra, l'invio è stato creato in bozza in MDirector come segue:
- La programmazione dell'invio può essere effettuata nel modo consueto tramite API con il metodo PUT con i seguenti parametri:
{
"envId": "515",
"date": "now"
}
e la risposta della chiamata se tutto è andato bene è:
{
"response": "ok",
"message": "The delivery '515' was successfully scheduled for '2023-07-03 11:49'"
}
L'invio arriverà con i campi compilati, sia a livello di contatto sia a livello di contenuto:
NOTA
Lavoriamo costantemente per rendere la nostra piattaforma più facile da usare, in modo che possiate trarne il massimo beneficio. Se avete già esaurito le nostre risorse di supporto e video, contattate il nostro team di assistenza e saremo lieti di aiutarvi all'indirizzo soporte@mdirector.com
Commenti