שליחת הודעה תפעולית לנמען יחיד (למשל חשבונית או קוד אימות).
תיעוד:
http://webapi.mymarketing.co.il/api/docs/User/Api/POST-api-OperationalMessage-Message
אפשר לשלוח הודעה תפעולית ליותר מנמען אחד בבת אחת.
הדוגמה כאן מפושטת, ולכן יש בה רק נמען אחד.
סטטוסים: אפשר לשלוח הודעות תפעוליות לנמענים בכל הסטטוסים, חוץ מנמענים בסטטוס "שגוי" (bounced). אותה לוגיקה תפעולית חלה על מייל, SMS ו-WhatsApp.
השליטה בקישור ההסרה והאפשרות לשלוח לנמענים לא פעילים הן הגדרות נפרדות בממשק, כך שאפשר לנהל כל אחת מהן בנפרד.
קישור הנגישות: מיילים תפעוליים ומיילים שנשלחים דרך ה-API לא כוללים את קישור הנגישות, כי הוא לא נתמך בתהליכי השליחה האלה ועלול להוביל את הנמענים לדף שגיאה. קמפייני מייל רגילים כוללים את קישור הנגישות.
הסבר על הפרמטרים:
-
Profile id: מוסבר במאמר על פרופילי שליחה, עם הסברים ותמונות על איך למצוא אותו.
-
Name: שם ההודעה באקטיב טרייל.
-
Template id: היכנסו לקמפיינים ← התבניות שלי ← פתחו את התבנית הרצויה וחפשו בכתובת הדף "ID=NUMBER".
-
Content (לא מופיע בדוגמה הזו): התוכן של ההודעה התפעולית, שיכול לכלול HTML. הקפידו להוסיף לוכסן הפוך (\) לפני כל מירכאה בקוד, כדי למנוע שגיאות.
שימו לב: אם מוסיפים תוכן, אין צורך בתבנית, ולהפך.
שימו לב (2): אם לא מוסיפים נושא, שורת הנושא נלקחת מקמפיינים ← התבניות שלי ← פתחו את התבנית ← לחצו על הגדרות ← גללו למטה.
שימו לב (3): אם מוסיפים נושא ב-JSON, הוא דורס את הנושא מהתבנית.
שימו לב (4): תבניות תומכות בכותרת משנה (preheader) למיילים תפעוליים, כך שאפשר להגדיר את טקסט התצוגה המקדימה שמופיע בתיבת הדואר של הנמען, בדיוק כמו במיילים שיווקיים.
-
Classification: בדו"ח ההודעות התפעוליות אפשר לסנן לפי סיווג. אם יש יותר מסוג אחד של הודעות תפעוליות (למשל קוד אימות וחשבונית), מומלץ להבדיל ביניהן בשם אחר בפרמטר הזה.
-
User profile fromname: שם השולח. לא חובה לכלול אותו. אם לא כוללים אותו, שם השולח נלקח ממאת שם בפרופיל השליחה באקטיב טרייל. אם כוללים אותו, הוא דורס את השם מהפרופיל.
-
Bcc: שולח עותק לכתובת מייל נוספת. הנמען המקורי לא יראה את הכתובת שב-Bcc. אם מופיעה שם גם כתובת המייל של הנמען עצמו, המייל לא יישלח פעמיים. לא חובה.
-
Language_type: קידוד. כדי למנוע ג'יבריש (שקורה הרבה בעברית), צריך להגדיר קידוד. תמיד עדיף להשתמש ב-UTF-8.
-
Pairs (key, value): מוסבר במאמר נפרד.
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"
]
}
}