Creazione di modelli e-mail / SMS

È possibile creare un numero arbitrario di modelli che possono essere utilizzati per e-mail di conferma della registrazione, SMS con risultati di arrivo dei partecipanti o per l'invio di e-mail in blocco con informazioni importanti sull'evento.

Quando crei un nuovo modello scegli prima il Tipo:

Modelli Email

Selezionare il campo Destinatario (impostazione predefinita: e-mail) che contiene gli indirizzi e-mail che dovrebbero ricevere le e-mail. È inoltre necessario fornire un'e-mail del mittente che è l'e-mail visualizzata al destinatario. Facoltativamente è possibile impostare il nome del mittente, gli indirizzi e-mail cc/bcc e un indirizzo e-mail di risposta. L'oggetto e il contenuto dell'e-mail possono utilizzare campi e espressioni per il contenuto dinamico: è necessario assicurarsi di racchiudere tutti i campi o le espressioni tra parentesi quadre. Il contenuto può essere scritto come testo semplice o in HTML completo. Se utilizzi un editor esterno per i layout delle tue e-mail, tieni presente che alcuni di questi includono codice per impedire semplicemente di copiare e incollare il contenuto su una piattaforma di terze parti. È inoltre possibile allegare certificati o file all'e-mail.

I modelli di posta elettronica sono multilingue e quindi un singolo modello può contenere contenuti per più lingue. Quando si invia un modello di email tramite RACE RESULT 12, il valore del campo Lingua predefinito verrà utilizzato per determinare quale lingua deve ricevere il partecipante. Se questo campo è vuoto o non esiste un modello per quella lingua per un partecipante, verrà ripristinata la lingua corrente utilizzata nel software.

Importante: puoi inviare solo un massimo di 10 email attraverso il server SMTP di RACE RESULT, escluse le email di conferma automatica della registrazione. Ciò consente di testare la funzionalità e-mail, ma non di inviare e-mail in blocco.

Se vuoi inviare più di 10 messaggi, dovrai inserire i dettagli del tuo server SMTP in basso a sinistra. Tieni presente che molte piattaforme di posta elettronica standard impongono limiti rigorosi alle connessioni SMTP e potrebbero non funzionare in modo affidabile se non del tutto.

SMS

Selezionare il campo Destinatario (predefinito: Cellulare) che contiene i numeri di telefono che dovrebbero ricevere il messaggio e il nome del mittente (max. 11 caratteri). Il contenuto del messaggio può essere definito solo come testo normale, tieni presente che la lunghezza massima del messaggio è di 160 caratteri e tutto il resto verrà tagliato.
Per gli SMS che includono Emoji o altri caratteri speciali Unicode, la lunghezza è limitata a 70 caratteri.

Importante: l'invio di SMS non è gratuito! Dovrai accedere con il tuo account e RACE RESULT ti addebiterà un credito partecipante per SMS.

Chiamata Web Service

La chiamata WebService richiede un metodo (GET / POST) e un URL che sarà costruito da una espressione.
La funzione urlencode () può essere utile per questo. Esempio:

"https://my.server.com/webservice/message.php?bib=" & [bib] & "&name=" & urlencode([FirstName] & " " & [LastName])

Inoltre, puoi definire headers HTTP e salvare il risultato in un campo di testo aggiuntivo.

Ulteriori opzioni

A volte potresti voler definire indirizzi di destinatari alternativi per e-mail/SMS, per impostazione predefinita il campo Destinatario sarà impostato sui campi standard E-mail o Cellulare ma puoi scegliere tra uno qualsiasi dei campi aggiuntivi di tipo Campo testo. Se desideri inviare lo stesso modello di posta elettronica o SMS a più destinatari, puoi creare un elenco di valori separati da punto e virgola nel campo che verrà utilizzato come campo destinatario per il modello pertinente.

