Shortcode nelle notifiche

Disclaimer: questo articolo descrive come utilizzare il nuovo servizio di notifica, che verrà rilasciato pubblicamente a tutti i clienti all'inizio del 2025. Per informazioni sul programma di rilascio, consultare il post della community sul piano di rilascio graduale del nuovo servizio di notifica.
→ Nel caso in cui si notino differenze tra quanto descritto in questo articolo e la propria piattaforma, consultare l'articolo sulla versione legacy dell'applicazione di notifica.
Scopri di più sul ciclo di rilascio.

Introduzione

Gli shortcode sono tag come {{course_name}} o {{first_name}} che si possono includere nel testo di una notifica. Questi tag vengono sostituiti con i dati pertinenti quando viene inviato un messaggio di notifica.

Questo articolo fornisce ulteriori informazioni sull'uso degli shortcode nelle notifiche. Per istruzioni complete su come configurare una notifica, consultare l'articolo principale: Configurare le notifiche.

Gli shortcode possono essere inseriti quando si compone il testo del messaggio di una notifica. Gli shortcode disponibili dipendono dal tipo di evento di notifica, e l’articolo Eventi e condizioni delle notifiche elenca gli shortcode disponibili per ciascun tipo di evento.

Suggerimento: con il passaggio al nuovo servizio di notifica, l'URL di base dei link nelle notifiche corrisponderà sempre al dominio di ciascun destinatario della notifica. Per ulteriori informazioni, consultare il capitolo Link shortcode e domini dell'impresa estesa.

Shortcode e link cliccabili

Gli shortcode che fanno riferimento ai link, come ad esempio {{course_link}}, non creano link cliccabili nelle notifiche. Inseriscono solo l'URL in formato testo senza tag HTML.

La maggior parte dei client di posta elettronica moderni (desktop, mobile o web) converte automaticamente gli URL in testo semplice in link cliccabili per migliorare l'esperienza utente. Il destinatario riceverà comunque un link cliccabile, anche se è stato inserito solo l'URL.

Tuttavia, per avere la certezza di creare un link attivo, è necessario inserire l’URL nei tag html necessari. È possibile farlo in due modi:

• Utilizzare il pulsante Inserisci/modifica link della barra degli strumenti e incollare lo shortcode (ad esempio, {{course_link}}) nel campo URL.
• Utilizzare il pulsante Codice sorgente nella barra degli strumenti e inserire direttamente il tag HTML, utilizzando lo shortcode come attributo href. Ad esempio, <a href="{{course_link}}">Il mio corso</a>.

→ Nota per le piattaforme delle imprese estese: consultare il capitolo Link shortcode e domini dell'impresa estesa per scoprire come il dominio nell'URL dello shortcode (https:/www.domain.xxx/path_url_platform ) viene abbinato al dominio dell'utente destinatario.

Link shortcode ai corsi o sessioni

Quando si utilizzano shortcode relativi a link a corsi o sessioni specifiche, ricordarsi che non funzionano come i deep link. L’utente riceverà un errore se clicca sul link senza essere iscritto al corso.

Quando si include lo shortcode {{course_link}} in una notifica, gli utenti che cliccano il link atterreranno in pagine diverse in base al loro livello utente e allo stato di autenticazione in piattaforma:

• Se l'utente che clicca sul link è un Superadmin o un Power User (con tutti i permessi sul corso):
  - Se ha effettuato l'accesso alla piattaforma, verrà indirizzato alla pagina di gestione del corso.
  - Se NON è stato effettuato l'accesso, l'utente si troverà nella pagina del corso con la visualizzazione dello studente.
• Con il livello Utente, verrà sempre indirizzato alla pagina del corso in visualizzazione studente, indipendentemente dal fatto che abbia effettuato l'accesso o meno.

Shortcode con date e orari

Shortcode {{expire_at}}

• Quando si include lo shortcode {{expire_at}} in una notifica, l'ora visualizzata nelle notifiche ricevute dagli utenti viene espressa nel loro fuso orario.

Shortcode {{event_date}} e {{session_dates}}

I corsi ILT e VILT sono organizzati in sessioni e ogni sessione può essere composta da uno o più eventi. Quando uno studente si iscrive a una sessione del corso, viene automaticamente iscritto a tutti gli eventi di quella sessione.

{{event_date}}:

Questo shortcode contiene:

• Il nome dell'evento nella parte superiore
• La data e l'ora di inizio e fine dell'evento. Queste informazioni sono fornite sia nel fuso orario dello studente che in quello dell'evento, se diversi.
  → Il formato della data e dell'ora dipendono dalle impostazioni della piattaforma.
• I dettagli sulla sede e l'aula dell'evento, se si tratta di un evento in presenza. Oppure virtuale, se si tratta di un webinar.

{{session_dates}}:

Questo shortcode contiene le informazioni {{event_date}} relative a tutti gli eventi della sessione. Sono incluse tutte le informazioni relative alle date degli eventi, anche se alcuni o tutti gli eventi sono già avvenuti.

Esempio (per una sessione con tre eventi):

Shortcode con credenziali di accesso

Alcune notifiche, come Utente creato, possono includere un shortcode {{user_password}}. Un caso d'uso tipico è quello di comunicare agli utenti le istruzioni di accesso, ossia il link alla piattaforma e le credenziali da utilizzare (nome utente e password).

