❗️ Importante

Questo articolo fa riferimento a funzionalitá superate - API v2 e il vecchio linguaggio dei template. Queste informazioni possono essere utilizzate per modificare i modelli esistenti e le integrazioni API, ma non devono essere utilizzate per creare nuovi modelli o integrazioni. Invece, si prega di fare riferimento a questo articolo per creare e personalizzare il tuo modello e inviarlo tramite l'attuale API (v3).

Questa API ti offre la possibilità di inviare modelli creati su Sendinblue, attraverso Sendinblue SMTP (email transazionali). Questa API supporta solo il metodo POST. Di seguito trovi i campi da inviare quando fai chiamate API.

Parametro	Richiesto	Requisiti	Descrizione
User	Sì	Nome utente	Il nome utente si trova sulla pagina dei parametri
Key	Sì	Chiave Api	La chiave Api si trova sulla pagina dei parametri
Templateid	Sì	Fornire un id campagna valido il cui tipo è template	Deve essere l’id della campagna il cui tipo è ‘template’
To	Sì	Almeno un destinatario	Deve contenere uno o più destinatari (separati da ‘\|’). Deve essere un id email
Cc	No	Destinatario che deve ricevere una copia	Se inserito, l’id email deve essere valido.
Bcc	No	Destinatario che deve ricevere una copia all'insaputa degli altri destinatari	Se inserito, l’id email deve essere valido.
Attr_1….n	No	Gli attributi devono essere inseriti in formato JSON. Per esempio: `{"attr1":"valore","attr2":"valore"}`	Nel modello questo attributo deve essere inserito tra ‘%%’ in maiuscolo senza spazi (si consigliano caratteri non accentati). Se il valore di questo attributo è inserito nella richiesta, nell’email sarà sostituito dal valore nel risultato. Se l'attributo manca, non verrà effettuata alcuna sostituzione. E se per esempio nel modello si trova %PASS%, e il valore di PASS non è indicato nella richiesta, non verrà effettuata alcuna sostituzione. Queste variabili possono essere presenti anche nell’oggetto e saranno sostituite al momento d’inviare l’email

Esempio

Ci sono due casi distinti per gestire gli attributi di contatto:

Caso 1: attraverso un valore fisso salvato nel database di Sendinblue come ad esempio il cognome e il nome
Caso 2: con una variabile dinamica come ad esempio l'importo di un ordine o un numero di fattura che sarà generata al momento di una transazione e trasmessa tramite API.

Se l'attributo è fisso ed esiste nel database Sendinblue e vuoi personalizzare i tuoi modelli con questa tipologia di attributo di contatto, il nome dell'attributo dovrà essere messo tra {} .

Es.: Ciao {FIRSTNAME}

Troverai maggiori informazioni nel tutorial seguente. Puoi anche fare di più utilizzando delle condizioni.

Se, invece, l'attributo è un valore dinamico e passa tramite API, il nome dell'attributo dovrà essere messo tra %%.

Es.: Importo dell'ordine: %ORDER_AMOUNT%

In uno stesso modello, puoi usare i due tipi di attributi indifferentemente per ottenere un esempio di personalizzazione del tipo:

Se il modello è Ciao %FNAME% %LNAME%, questa email è inviata attraverso Sendinblue SMTP per testare il modello che hai creato. Saluti,. La vera email che apparirà nella tua casella di posta (latuaemail@email.com) avrà il seguente aspetto: Ciao John Smith, questa email è inviata attraverso Sendinblue SMTP per testare il modello che hai creato. Saluti,.

🤔 Domande?

In caso di domande, non esitare a contattare il team dell’assistenza creando un ticket dal tuo account. Se ancora non hai un account, puoi contattarcihere.