Un filtro predefinito è utile se desideri assicurarti che il modello venga inviato solo a determinati partecipanti. Successivamente, quando invierai i messaggi, è ancora possibile inserire/modificare il filtro, ma è possibile che ti dimentichi di immetterlo. Quindi, ad esempio, per assicurarti che il modello venga inviato solo ai partecipanti alla gara 2, inserisci il filtro:

[Gara]=2

Un'altra impostazione importante è impostare una casella di controllo per tenere traccia dei partecipanti a cui è stato inviato il modello.

È possibile chiaramente combinare il filtro con la casella di controllo così da essere certi di non inviare il modello più di una volta.

[Gara]=2 AND [NomeCasellaDiControllo]=0

Allegati

Quando si invia un allegato è importante definirne, nel nome, l'estensione. Per sempio, se vuoi mandare un attestato in formato pdf, dovrai inserire nel nome allegato anche l'estensione ".pdf". Nota che il nome dell'attestato può essere rinominato come meglio si crede.

Attestato.pdf

Quando si inviano e-mail di gruppo, è possibile definire il filtro da applicare al primo (tramite GroupRegPos), all'ultimo (tramite GroupRegPos), a tutti o a qualsiasi (1) partecipante del gruppo.

Email SMTP setup

Quando invii email da RACE RESULT 12 puoi utilizzare i nostri server per inviare un massimo di 10 email (escluse le email di conferma automatica della registrazione), oppure puoi connettere il tuo server SMTP per inviare un numero molto maggiore.

Dovrai trovare le impostazioni per il tuo server di posta SMTP, queste sono normalmente disponibili presso il tuo provider di hosting, normalmente il nome utente sarà il tuo indirizzo email con la password corrispondente.

Quando si configura il server SMTP per la prima volta è consigliabile testarlo inviando una e-mail a se stessi, questo può essere fatto in un evento di prova aggiungendosi come partecipante.

Di seguito sono riportate alcune impostazioni comuni del server SMTP. Tieni presente che queste impostazioni cambiano e potrebbero essere accurate solo fino alla data in cui sono state scritte, il 17/03/2020.

Office 365 SMTP Settings

  • Server address: smtp.office365.com
  • Port: 587
  • Encryption: TLS

Outlook SMTP Settings

  • Server address: smtp-mail.outlook.com
  • Port: 587
  • Encryption: TLS

GoDaddy SMTP Settings Americas

  • Server address: smtpout.secureserver.net
  • Port: 465 or 587
  • Encryption: SSL

 

Errori SMTP Email

Context Deadline Exceeded

Il server SMTP per l’invio delle email non è raggiungibile. Questo potrebbe essere dovuto a un’interruzione temporanea del server o a un limite nel tasso di invio previsto dal server SMTP.

Connection Refused

Questo errore si verifica quando il server SMTP a cui si sta tentando di connettersi rifiuta la connessione. Alcuni aspetti da considerare in caso di questo errore:

  • Quali sono i limiti del tuo provider email? La maggior parte dei provider impone un limite al numero di email che possono essere inviate in un certo intervallo di tempo.

  • La tua casella email ha esaurito lo spazio? Se la casella di posta è quasi piena, potresti riscontrare problemi nell’invio di più email.

Incorrect authentication data

  • Questo errore si verifica quando le impostazioni SMTP non sono corrette per l’indirizzo email utilizzato.

Notifiche di errore e-mail Automatiche

Se si verifica un errore durante l’invio dell’email nella registrazione online, verrà inviata un’email di errore all’indirizzo email del cliente.

Questa conterrà l’ID dell’evento e l’orario, oltre al contesto (trigger) e alla descrizione dell’errore.
 

Esempio:


Caro Joe,

si è verificato un errore nell’evento 123456:

Timestamp: 2024-01-01T12:45:09+02:00

Contesto:
Azioni AfterSave della registrazione “Single-Registration”, ID 123

Errore:
errore nell’invio dell’email nelle azioni AfterSave: nessun indirizzo email fornito.

