הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
רלוונטי ל: תובנות לקוח של Dynamics 365
הערה
- הכלים והדוגמאות בתיעוד זה ממחישים את היכולות הנוכחיות. שמות הכלים, תיאורים, פרמטרים, פורמטי תגובה והפונקציונליות הזמינה יכולים להשתנות עם הזמן.
- כשאתה בונה סוכנים, אינטגרציות או לוגיקת אורקסטרציה, אל תקודד תלות קשיחת על שמות כלים מסוימים, מבני פרמטרים, מטא-דאטה של כלי או סכימות תגובה. במקום זאת, עצב את הפתרון שלך כך שיגלה וישתמש בכלים זמינים בזמן הריצה.
- ככל שהפלטפורמה מתפתחת, Microsoft עשויה להוסיף, להסיר, לשנות שם או לשנות כלים ומטא-דאטה של כלים. עיצוב לפי יכולות ולא לפי מזהי כלים ספציפיים מסייע לשמור על תאימות בין עדכוני השירות.
השתמש ביכולת זו כדי לטוס מראש מייל שיווקי בזמן אמת קיים לפני פרסום או שליחתו.
מה הוא עושה
היכולת שולחת את בקשת אימות ערוץ האימייל לאותו msdynmkt_ValidateEmail API מותאם אישית שבו משתמש עורך הדוא"ל של תובנות הלקוחות. הוא בודק את תוכן האימייל, מחזיקי התאמה אישית, תוכן מותנה, הקשר תאימות ומשטחי אימות נוספים הנתמכים בגרסת ערוץ האימייל המותקנת. הוא מחזיר את ממצאי האימות מבלי לשנות את המייל.
נסה הנחיות כמו
- אמתו את המייל השיווקי בזמן אמת הזה לפני שאני מפרסם אותו.
- פרפלייט את המייל הזה והראה לי את התוכן שלו ושגיאות אימות זמניות.
- בדוק אם המייל הזה של Customer Insights מוכן לשליחה.
ספק את בקשת האימות הסדרתית של ערוץ האימייל. הבקשה חייבת לזהות את האימייל הקיים דרכה messageId ולכלול את התוכן וההקשר לאימות שלה.
מה שתראו בצ'אט
העוזר מאשר שהאימות הושלם ומחזיר את ההודעה המנותקת ואת ממצאי ההחלפה בתוכן מובנה. כל ממצא יכול לכלול את מרחב השם, הקוד, החומרה והמסר. העוזר לא מעתיק את תוכן האימייל או כתובות הנמען לקריינות שלו.
טיפים שימושיים
- השתמשו בצורת בקשת האימות שנוצרה על ידי עורך הדוא"ל של Customer Insights או על ידי אינטגרציית ערוץ האימייל.
- כלול את תוכן האימייל הנוכחי והגדרות זמניות; האימות מכסה רק את מה שהבקשה מספקת.
- פתור ממצאי חומרת שגיאות לפני פרסום או שליחה. בדוק אזהרות וממצאים אינפורמטיביים בהקשר.
מה קורה הלאה?
לאחר בדיקת התוצאה, תקן את המייל ב-Customer Insights ואמת אותו שוב. בדוק את הסכמת הנמען בנפרד לפני השליחה.
האם זה משנה את הנתונים?
לא. היכולת מאמתת את המצב שסופק ולא מעדכנת את המייל.
דרישות מוקדמות
- פתרון ערוץ הדואר האלקטרוני וה-API
msdynmkt_ValidateEmailהמותאם אישית חייבים להיות מותקנים בסביבה שנבחרה. - הבקשה חייבת להכיל את ה-GUID של רשומה קיימת
msdynmkt_email. - המתקשר חייב להיות בעל גישה לקריאה לכתובת האימייל הזו. Dataverse וה-API המותאם אישית אוכפים גישה ברמת הרשומות.
סיכום הכלים
| מאפיין | ערך: |
|---|---|
| שם המשתמש | אימות דוא"ל |
| שם הכלי הפנימי | validate_email |
| מטרה | מאמת אימייל שיווקי בזמן אמת קיים לפני פרסום או שליחה |
התנהגות כלי
הכלי מאמת את מעטפת הבקשה, מאשר שמדובר messageId ב-GUID, וקורא ל-Mail Channel Channel Schedule API מותאם אישית (API). הוא מחזיר את תוצאת האימות המנותחת של ה-API המותאם אישית מבלי לפרש, לדכא או ליצור ממצאים.
ביאורים
| ביאור | ערך: | משמעות |
|---|---|---|
readOnlyHint |
true |
הכלי לא משנה את המייל. |
destructiveHint |
לא הוגדר | לא רלוונטי לכלי לקריאה בלבד. |
idempotentHint |
לא הוגדר | לא רלוונטי לכלי לקריאה בלבד. |
openWorldHint |
לא הוגדר | משתמש בברירת המחדל כי הוא קורא ל-API מותאם אישית של Dataverse. |
מושגי קלט
| קלט | תיאור | חובה |
|---|---|---|
validateRequest |
בקשת אימות ערוץ דואר אלקטרוני סיריאלי עם JSON הכוללת messageId, חלקי תוכן הודעה, חלקי מקום, והקשר אימות. מקסימום 1,048,576 בתים UTF-8. |
כן |
תגובה והתנהגות ממשק משתמש
כלי זה מחזיר תגובת טקסט עם נתוני אימות מובנים. הוא לא מגובה ברכיב אפליקציה בצ'אט.
סוג תגובה
תוצאת אימות בדוא"ל המכילה הודעות וקבוצות תוצאות זמניות.
הערות ניתוב
השתמש validate_email כאשר המשתמש רוצה ממצאי אימות לדוא"ל שיווקי קיים של Customer Insights (תובנות לקוחות). אל תשתמש בו כדי לבדוק את הסכמת הנמען, ליצור קישור לביטול הרשמה, לכתוב תוכן, לשלוח מייל או ליצור מסע.
כלים קשורים
| כלי | מערכת יחסים |
|---|---|
check_consent |
בודק האם הנמען יכול לקבל הודעת שיווק |
get_unsubscribe_link |
יוצר קישור ביטול הרשמה תואם |
create_journey |
יוצר מסע לאחר שהמסע שלו JSON אושר |
סיווג מוטציות נתונים
לקריאה בלבד. הכלי מאמת את מצב המייל שסופק ואינו מעדכן את המייל או רשומה אחרת של Dataverse.