Configurer les notifications par e-mail via des mailto-hooks : paramètres, templates et versions.
En plus des webhooks, la PSB offre la possibilité d'envoyer des notifications par e-mail. Un e-mail hook (aussi appelé mailhook ou mailto-hook) envoie un e-mail lors de chaque événement sur un topic choisi. Pratique pour les organisations qui ne disposent pas de leur propre endpoint webhook, ou en complément de webhooks existants.
Enregistrez un hook via l'API avec une action mailto: :
{
"action": "mailto:finance@jouw-bedrijf.nl",
"topics": ["InvoiceReceived"]
}
À chaque facture reçue, la PSB envoie désormais un e-mail de notification à l'adresse spécifiée. L'adresse e-mail dans l'action peut également contenir un placeholder : [senderEmailAddress] ou [receiverEmailAddress] pour envoyer dynamiquement à l'adresse e-mail de l'expéditeur ou du destinataire.
Attention : Lors de l'utilisation de placeholders, spécifiez toujours le paramètre
fallbackEmail. Si l'adresse e-mail n'est pas disponible dans le document, la PSB envoie la notification à l'adresse de secours.
Les e-mail hooks supportent une configuration étendue via des paramètres de requête dans l'URL de l'action. Vous construisez l'URL comme suit : mailto:adres@domein.nl?param1=waarde¶m2=waarde.
includeAttachmenttrue / falsetargetDocumentTypeIdfilename{{id}}{{extension}}. Encodez cette valeur en URLexcludePrimaryAttachmenttrue / falseexcludeAdditionalAttachmentstrue / falseversion0.9 ou 1.0templateIdfallbackEmailreplyTobccfromLa PSB prend en charge deux versions du template d'e-mail :
0.9noreply@everbinding.nl1.0noreply@econnect.emailConseil : Utilisez toujours la version
1.0pour les nouvelles configurations. La version0.9envoie depuis l'ancien domaine eVerbinding, qui n'est plus activement maintenu.
Un e-mail hook qui envoie un e-mail à chaque facture reçue avec la facture en pièce jointe PDF, sans le XML :
mailto:finance@jouw-bedrijf.nl?includeAttachment=true&excludePrimaryAttachment=true&version=1.0
Un hook qui envoie dynamiquement à l'expéditeur, avec un fallback :
mailto:[senderEmailAddress]?includeAttachment=true&version=1.0&fallbackEmail=backup@jouw-bedrijf.nl
Vous souhaitez un contrôle total sur la mise en page de l'e-mail ? Faites configurer un template SendGrid personnalisé par eConnect et utilisez le paramètre templateId. Vous pouvez également connecter votre propre compte SendGrid en ajoutant un objet init avec votre clé API à la configuration du hook.
Vous pouvez spécifier plusieurs adresses e-mail en créant des hooks séparés, ou en utilisant le paramètre bcc pour des destinataires supplémentaires.
Des placeholders tels que [senderEmailAddress] ou [receiverEmailAddress] ne sont renseignés que si l'adresse figure dans le document. Si elle manque, la PSB envoie la notification à l'adresse indiquée dans fallbackEmail, afin que vous ne perdiez pas le message.
La version 0.9 utilise l'ancien domaine d'expéditeur noreply@everbinding.nl ; la version 1.0 utilise noreply@econnect.email avec une mise en page moderne. Pour les nouvelles configurations, 1.0 est le choix recommandé.
Définissez includeAttachment sur true et excludePrimaryAttachment sur true, par exemple pour n'envoyer qu'une pièce jointe PDF. Combinez avec version=1.0 dans la chaîne de requête pour le template souhaité.
Consultez la spécification API complète sur psb.econnect.eu pour toutes les configurations et exemples possibles.
Ouvrir la référence API