Envoyer un message opérationnel à un seul contact (par exemple une facture ou un code de vérification).
Documentation :
http://webapi.mymarketing.co.il/api/docs/User/Api/POST-api-OperationalMessage-Message
Vous pouvez envoyer un message opérationnel à plusieurs contacts à la fois.
L'exemple ci-dessous est simplifié et ne contient donc qu'un contact.
Statuts : les messages opérationnels peuvent être envoyés aux contacts de tous les statuts, sauf les non-livrés. La même logique opérationnelle s'applique à l'e-mail, au SMS et à WhatsApp.
Le réglage du lien de désinscription et l'option d'envoi aux contacts inactifs sont deux réglages distincts dans l'interface : chaque comportement se gère séparément.
Lien d'accessibilité : les e-mails opérationnels et les e-mails envoyés par l'API ne contiennent pas le lien d'accessibilité, car il n'est pas pris en charge dans ces flux d'envoi et pourrait mener les destinataires vers une page d'erreur. Les campagnes e-mail régulières contiennent le lien d'accessibilité.
Les paramètres :
-
Profile id : présenté dans l'article sur les profils d'envoi, avec des explications et des images qui montrent où le trouver.
-
Name : le nom du message dans ActiveTrail.
-
Template id : allez dans Campagnes → Mes gabarits, ouvrez le gabarit voulu et regardez « ID=NUMÉRO » dans l'URL de la page.
-
Content (absent de cet exemple) : le contenu du message opérationnel, qui peut contenir du HTML. Ajoutez une barre oblique inverse (\) avant chaque guillemet du code pour éviter les erreurs.
À noter : si vous ajoutez un contenu, le gabarit est inutile, et inversement.
À noter (2) : si vous n'indiquez pas d'objet, l'objet est repris de Campagnes → Mes gabarits → le gabarit → Paramètres, plus bas dans la page.
À noter (3) : un objet indiqué dans le JSON remplace l'objet du gabarit.
À noter (4) : les gabarits acceptent un préheader pour les e-mails opérationnels : le texte d'aperçu affiché dans la boîte de réception du destinataire se définit de la même façon que pour les e-mails marketing.
-
Classification : le rapport des messages opérationnels peut être filtré par classification. Si vous avez plusieurs types de messages opérationnels (par exemple un code de vérification et une facture), donnez-leur un nom différent dans ce paramètre.
-
User profile fromname : le nom de l'expéditeur. Facultatif. S'il est absent, le nom de l'expéditeur est repris du champ « Expéditeur » du profil d'envoi dans ActiveTrail. S'il est présent, il le remplace.
-
Bcc : envoie une copie à une autre adresse e-mail (Cci). Le contact destinataire ne voit pas l'adresse indiquée en Cci. Si l'adresse du contact lui-même y figure, l'e-mail n'est pas envoyé deux fois. Facultatif.
-
Language_type : l'encodage. Il est nécessaire pour éviter les caractères illisibles (fréquents en hébreu). Utilisez de préférence UTF-8.
-
Pairs (key, value) : expliqué dans un article distinct.
JSON :
{
"email_package": [
{
"email": "example@example.com",
"pairs": [
{
"key": "[Song Name]",
"value": "hello"
},
{
"key": "[Artistname]",
"value": "lionel richie"
}
]
}
],
"details": {
"name": "sample string 1",
"subject": "sample string 2",
"user_profile_id": 44168,
"classification": "sample string 3",
"user_profile_fromname": "sample string 4"
},
"design": {
"language_type": "UTF-8",
"body_part_format": 1,
"add_print_button": true,
"template_id": 109787,
"add_Statistics": true
},
"bcc": {
"bcc_emails": [
"example@example.com"
]
}
}