Εμπλουτίστε τα προσχέδια ηλεκτρονικού ταχυδρομείου με συνδέσεις αρχείων από την εφαρμογή σας (έκδοση προεπισκόπησης)

Άρθρο
12/27/2024

Σημαντικό

Αυτή είναι μια δυνατότητα προεπισκόπησης έτοιμη για παραγωγή.
Οι έτοιμες για παραγωγή προεπισκοπήσεις υπόκεινται σε συμπληρωματικούς όρους χρήσης.

[Αυτό το άρθρο αποτελεί τεκμηρίωση προέκδοσης και ενδέχεται να αλλάξει.]

Όταν χρησιμοποιείτε το Copilot για πωλήσεις για να συντάξετε ένα μήνυμα ηλεκτρονικού ταχυδρομείου, λαμβάνει υπόψη την πρόθεση του μηνύματος ηλεκτρονικού ταχυδρομείου και χρησιμοποιεί πληροφορίες CRM από το Salesforce ή το Dynamics 365 για τη δημιουργία του προσχεδίου. Μπορείτε να επεκτείνετε τις δυνατότητες σύνταξης email που παρέχονται από το Copilot για πωλήσεις με συνιστώμενα αρχεία από τη δική σας εφαρμογή.

Σημείωμα

Αυτή η δυνατότητα υποστηρίζεται μόνο για προσχέδια μηνυμάτων ηλεκτρονικού ταχυδρομείου που δημιουργούνται χρησιμοποιώντας το πλαϊνό τμήμα παραθύρου Copilot για πωλήσεις στο Outlook.

Περιγραφή API

Πρέπει να προσθέσετε την ακόλουθη περιγραφή API στην ενέργεια. Με αυτόν τον τρόπο, το Copilot για πωλήσεις μπορεί να προσδιορίσει το σωστό API που πρέπει να ενεργοποιηθεί για να εμπλουτίσει τη δυνατότητα.

Αυτή η ενέργεια λαμβάνει αρχεία σχετικά με τη συνομιλία ηλεκτρονικού ταχυδρομείου, τα οποία θα εμφανίζονται σε πρόχειρα μηνύματα ηλεκτρονικού ταχυδρομείου C4S στο Outlook. Η δράση ενισχύει τις υπάρχουσες δεξιότητες του Copilot για πωλήσεις.

Λειτουργία API

Αυτό το API χρησιμοποιεί τον τύπο λειτουργίας: POST

Ωφέλιμο φορτίο εισόδου

Αυτό το ωφέλιμο φορτίο είναι το σώμα της αίτησης API.