Ti chiediamo gentilmente di controllare e, se possibile, correggere il problema.

Non esitare a contattarci se hai domande in merito a questo problema.

Cordiali saluti,
Il team di RACE RESULT


Errori comuni:

Errore: errore nell’invio dell’email nelle azioni AfterSave: nessun mittente fornito

Spiegazione: Nel modello email usato per l’invio dopo la registrazione non è stato indicato alcun mittente.


Errore: errore nell’invio dell’email nelle azioni AfterSave: nessun oggetto fornito

Spiegazione: Nel modello email usato per l’invio dopo la registrazione non è stato indicato alcun oggetto.


Errore: errore nell’invio dell’email nelle azioni AfterSave: nessun indirizzo email fornito

Spiegazione: Il campo per l’indirizzo email del partecipante non è richiesto o salvato nel modulo di registrazione.


Errore: errore nell’invio dell’email nelle azioni AfterSave: errore nell’invio email: gomail: impossibile inviare l’email 1: 450 4.1.2 <sample@wrongurl.com>: Indirizzo destinatario rifiutato: Dominio non trovato

Spiegazione: L’email non è stata inviata perché l’indirizzo del partecipante non è raggiungibile. Spesso si tratta di un errore di battitura.


Errore: errore nell’invio dell’email: gomail: impossibile inviare l’email 1: 450 Azione richiesta non eseguita: casella di posta non disponibile

Limite di invio email superato.

Spiegazione: È stato raggiunto il limite di invio del server di posta utilizzato, poiché molti provider impongono limiti per proteggere contro lo spam.


Errore: errore nell’invio dell’email nelle azioni AfterSave: errore nell’invio email: gomail: impossibile inviare l’email 1: 450 4.7.1 <sample@participant.com>... sample@organizer.com ha superato 5000 messaggi in un giorno

Spiegazione: È stato raggiunto il limite di invio del server di posta. In questo caso, il messaggio specifica che è stato raggiunto il limite giornaliero di 5000 email.


Errore: errore nell’invio dell’email nelle azioni AfterSave: Post "https://messy.raceresult.com/emails/send?sync=true": tempo massimo superato (Client.Timeout exceeded while awaiting headers)

Spiegazione: Il server email destinatario non ha risposto entro il tempo previsto. Il motivo esatto può essere verificato dal lato del destinatario.


Nota:
L’ID indicato nel contesto è l’ID del partecipante la cui registrazione ha generato l’errore. Puoi individuare rapidamente il partecipante inserendo nella barra di ricerca: [ID]=123.

Scrivere un JSON nel corpo POST di una Web Service Call

I modelli di email possono essere utilizzati per inviare richieste a un altro URL tramite una chiamata Web Service; spesso ciò richiede l'invio di campi dati in formato JSON, per cui sono necessarie alcune considerazioni particolari.

Prima di tutto, crea un nuovo modello di email/SMS e imposta il tipo di opzione di consegna su "Web Service Call".

Dovrai assicurarti di impostare il Metodo su POST, in cui i dati vengono inviati nel corpo della richiesta POST; l'URL è la destinazione della chiamata al Web Service. Nota che questo URL non può contenere campi poiché è testo semplice, quindi non supporta variabili nell'URL.

Il corpo della richiesta POST contiene i dati da inviare, che puoi inserire senza virgolette aggiuntive; qualsiasi testo racchiuso tra parentesi quadre sarà trattato come un campo o una funzione di RACE RESULT per inserire i dati.

{"name": "[Nome]", "age": [Età]}

Se il tuo endpoint richiede intestazioni aggiuntive, come una chiave API per l'autenticazione, puoi inserirle indicando il nome e il valore dell'intestazione. Potrebbe essere necessario includere altri elementi richiesti specifici del servizio JSON che stai utilizzando; anche questi elementi devono essere inclusi nell'intestazione.