Μαζική λήψη μεταγραφών του Κέντρου επικοινωνίας του Dynamics 365

Οι μεταγραφές του Κέντρου επικοινωνίας του Dynamics 365 αποθηκεύονται σε κωδικοποιημένη μορφή base64 στον πίνακα σχολίων στο Microsoft Dataverse. Τα συνημμένα αποθηκεύονται ως ξεχωριστές εγγραφές στον πίνακα σχολίων. Εάν μια συνομιλία έχει ανταλλάξει δύο αρχεία μεταξύ του εκπροσώπου και του πελάτη, δημιουργούνται συνολικά τρεις καρτέλες που σχετίζονται με αυτήν τη συνομιλία. Κάθε συνομιλία έχει πάντα n+1 εγγραφές αποθηκευμένες για αυτήν στον πίνακα σχολιασμών, όπου n είναι ο αριθμός των συνημμένων στη συνομιλία. Τα συνημμένα κωδικοποιούνται επίσης base64 πριν αποθηκευτούν.

Η επιλογή μαζικής λήψης μεταγραφών δεν είναι διαθέσιμη από το κουτί. Μπορείτε να χρησιμοποιήσετε τις ακόλουθες αιτήσεις Web API για να ανακτήσετε όλες τις μεταγραφές και τα συνημμένα που ανταλλάχθηκαν τον τελευταίο μήνα.

Η ακόλουθη αίτηση Web API ανακτά όλες τις μεταγραφές κειμένου:

GET [Organization URI]/api/data/v9.1/annotations?$filter=objecttypecode eq 'msdyn_transcript'
Accept: application/json  
OData-MaxVersion: 4.0  
OData-Version: 4.0

Η ακόλουθη αίτηση Web API ανακτά όλα τα σχόλια συνημμένων αρχείων:

GET [Organization URI]/api/data/v9.1/annotations?$filter=objecttypecode eq 'msdyn_ocliveworkitem'
Accept: application/json  
OData-MaxVersion: 4.0  
OData-Version: 4.0

Το documentBody χαρακτηριστικό στην απόκριση που λαμβάνεται από κάθε ένα από τα αιτήματα API ιστού περιέχει την κωδικοποιημένη μεταγραφή ή συνημμένο base64.

Μπορείτε να καλέσετε τα API χρησιμοποιώντας κώδικα C# και, στη συνέχεια, να επαναλάβετε καθεμία από τις εγγραφές που επιστρέφονται, να αποκτήσετε πρόσβαση στο documentBody χαρακτηριστικό και να το επεξεργαστείτε για να λάβετε ολόκληρες τις μεταγραφές.

Απαιτείται τουλάχιστον ένα μήνυμα που αποστέλλεται από έναν πελάτη για τη δημιουργία μιας μεταγραφής.

Δομή της αναλυτικής βαθμολογίας JSON

Οι μεταγραφές που βλέπετε στον σύνδεσμο μπορεί να περιέχουν διαφορετικούς τύπους μηνυμάτων:

  • Έλεγχος μηνυμάτων
  • Μηνύματα συστήματος
  • Μηνύματα κειμένου (για παράδειγμα, Γεια, Γεια και Πώς είσαι)
  • Μετα-δεδομένα συνημμένου αρχείου

Σε κάθε έναν από αυτούς τους τύπους μηνυμάτων, μπορείτε να δείτε ένα createdDateTime πεδίο που δηλώνει την ακριβή ώρα κατά την οποία δημοσιεύτηκε ή δημιουργήθηκε αυτό το μήνυμα.

Ένα μήνυμα ελέγχου δεν έχει οπτική αξία και υποδεικνύει ένα συμβάν όπως ο εκπρόσωπος που συμμετείχε ή αποχώρησε από τη συνομιλία. Συνήθως έχει μια σημαία που ονομάζεται isControlMessage ρυθμισμένη σε true.

{
    "content": "<addmember><eventtime>1589863236124</eventtime><initiator>28:bc81db89-c4d7-4763-91fe-086fcc2e6daf</initiator><rosterVersion>1589863235629</rosterVersion><lastRosterVersion>1589801089959</lastRosterVersion><target>8:orgid:04fd615d-586d-4866-9791-b24c5f7a9e78</target></addmember>",
    "contentType": "text",
    "createdDateTime": "2020-05-19T04:40:36.124+00:00",
    "likes": [],
    "attachments": [],
    "id": "1589863236124",
    "created": "2020-05-19T04:40:36.124Z",
    "culture": null,
    "deleted": null,
    "important": null,
    "modified": null,
    "modifiedDateTime": null,
    "isControlMessage": true,
    "from": null
},

Ένα μήνυμα συστήματος είναι ένας ειδικός τύπος μηνύματος που εμφανίζεται στον πελάτη σχετικά με συμβάντα κατά τη διάρκεια των συνομιλιών. Για παράδειγμα, όταν συμμετέχει ένας εκπρόσωπος, όταν αποσυνδέεται ένας εκπρόσωπος και όταν συμμετέχει ένας νέος εκπρόσωπος.

{
	"content": "Alan Steiner has left the conversation.",
	"contentType": "text",
	"createdDateTime": "2020-05-19T04:43:12.976+00:00",
	"from": {
		"application": {
			"displayName": "DynamicsBot",
			"id": "bc81db89-c4d7-4763-91fe-086fcc2e6daf"
		},
		"user": null,
		"phone": null,
		"guest": null,
		"encrypted": null,
		"onPremises": null,
		"azureApplicationInstance": null,
		"applicationInstance": null,
		"device": null
	},
	"likes": [],
	"attachments": [],
	"id": "1589863392976",
	"created": "2020-05-19T04:43:12.976Z",
	"culture": null,
	"deleted": null,
	"important": null,
	"modified": null,
	"modifiedDateTime": null,
	"tags": "system"
},

