Χρήση API πρόβλεψης πεδίου υπόθεσης

Μπορείτε να χρησιμοποιήσετε το msdyn_UpdateRecordWithRuleBasedPredictions API για να προβλέψετε πεδία υποθέσεων με περιβάλλον από το μήνυμα ηλεκτρονικού ταχυδρομείου μετά τη δημιουργία μιας υπόθεσης. Το API ενημερώνει τα διαμορφωμένα πεδία στην περίπτωση με τις προβλεπόμενες τιμές από το μήνυμα ηλεκτρονικού ταχυδρομείου, επιτρέποντάς σας να αυτοματοποιήσετε ενημερώσεις υποθέσεων και να βελτιώσετε την αποτελεσματικότητα στις υποθέσεις χειρισμού.

Προϋποθέσεις

Λεπτομέρειες αίτησης

  • Διεύθυνση URL: https://<orgurl>/api/data/v9.2/msdyn_UpdateRecordWithRuleBasedPredictions
  • Μέθοδος: POST
  • Έκδοση: 1.0

Παράμετροι αίτησης

Το σώμα αίτησης περιέχει τις ακόλουθες παραμέτρους:

Παράμετρος Τύπος Απαιτείται Περιγραφή Format
msdyn_Target Οντότητα Όχι Οντότητα που πρέπει να ενημερωθεί και χρησιμοποιείται για να συμφωνεί με τους ρυθμισμένους κανόνες ενημέρωσης. Πρέπει να περιέχει το αναγνωριστικό μιας υπάρχουσας εγγραφής.
json<br>{<br> "@odata.type": "Microsoft.Dynamics.CRM.incident",<br> "incidentid": "14ff4725-f1b0-ef11-ac2e-6045bd0a52c7"<br>}<br>
msdyn_Context Αναφορά οντοτήτων Όχι Η οντότητα ηλεκτρονικού ταχυδρομείου που χρησιμοποιείται για την παροχή περιβάλλοντος για πρόβλεψη AI.
<br>emails(fffe4725-f1b0-ef11-ac2e-6045bd0a52c7)<br>

Ιδιότητες απόκρισης

Ιδιότητα Τύπος Περιγραφή Παράδειγμα
msdyn_UpdatedRecords Πίνακας συμβολοσειρών Λίστα πεδίων οντότητας που ενημερώθηκαν. ['incident(GUID)', 'contact(GUID)', ...]

Ο msdyn_UpdatedRecords πίνακας είναι κενός στα παρακάτω σενάρια:

  • Τα πεδία υπόθεσης που θα ενημερωθούν δεν έχουν ρυθμιστεί.
  • Τα πεδία που θα ενημερωθούν έχουν ήδη ενημερωθεί με μη αυτόματο τρόπο.
  • Το μοντέλο πρόβλεψης δεν ήταν σε θέση να δημιουργήσει μια πρόβλεψη.

Χειρισμός σφαλμάτων

Το API δημιουργεί εξαιρέσεις στα παρακάτω σενάρια:

  • Ο χρήστης δεν έχει τα απαιτούμενα δικαιώματα για να ενημερώσει την οντότητα.
  • Το καθορισμένο αναγνωριστικό οντότητας δεν υπάρχει.
  • Σφάλματα ρύθμισης παραμέτρων.
  • Εξαιρέσεις από τις υποκείμενες υπηρεσίες πρόβλεψης.

Παράδειγμα

Ο παρακάτω πίνακας περιγράφει τα δείγματα σεναρίων αίτησης και απόκρισης για το API.

Περιγραφή Αίτηση Απάντηση
Δημιουργεί προβλέψεις AI για το καθορισμένο αναγνωριστικό υπόθεσης και ενημερώνει την εγγραφή χρησιμοποιώντας πληροφορίες βάσει περιεχομένου από το σχετικό μήνυμα ηλεκτρονικού ταχυδρομείου. 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)" ] }
Δημιουργεί προβλέψεις για το καθορισμένο αναγνωριστικό υπόθεσης χρησιμοποιώντας περιβάλλον από το μήνυμα ηλεκτρονικού ταχυδρομείου και ενημερώνει τα πεδία υπόθεσης, ορίζοντας ρητά το customerid στην καθορισμένη επαφή. 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": [] }
  • Τελευταία ενημέρωση στις