Nella notifica, lo shortcode {{user_password}} è sempre sostituito da un link « Esegui il reset della password ». Cliccando su questo link, all'utente viene richiesto di inserire il proprio indirizzo email, in modo da ricevere un altro link di reset per creare finalmente la propria password.

Questo flusso di lavoro in due fasi consente all'amministratore di creare gli utenti (con o senza password iniziale, a seconda del meccanismo utilizzato per crearli) e poi, tramite la notifica, di fargli creare o modificare le proprie password.

Tag {{#items}} e {{/items}}

Si tratta di tag speciali impiegati esclusivamente nelle notifiche riepilogative, al fine di enumerare elenchi di elementi. Tali tag devono sempre essere utilizzati in coppia, racchiudendo i codici brevi degli elementi che si desidera elencare.

Per ulteriori dettagli, si rimanda all'articolo relativo alle Notifiche riepilogative.

Nota: I tag {{#items}} e {{/itemssono impiegati in tutte le notifiche riepilogative. Inoltre, la notifica Riassunto: nuovi contenuti nei canali seguiti utilizza anche i tag {{#channels}} e {{/channels}}.

Link shortcode e domini dell’impresa estesa

Per le piattaforme delle imprese estese, quando si utilizzano shortcode come {{course_link}} in una notifica, l’URL di base del link deve corrispondere al dominio del destinatario.

→ Ad esempio, un utente che accede alla piattaforma all'indirizzo https:/<branch1_domain> deve ricevere un link al corso con lo stesso URL di base https:/<branch1_domain>/percorso_a_corso.

Tuttavia, se l'utente appartiene a più di un client dell'impresa estesa (possibile in piattaforme con rami annidati o in piattaforme che consentono di inserire gli utenti in più di un ramo), le notifiche potrebbero non utilizzare sempre l'URL di base previsto. Consultare il capitolo Link shortcode e rami annidati dell'impresa estesa.

Link shortcode e rami annidati dell'impresa estesa

Se si dispone di un dominio d'impresa estesa associato a un ramo padre e di un altro dominio associato a un ramo figlio, gli utenti del ramo figlio possono ricevere notifiche che utilizzano l'URL di base del dominio padre. Tuttavia, saranno comunque in grado di accedere alla risorsa collegata.

Ad esempio, con la seguente configurazione:

Un utente del gruppo Sales si aspetterebbe di ricevere notifiche contenenti link che utilizzano l'URL di base del proprio dominio (academy70.docebosaas.com/paperoga)
Tuttavia, poiché tale utente appartiene implicitamente anche al ramo Marketing (genitore di Sales), potrebbe invece ricevere link che utilizzano l’altro URL di base (academy70.docebosaas.com/academy)

→ In questo scenario padre/figlio, non è garantito che i link shortcode abbiano l'URL di base previsto, anche se le risorse saranno comunque accessibili all'utente anche con l'URL « genitore »

Shortcode logo dinamico {{extend_enterprise_logo}}

Come indicato nel capitolo precedente sui link shortcode, quando una notifica include tali link, il sistema adatta dinamicamente l'URL di base in modo che corrispondano al dominio di ciascun utente destinatario.

In modo simile, si può utilizzare lo shortcode {{extend_enterprise_logo}} per recuperare dinamicamente l’immagine del logo configurata per la piattaforma del destinatario (sia piattaforma principale, sia client extended enterprise). In questo modo, ogni destinatario riceverà un’email con il logo corretto per la propria piattaforma. 

Suggerimento: le notifiche che includono template preconfigurati con un logo ora utilizzano automaticamente questo shortcode per fornire un’immagine del logo dinamica. Tuttavia, se si hanno alcune notifiche create con una versione precedente del template, queste potrebbero ancora includere un percorso fisso dell’immagine del logo. In tal caso, si può ricreare la notifica con il template attuale oppure modificare manualmente il corpo del messaggio per utilizzare lo shortcode {{extend_enterprise_logo}} .

Inserire un’immagine logo dinamica:

Per farlo, nel codice html del corpo del messaggio, inserire un tag immagine che contenga lo shortcode invece di un percorso fisso dell’immagine: 

<img src=”{{extend_enterprise_logo}}” ...>

Suggerimento: notare che lo shortcode da solo inserisce solo il percorso dell’immagine del logo in formato testo semplice e, da solo, non visualizzerà un’immagine. È necessario incorporare lo shortcode all’interno di un tag <img src  > perché funzioni. 

Rendere dinamica l'immagine del logo del modello:

Alcune notifiche forniscono modelli di messaggio preconfigurati che includono anche un'immagine di logo. Si noti che questi modelli, per impostazione predefinita, fanno riferimento a un percorso immagine fisso, come ad esempio:
<img src="/public/images/core/docebo_logo.png" ...>

In questo modo tutti i destinatari riceveranno messaggi con la stessa immagine di logo fissa.

Se invece si vuole che i destinatari vedano un logo corrispondente a quello della loro piattaforma nell'impresa estesa, modificare il corpo del messaggio in modalità sorgente per sostituire il percorso dell'immagine fissa con lo shortcode:

<img src={{extend_enterprise_logo}}” ...>