Ονομασία	Τύπος δεδομένων	Απαραίτητο	Details	Περιγραφή που πρέπει να προστεθεί στην ενέργεια
resourceData	Object	Όχι	Τα δεδομένα πόρων που θα χρησιμοποιηθούν για τη λήψη του προτεινόμενου περιεχομένου. Για τη δομή δεδομένων, μεταβείτε στο μοντέλο δεδομένων ηλεκτρονικού ταχυδρομείου επεκτασιμότητας.	Αυτή η εισαγωγή προσδιορίζει το περιεχόμενο ηλεκτρονικού ταχυδρομείου που είναι μια συλλογή νημάτων ηλεκτρονικού ταχυδρομείου, θέματος και άλλων λεπτομερειών.
resourceType	Συμβλοσειρά	Όχι	Ο τύπος πόρου για τον οποίο θα ληφθούν προτάσεις περιεχομένου. Για παράδειγμα, "email-thread" ή "teams-chat".	Αυτή η εισαγωγή προσδιορίζει τον τύπο του κοινόχρηστου πόρου για τη λήψη προτεινόμενων συνδέσμων αρχείων, ο οποίος σε αυτήν την περίπτωση είναι 'email-thread'.
recordType	Συμβλοσειρά	όχι	Ο τύπος καρτέλας CRM, όπως λογαριασμός ή ευκαιρία.	Αυτή η εισαγωγή προσδιορίζει τον τύπο καρτέλας στο CRM που σχετίζεται με τη συνομιλία ηλεκτρονικού ταχυδρομείου.
recordId	Συμβλοσειρά	όχι	Το μοναδικό αναγνωριστικό της καρτέλας CRM που θα χρησιμοποιηθεί για προτεινόμενα περιεχόμενα.	Αυτή η εισαγωγή προσδιορίζει το μοναδικό αναγνωριστικό της καρτέλας CRM που σχετίζεται με τη συνομιλία μηνύματος ηλεκτρονικού ταχυδρομείου.
crmType	Συμβλοσειρά	όχι	Ο τύπος του συστήματος CRM, εάν είναι συνδεδεμένο. Οι έγκυρες τιμές είναι Salesforce και Dynamics 365.	Αυτή η εισαγωγή προσδιορίζει τον τύπο CRM με τον οποίο η καρτέλα σχετίζεται με τη συνομιλία μηνυμάτων ηλεκτρονικού ταχυδρομείου.
crmOrgUrl	Συμβλοσειρά	όχι	Η διεύθυνση URL του οργανισμού CRM.	Αυτή η εισαγωγή προσδιορίζει τη διεύθυνση URL του περιβάλλοντος CRM στο οποίο υπάρχει η καρτέλα που σχετίζεται με τη συνομιλία μηνύματος ηλεκτρονικού ταχυδρομείου.
inputPrompt	Συμβλοσειρά	όχι	Η τρέχουσα χρησιμοποιούμενη προτεινόμενη προτροπή που δίνεται από τον χρήστη για τη δημιουργία προχείρου ηλεκτρονικού ταχυδρομείου. Για παράδειγμα, "Απάντηση σε μια ανησυχία" ή "Κάντε μια πρόταση".	Αυτή η εισαγωγή υποδεικνύει την προτροπή που παρέχεται από τον χρήστη κατά τη σύνταξη ενός μηνύματος ηλεκτρονικού ταχυδρομείου.
κορυφαία	Integer	όχι	Ο αριθμός των στοιχείων για λήψη.	Αυτή η εισαγωγή υποδεικνύει τον αριθμό των συνδέσεων αρχείων προς λήψη.
skip	Integer	όχι	Ο αριθμός στοιχείων για παράλειψη.	Αυτή η εισαγωγή υποδεικνύει τον αριθμό των στοιχείων προς παράλειψη κατά τη λήψη προτεινόμενων συνδέσεων αρχείων.

Μοντέλο δεδομένων ηλεκτρονικού ταχυδρομείου επεκτασιμότητας

