Connecter votre plateforme email
Indiquez à OmniLab le service qui délivre réellement vos messages, pour que les envois déclenchés partent de votre propre domaine.
Connectez le service depuis lequel vous envoyez déjà, pour que les messages déclenchés arrivent depuis votre domaine d'envoi et atterrissent dans votre reporting habituel. À faire une fois par organisation.
Avant de commencer
- Il vous faut un accès Admin pour atteindre les paramètres d'organisation où cela se configure.
- Décidez quelle plateforme envoie le message — Brevo, Mailchimp, Salesforce Marketing Cloud, ou un autre service doté d'une API.
- Obtenez auprès de cette plateforme une clé d'API autorisée à envoyer des messages transactionnels, et rien de plus.
- Prévoyez quelqu'un de technique. La connexion est une Function, donc du code.
Étapes
Obtenez la clé auprès de votre plateforme email
Créez dans votre plateforme une clé d'API limitée à l'envoi. Évitez de réutiliser une clé existante aux droits plus larges — celle-ci vivra dans OmniLab, et une clé étroite limite ce qu'une fuite permettrait.
Stockez-la comme secret
Basculez sur l'organisation globale, ouvrez les Paramètres généraux, et stockez la clé comme secret plutôt que de la coller dans du code. Les secrets sont en écriture seule : une Function peut les utiliser, personne ne peut les relire.
Écrivez la Function qui appelle votre plateforme
Votre développeur écrit une Function qui prend ce qu'OmniLab lui transmet et appelle l'API d'envoi de votre plateforme. Le point d'accroche dépend de ce que vous construisez — voir Emails transactionnels ou Double opt-in.
Envoyez-vous un test
Déclenchez l'action dans une campagne de test et vérifiez que le message arrive — avec le bon expéditeur, le bon modèle, et une trace dans le journal d'envoi de votre plateforme.
Vérifiez aussi les indésirables. Un message déclenché par une intégration neuve est exactement le genre à être filtré au premier envoi.
Si quelque chose bloque
- La Function s'exécute mais rien n'arrive. Une exécution réussie signifie que votre plateforme a accepté la demande, pas qu'elle a délivré le message. Consultez ensuite son propre journal de livraison.
- Les messages arrivent avec le mauvais expéditeur. L'expéditeur est défini dans votre plateforme ou dans le payload de la Function, pas dans OmniLab.
- Tout marche en test mais pas en production. Le secret est probablement limité à une organisation. Vérifiez que la même clé existe là où tourne la campagne en ligne.
Pour aller plus loin
À propos des déclencheurs email
Comprenez quels emails OmniLab envoie, lesquels partent de votre propre plateforme, et où passe la frontière.
Emails transactionnels
Envoyez des emails automatisés déclenchés par l'activité des participants OmniLab : confirmations, notifications de récompenses et rappels.