Τα μηνύματα κειμένου που ανταλλάσσονται κατά τη διάρκεια της συνομιλίας μεταξύ πράκτορα και πελάτη εμφανίζονται ως εξής:

{
	"content": "I am using product A",
	"contentType": "text",
	"createdDateTime": "2020-05-19T04:43:03.979+00:00",
	"from": {
		"user": {
			"displayName": "Customer",
			"id": "04fd615d-586d-4866-9791-b24c5f7a9e78"
		},
		"phone": null,
		"guest": null,
		"encrypted": null,
		"onPremises": null,
		"azureApplicationInstance": null,
		"applicationInstance": null,
		"application": null,
		"device": null
	},
	"likes": [],
	"attachments": [],
	"id": "1589863384036",
	"created": "2020-05-19T04:43:03.979Z",
	"culture": null,
	"deleted": null,
	"important": null,
	"modified": null,
	"modifiedDateTime": null,
	"tags": "private,parentID-5493180821148088016",
	"deliveryMode": "unbridged"
},

Όπως φαίνεται στον προηγούμενο κώδικα, τα μηνύματα που αποστέλλονται από τον πελάτη έχουν ένα εμφανιζόμενο όνομα "Πελάτης" εάν είναι μη αναγνωρισμένος πελάτης ή το πραγματικό του όνομα εάν είναι γνωστός στο Κέντρο επικοινωνίας του Dynamics 365.

Για μηνύματα που στέλνει ο εκπρόσωπος σε έναν πελάτη, υπάρχουν ετικέτες που υποδηλώνουν ότι πρόκειται για "δημόσιο" μήνυμα. Τα μηνύματα που επισημαίνονται με "ιδιωτικό" στις ετικέτες είναι μηνύματα που ανταλλάσσονται μεταξύ δύο εκπροσώπων και δεν είναι ορατά στον πελάτη.

{
	"content": "Great! Just give me a moment. \\nWhich product are you using currently?",
	"contentType": "text",
	"createdDateTime": "2020-05-19T04:42:44.202+00:00",
	"from": {
		"user": {
			"displayName": "Alan Steiner",
			"id": "04fd615d-586d-4866-9791-b24c5f7a9e78"
		},
		"phone": null,
		"guest": null,
		"encrypted": null,
		"onPremises": null,
		"azureApplicationInstance": null,
		"applicationInstance": null,
		"application": null,
		"device": null
	},
	"likes": [],
	"attachments": [],
	"id": "1589863364220",
	"created": "2020-05-19T04:42:44.202Z",
	"culture": null,
	"deleted": null,
	"important": null,
	"modified": null,
	"modifiedDateTime": null,
	"tags": "public,messageId-1589863364202,RTT-C1",
	"deliveryMode": "unbridged"
},

Ένα FileAttachment μήνυμα μοιάζει με το ακόλουθο απόσπασμα στο JSON:

{
    "content": "",
    "contentType": "text",
    "createdDateTime": "2020-05-06T21:31:37.316+00:00",
    "from": {
      "application": {
        "displayName": "Customer",
        "id": "6cc05310-05d9-4ce5-8fc0-d606c478f896"
      },
      "user": null,
      "phone": null,
      "guest": null,
      "encrypted": null,
      "onPremises": null,
      "azureApplicationInstance": null,
      "applicationInstance": null,
      "device": null
    },
    "likes": [
    ],
    "attachments": [
      {
        "id": "0-wus-d3-37f4fa3cd63945c526799ae5b4e009f5",
        "index": 0,
        "fileType": "docx",
        "name": "mr Hand goes to the moon, By contoso.docx",
        "sourceUrl": "https://us-api.asm.contoso.com/v1/objects/0-wus-d3-37f4fa3cd63945c526799ae5b4e009f5/",
        "annotationid": "cfb551a8-ef4f-431a-871f-9b027ff940e3"
      }
    ],
    "id": "1588800697316",
    "created": "2020-05-06T21:31:37.316Z",
    "culture": null,
    "deleted": null,
    "important": null,
    "modified": null,
    "modifiedDateTime": null,
    "deliveryMode": "bridged"
  },

Συνήθως έχει μεταδεδομένα που σχετίζονται με τα συνημμένα που ανταλλάσσονται κατά τη διάρκεια της συνομιλίας. Το annotationid είναι το κλειδί για την κωδικοποιημένη εγγραφή base64 στον πίνακα σχολιασμών για αυτό το συνημμένο αρχείο. Μπορείτε να ανακτήσετε την εγγραφή χρησιμοποιώντας την ακόλουθη αίτηση Web API. Η αίτηση Web API σάς παρέχει το κωδικοποιημένο συνημμένο base64 που μπορείτε να αποκωδικοποιήσετε και να χρησιμοποιήσετε με τον τρόπο που θέλετε.

GET [Organization URI]/api/data/v9.1/annotations(<annotationid>)
Accept: application/json  
OData-MaxVersion: 4.0  
OData-Version: 4.0

Κέντρο επικοινωνίας του Dynamics 365 για προγραμματιστές

  • Τελευταία ενημέρωση στις