Ιδιότητα	Type	Details	Περιγραφή που πρέπει να προστεθεί στην ενέργεια
plaintextBody	Συμβλοσειρά	Το πλήρες σώμα ηλεκτρονικού ταχυδρομείου περιλαμβάνει όλα τα προηγούμενα μηνύματα της συνομιλίας ηλεκτρονικού ταχυδρομείου σε αυτό.	Αυτή η εισαγωγή παρέχει όλο το περιεχόμενο από τη συνομιλία ηλεκτρονικού ταχυδρομείου σε μορφή κειμένου.
fullHtmlBody	Συμβλοσειρά	Η πλήρης έκδοση HTML του σώματος ηλεκτρονικού ταχυδρομείου που περιλαμβάνει όλα τα προηγούμενα μηνύματα της συνομιλίας ηλεκτρονικού ταχυδρομείου σε αυτό.	Αυτή η εισαγωγή παρέχει όλο το περιεχόμενο από τη συνομιλία ηλεκτρονικού ταχυδρομείου σε μορφή HTML.
θέμα	Συμβλοσειρά	Θέμα του μηνύματος ηλεκτρονικού ταχυδρομείου.	Αυτή η εισαγωγή παρέχει το θέμα του μηνύματος ηλεκτρονικού ταχυδρομείου.
από	Συμβλοσειρά	Η διεύθυνση ηλεκτρονικού ταχυδρομείου του αποστολέα.	Αυτή η εισαγωγή παρέχει τη διεύθυνση ηλεκτρονικού ταχυδρομείου του αποστολέα.
to	String[]	Διευθύνσεις ηλεκτρονικού ταχυδρομείου παραλήπτη.	Αυτή η εισαγωγή παρέχει τη διεύθυνση ηλεκτρονικού ταχυδρομείου του παραλήπτη.
κοιν.	String[]	Οι διευθύνσεις ηλεκτρονικού ταχυδρομείου των παραληπτών προστίθενται στο πεδίο Κοιν. του μηνύματος ηλεκτρονικού ταχυδρομείου.	Αυτή η εισαγωγή παρέχει όλες τις διευθύνσεις ηλεκτρονικού ταχυδρομείου του παραλήπτη που περιλαμβάνονται στο πεδίο Κοιν. του μηνύματος ηλεκτρονικού ταχυδρομείου.
Ιδιαίτ. κοιν.	String[]	Οι διευθύνσεις ηλεκτρονικού ταχυδρομείου των παραληπτών προστίθενται στο πεδίο Ιδιαίτ. κοιν. του μηνύματος ηλεκτρονικού ταχυδρομείου.	Αυτή η εισαγωγή παρέχει όλες τις διευθύνσεις ηλεκτρονικού ταχυδρομείου του παραλήπτη που προστέθηκαν στο πεδίο Ιδιαίτ. κοιν. του μηνύματος ηλεκτρονικού ταχυδρομείου.
sentDateTime	DateTimeOffset	Η ημερομηνία και η ώρα του μηνύματος ηλεκτρονικού ταχυδρομείου σε μορφή UTC μαζί με την ιδιότητα Offset. Για περισσότερες πληροφορίες, μεταβείτε στο DateTimeOffset Struct (Σύστημα)	Αυτή η εισαγωγή παρέχει τη χρονική σήμανση του μηνύματος ηλεκτρονικού ταχυδρομείου.
messageId	Συμβλοσειρά	Το αναγνωριστικό γραφήματος του μηνύματος ηλεκτρονικού ταχυδρομείου.	Αυτή η εισαγωγή παρέχει το αναγνωριστικό μηνύματος του μηνύματος ηλεκτρονικού ταχυδρομείου.
conversationId	Συμβλοσειρά	Το αναγνωριστικό συνομιλίας γραφήματος της συνομιλίας μηνύματος ηλεκτρονικού ταχυδρομείου.	Αυτή η εισαγωγή παρέχει το αναγνωριστικό συνομιλίας της συνομιλίας του μηνύματος ηλεκτρονικού ταχυδρομείου.

Παράμετροι εξόδου

Ιδιότητα	Τύπος δεδομένων	Απαραίτητο	Details
τιμή	Πίνακας	Όχι	Μια λίστα συνδέσεων αρχείων (αντικειμένων) που ορίζονται όπως περιγράφεται στο Σχήμα για απάντηση προτάσεων περιεχομένου αρχείων ή συνδέσεων.
hasMoreResults	Boolean	όχι	Μια τιμή που υποδεικνύει εάν είναι διαθέσιμα περισσότερα αποτελέσματα.

Σχήμα για απάντηση προτάσεων περιεχομένου αρχείων ή συνδέσεων

Ονομασία	Μορφή τύπου δεδομένων	Απαραίτητο	Details	Περιγραφή που πρέπει να προστεθεί στην ενέργεια
contentType	string	Όχι	Ο τύπος περιεχομένου για εμφάνιση. Περισσότερες πληροφορίες, μεταβείτε στις Προκαθορισμένες τιμές για contentType	Αυτή η εξαγωγή υποδεικνύει τον τύπο περιεχομένου που περιλαμβάνεται στο πρόχειρο μήνυμα ηλεκτρονικού ταχυδρομείου.
περιεχόμενο	string	Όχι	Περιλαμβάνεται πραγματικό περιεχόμενο. Μπορεί να είναι είτε μια ιστοσελίδα είτε μια διεύθυνση URL του αρχείου.	Αυτή η εξαγωγή υποδεικνύει το πραγματικό περιεχόμενο που περιλαμβάνεται στο πρόχειρο μήνυμα ηλεκτρονικού ταχυδρομείου. Μπορεί να είναι είτε μια ιστοσελίδα είτε μια διεύθυνση URL.
contentTitle	string	Όχι	Τίτλος του προτεινόμενου περιεχομένου που εμφανίζεται στον χρήστη.	Αυτή η εξαγωγή υποδεικνύει τον τίτλο του περιεχομένου.
contentDescription	string	Όχι	Περιγραφή του προτεινόμενου περιεχομένου που εμφανίζεται στον χρήστη.	Αυτή η εξαγωγή υποδεικνύει το κείμενο που πρέπει να συμπεριληφθεί κατά την περιγραφή των αρχείων.
contentIconUrl	string	όχι	Εικονίδιο του προτεινόμενου περιεχομένου που εμφανίζεται στον χρήστη. Εάν δεν παρέχεται, χρησιμοποιείται ένα γενικό εικονίδιο.	Αυτή η εξαγωγή υποδεικνύει το εικονίδιο που θα συμπεριληφθεί για το περιεχόμενο.
additionalProperties	Object	όχι	Ένα σύνολο από ζεύγη ονομάτων-τιμών που υποδεικνύουν πρόσθετες ιδιότητες της σχετικής σύνδεσης αρχείων που επιστρέφει η ενέργεια.	Αυτή η εξαγωγή υποδεικνύει πρόσθετες ιδιότητες ως ζεύγος ονόματος-τιμής κάθε σχετικής σύνδεσης που επιστρέφεται από την ενέργεια.

