Configurare le notifiche e-mail tramite mailto hook: parametri, template e versioni.
Oltre ai webhook, la PSB offre la possibilità di inviare notifiche via e-mail. Un e-mail hook (detto anche mailhook o mailto hook) invia un'e-mail ad ogni evento su un topic scelto. Comodo per organizzazioni che non dispongono di un proprio endpoint webhook, o come integrazione ai webhook esistenti.
Registrare un hook tramite l'API con un'action mailto::
{
"action": "mailto:finance@jouw-bedrijf.nl",
"topics": ["InvoiceReceived"]
}
Ad ogni fattura ricevuta, la PSB invierà un'e-mail di notifica all'indirizzo indicato. L'indirizzo e-mail nell'action può contenere anche un placeholder: [senderEmailAddress] o [receiverEmailAddress] per inviare dinamicamente all'indirizzo e-mail del mittente o del destinatario.
Attenzione: Con i placeholder utilizzare sempre il parametro
fallbackEmail. Se l'indirizzo e-mail non è disponibile nel documento, la PSB invierà la notifica all'indirizzo di fallback.
Gli e-mail hook supportano una configurazione estesa tramite parametri query nell'URL dell'action. L'URL si costruisce come mailto:indirizzo@dominio.nl?param1=valore¶m2=valore.
includeAttachmenttrue / falsetargetDocumentTypeIdfilename{{id}}{{extension}}. Effettuare l'URL encoding di questo valoreexcludePrimaryAttachmenttrue / falseexcludeAdditionalAttachmentstrue / falseversion0.9 o 1.0templateIdfallbackEmailreplyTobccfromLa PSB supporta due versioni del template e-mail:
0.9noreply@everbinding.nl1.0noreply@econnect.emailSuggerimento: Utilizzare sempre la versione
1.0per le nuove configurazioni. La versione0.9invia dal vecchio dominio eVerbinding, che non viene più attivamente mantenuto.
Un e-mail hook che ad ogni fattura ricevuta invia un'e-mail con la fattura come allegato PDF, senza l'XML:
mailto:finance@jouw-bedrijf.nl?includeAttachment=true&excludePrimaryAttachment=true&version=1.0
Un hook che invia dinamicamente al mittente, con un fallback:
mailto:[senderEmailAddress]?includeAttachment=true&version=1.0&fallbackEmail=backup@jouw-bedrijf.nl
Desidera il pieno controllo sul layout dell'e-mail? Faccia configurare da eConnect un template SendGrid personalizzato e utilizzi il parametro templateId. È possibile collegare anche un account SendGrid proprio aggiungendo un oggetto init con la propria API key alla configurazione dell'hook.
È possibile specificare più indirizzi e-mail creando hook separati, oppure utilizzando il parametro bcc per destinatari aggiuntivi.
I placeholder come [senderEmailAddress] o [receiverEmailAddress] vengono compilati solo se l'indirizzo è presente nel documento. Se manca, la PSB invia la notifica all'indirizzo in fallbackEmail, così non perde il messaggio.
La versione 0.9 usa il dominio mittente più datato noreply@everbinding.nl; la versione 1.0 usa noreply@econnect.email con layout moderno. Per le nuove configurazioni si consiglia 1.0.
Imposti includeAttachment su true e excludePrimaryAttachment su true, ad esempio per inviare solo un allegato PDF. Combini con version=1.0 nella query string per il template desiderato.
Consultare la specifica API completa su psb.econnect.eu per tutte le configurazioni ed esempi possibili.
Apri il riferimento API