הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
באפשרותך להשתמש ב- msdyn_UpdateRecordWithRuleBasedPredictions API כדי לחזות שדות מקרה עם הקשר מהודעת הדואר האלקטרוני לאחר יצירת אירוע. ה- API מעדכן את השדות שתצורתם נקבעה במקרה של הערכים החזויים מהודעת הדואר האלקטרוני, ומאפשר לך להפוך עדכוני אירועים לאוטומטיים ולשפר את היעילות בטיפול במקרים.
דרישות מוקדמות
- שדות האירוע שה- API חייב לחזות ולעדכן מוגדרים בסביבה שלך. קבל מידע נוסף תחת קביעת תצורה של עדכוני אירוע אוטונומים.
- דרושות לך ההרשאות הדרושות כדי לקרוא ל- API זה.
פרטי בקשה
-
כתובת URL:
https://<orgurl>/api/data/v9.2/msdyn_UpdateRecordWithRuleBasedPredictions - שיטה: POST
- גירסה: 1.0
בקש פרמטרים
גוף הבקשה מכיל את הפרמטרים הבאים:
| פרמטר | סוג | נדרש | תיאור | תבנית |
|---|---|---|---|---|
| msdyn_Target | Entity | כן | ישות שיש לעדכן ומשמשת להתאמת כללי העדכון שתצורתם נקבעה. חייב להכיל את המזהה של רשומה קיימת. | json<br>{<br> "@odata.type": "Microsoft.Dynamics.CRM.incident",<br> "incidentid": "14ff4725-f1b0-ef11-ac2e-6045bd0a52c7"<br>}<br> |
| msdyn_Context | הפניית ישות | כן | ישות הדואר האלקטרוני המשמשת כדי לספק הקשר לחיזוי בינה מלאכותית. | <br>emails(fffe4725-f1b0-ef11-ac2e-6045bd0a52c7)<br> |
מאפייני תגובה
| מאפיין | סוג | תיאור | דוגמה |
|---|---|---|---|
| msdyn_UpdatedRecords | מערך מחרוזות | רשימה של שדות ישות עודכנו. | ['incident(GUID)', 'contact(GUID)', ...] |
המערך msdyn_UpdatedRecords ריק בתרחישים הבאים:
- שדות אירוע שיש לעדכן אינם מוגדרים.
- השדות שיש לעדכן עודכנו כבר באופן ידני.
- מודל החיזוי לא הצליח ליצור חיזוי.
טיפול בשגיאות
ה- API מעלה חריגים בתרחישים הבאים:
- למשתמש אין את ההרשאות הדרושות כדי לעדכן את הישות.
- מזהה הישות שצוין אינו קיים.
- שגיאות תצורה.
- חריגות משירותי חיזוי המשמשים כחזית.
דוגמה
הטבלה הבאה מתארת את תרחישי הבקשה והתגובה לדוגמה עבור ה- API.
| תיאור | בקשה | השב |
|---|---|---|
| יוצר חיזויי בינה מלאכותית עבור מזהה האירוע שצוין ומעדכן את הרשומה באמצעות מידע הקשרי מהודעת הדואר האלקטרוני הקשורה. | json { "msdyn_Target": { "@odata.type": "Microsoft.Dynamics.CRM.incident", "incidentid": "14ff4725-f1b0-ef11-ac2e-6045bd0a52c7" }, "msdyn_Context": "emails(fffe4725-f1b0-ef11-ac2e-6045bd0a52c7)" } |
json { "@odata.context": "https://yourorg.crm.dynamics.com/api/data/v9.2/$metadata#Microsoft.Dynamics.CRM.msdyn_UpdateRecordWithRuleBasedPredictionsResponse", "msdyn_UpdatedRecords": [ "incident(c82009d5-8203-f011-9aee-000d3a376aa8)" ] } |
| יוצר חיזויים עבור מזהה האירוע שצוין באמצעות הקשר מהודעת הדואר האלקטרוני ומעדכן את שדות האירוע, תוך הגדרה מפורשת של מזהה הלקוח עבור איש הקשר שצוין. | json { "msdyn_Target": { "@odata.type": "Microsoft.Dynamics.CRM.incident", "incidentid": "14ff4725-f1b0-ef11-ac2e-6045bd0a52c7", "customerid_contact@odata.bind": "contacts(e5ffe77b-b0a3-ef11-ac2e-6045bd0a52c7)" }, "msdyn_Context": "emails(fffe4725-f1b0-ef11-ac2e-6045bd0a52c7)" } |
json { "@odata.context": "https://yourorg.crm.dynamics.com/api/data/v9.2/$metadata#Microsoft.Dynamics.CRM.msdyn_UpdateRecordWithRuleBasedPredictionsResponse", "msdyn_UpdatedRecords": [ "incident(c82009d5-8203-f011-9aee-000d3a376aa8)", "contact(313a24c2-8203-f011-9aee-000d3a376aa8)" ] } |
| לא בוצעו עדכונים מאחר שמודל החיזוי לא הצליח ליצור חיזוי. | json { "@odata.context": "https://yourorg.crm.dynamics.com/api/data/v9.2/$metadata#Microsoft.Dynamics.CRM.msdyn_UpdateRecordWithRuleBasedPredictionsResponse", "msdyn_UpdatedRecords": [] } |