Προκαθορισμένες τιμές για contentType

Τιμή συμβολοσειράς	Τύπος περιεχομένου
περιεχόμενο-αρχείο	Εξωτερικό αρχείο (Γενικό)
περιεχόμενο-web	Εξωτερική τοποθεσία web
περιεχόμενο-doc	Έγγραφο Microsoft Word
περιεχόμενο-pdf	Έγγραφο Microsoft PDF
έγγραφο-pptx	Παρουσίαση Microsoft PowerPoint
περιεχόμενο-xlsx	Υπολογιστικό φύλλο Microsoft Excel

Παράδειγμα

{
  "value": [
    {
      "contentType": 0,
      "content": "https://www.bing.com",
      "contentTitle": "Purchase Contract",
      "contentDescription": "Purchase Contract Description",
      "contentIconUrl": null,
      "additionalProperties": {
        "Recipients": "Logan Edwards",
        "Sender Name": "Kenny Smith"
      }
    },
    {
      "contentType": 3,
      "content": "https://www.microsoft.com",
      "contentTitle": "Strategy Planning",
      "contentDescription": "Strategy Planning Description",
      "contentIconUrl": null,
      "additionalProperties": {
        "Recipients": "Gabriela Edwards",
        "Sender Name": "Maria Smith"
      }
    },
    {
      "contentType": 1,
      "content": "https://www.bing.com",
      "contentTitle": "Contoso Website",
      "contentDescription": "Contoso Website Description",
      "contentIconUrl": null,
      "additionalProperties": {
        "Total Views": "100",
        "Domain": "Contoso.com"
      }
    }
  ],
  "hasMoreResults": false
}

Το παράδειγμα στην ακόλουθη εικόνα δείχνει πώς η έξοδος του API αντιστοιχίζεται στη πρόχειρο email.

Στιγμιότυπο οθόνης που εμφανίζει συνδέσεις αρχείων από εφαρμογές συνεργατών στο πρόχειρο email.

Υπόμνημα:

Συνδέσεις αρχείων από εφαρμογές συνεργατών.

Δείτε επίσης

Σύνοψη συνομιλίας ηλεκτρονικού ταχυδρομείου χρησιμοποιώντας πληροφορίες πωλήσεων με το Copilot στο Outlook
Εμπλουτίστε τις συνόψεις ηλεκτρονικού ταχυδρομείου με πληροφορίες από την εφαρμογή σας
Εμπλουτίστε βασικές πληροφορίες πωλήσεων με πληροφορίες από την εφαρμογή σας
Εμπλουτίστε λεπτομέρειες καρτέλας CRM με πληροφορίες από την εφαρμογή σας
Εμπλουτίστε τις συνόψεις καρτέλας CRM με πληροφορίες από την εφαρμογή σας
Επεκτείνετε το Microsoft 365 Copilot για πωλήσεις με εφαρμογές συνεργατών
Δημιουργία επεκτάσεων για το Copilot για πωλήσεις

Κοινή χρήση μέσω