Arricchire il riepilogo e-mail con suggerimenti di contenuto dall'applicazione (anteprima)

Importante

• Questa è una funzionalità di anteprima pronta per la produzione.
• Le anteprime pronte per la produzione sono soggette a condizioni per l'utilizzo supplementari.

[Questo articolo fa parte della documentazione non definitiva, pertanto è soggetto a modifiche.]

Quando Copilot in Outlook e l'app Sales vengono usati insieme, i riepiloghi di posta elettronica visualizzati in Outlook includono informazioni sulle vendite provenienti dal sistema CRM (Customer Relationship Management), ad esempio Dynamics 365 o Salesforce CRM. È possibile estendere la funzionalità di riepilogo della posta elettronica fornita dall'app Sales con informazioni dettagliate dalla propria applicazione.

Nota

Questa API sostituisce l'API Competenza riepilogo e-mail esistente (ID operazione: scp-get-email-insights) con una nuova versione.

Descrizione API

Devi aggiungere la seguente descrizione dell'API all'azione. In questo modo l'app Sales identifica l'API corretta da richiamare per arricchire la funzionalità.

Questa azione ottiene ulteriori informazioni dettagliate sulle vendite che verranno visualizzate nell'esperienza di riepilogo e-mail di C4S all'interno del riepilogo di Outlook. L'azione migliora le competenze esistenti del Copilot per le vendite.

Dettagli API

• Nome API: competenza riepilogo e-mail versione 2
• ID operazione Swagger: scp-get-email-insights-v2
• Metodo operazione Swagger: post
• Percorso: <PowerAppsConnectorHostName>/api/enhanceskills/email-insights-v2

Payload input

Questo payload funge da corpo della richiesta API.

Nome	Tipo di dati	Obbligatorio	Dettagli	Descrizione da aggiungere nell'azione
resourceData	Oggetto	Sì	Dati della risorsa da utilizzare per il recupero del contenuto suggerito. Per la struttura dei dati, vedi Modello di dati e-mail per l'estendibilità.	Questo input identifica il contenuto del messaggio e-mail che è una raccolta di thread e-mail, oggetto e altri dettagli.
entità correlate	Matrice	NO	La matrice di entità correlate. Per la struttura dei dati, vedi Modello di dati entità correlate.	Questo input identifica la matrice di record CRM correlata al thread e-mail.
crmType	String	NO	Il tipo di sistema CRM, se connesso. I valori validi sono Salesforce e Dynamics 365.	Questo input indica il tipo di CRM in cui si trova il record correlato al thread di posta elettronica.
crmOrgUrl	String	NO	URL dell'organizzazione CRM.	Questo input indica l'URL dell'ambiente CRM in cui si trova il record relativo al thread di posta elettronica.
migliori	Intero	NO	Il numero di elementi da recuperare.	Questo input indica il numero di collegamenti di file da recuperare.
skip	Intero	NO	Il numero di elementi da ignorare.	Questo input indica il numero di elementi da ignorare durante il recupero dei collegamenti ai file suggeriti.

Modello di dati e-mail per l'estendibilità

Proprietà	TIPO	Dettagli	Descrizione da aggiungere nell'azione
plaintextBody	String	Il corpo completo del messaggio e-mail include tutti i messaggi precedenti del thread e-mail.	Questo input fornisce tutto il contenuto del thread e-mail in formato testo.
fullHtmlBody	String	La versione HTML completa del corpo del messaggio e-mail che include tutti i messaggi precedenti del thread e-mail.	Questo input fornisce tutto il contenuto del thread e-mail in formato HTML.
soggetto	String	Oggetto del messaggio e-mail.	Questo input fornisce l'oggetto del messaggio e-mail.
da	String	Indirizzo e-mail del mittente.	Questo input fornisce l'indirizzo e-mail del mittente.
a	Stringa[]	Indirizzi e-mail del destinatario.	Questo input fornisce l'indirizzo e-mail del destinatario.
Cc	Stringa[]	Indirizzi e-mail dei destinatari aggiunti nel campo Cc dell'e-mail.	Questo input fornisce tutti gli indirizzi e-mail del destinatario inclusi nel campo Cc del messaggio e-mail.
ccn	Stringa[]	Indirizzi e-mail dei destinatari aggiunti nel campo Bcc dell'e-mail.	Questo input fornisce tutti gli indirizzi e-mail del destinatario aggiunti nel campo Ccn del messaggio e-mail.
sentDateTime	DateTimeOffset	La data e l'ora del messaggio e-mail in formato UTC insieme alla proprietà Offset. Per ulteriori informazioni, vai a DateTimeOffset Struct (System)	Questo input fornisce il timestamp del messaggio e-mail.
ID messaggio	String	L'ID del messaggio Graph dell'e-mail.	Questo input fornisce l'ID messaggio del messaggio e-mail.
conversationId	String	L'ID conversazione Graph del thread di posta elettronica.	Questo input fornisce l'ID conversazione del thread di posta elettronica.

Modello di dati dell'entità correlato

Proprietà	TIPO	Obbligatorio	Dettagli	Descrizione da aggiungere nell'azione
entityId	String	Sì	Il tipo di record CRM, ad esempio account o opportunità.	Questo input fornisce l'identificatore univoco del record CRM correlato al thread di posta elettronica.
tipo di entità	String	Sì	L'identificatore univoco del record CRM da utilizzare per i contenuti suggeriti.	Questo input identifica il tipo di record in CRM, che è correlato al thread e-mail.
entitySource	String	NO	Questo input indica l'origine dell'entità, attualmente contiene valori "connessi" o vuoti.	Questo input indica il tipo di origine dell'entità.

Parametri di output

L'app Sales prevede di ricevere un elenco di informazioni dettagliate (oggetti) dalle API e prevede che ogni informazione abbia parametri specifici. Per assicurarsi che l'app Sales possa analizzare correttamente l'output, la struttura di risposta deve rispettare le linee guida riportate nella tabella seguente.

Parametro	Tipo di dati	Obbligatorio	Dettagli
value	Matrice	Sì	Elenco di informazioni dettagliate (oggetti) definite come descritto nella sezione Schema per informazioni dettagliate. Nota: sebbene questo parametro includa un elenco di informazioni dettagliate, solo la prima viene utilizzata nel riepilogo arricchimento della posta elettronica per l'esperienza canvas di Outlook.
ha più risultati	Boolean	NO	Un valore che indica se sono disponibili più risultati.

Schema per informazioni dettagliate

Nome	Formato/tipo di dati	Obbligatorio	Dettagli	Descrizione da aggiungere nell'azione
dati analitici	String	Sì	Le informazioni dettagliate fornite agli utenti, ad esempio I colleghi Mona Kane, Ray Tanaka e Daniela Smith hanno già lavorato con loro in precedenza.	Questo output indica il testo che desideri includere nel riepilogo messaggio e-mail.

Esempio

{
    "value": [
        {
            "insight": "Your colleagues Mona Kane, Ray Tanaka and Daniela Smith have worked with them before."
        },
        {
            "insight": "The email was opened three times in the last month."
        }
    ],
    "hasMoreResults": false
}
 

L'esempio nell'immagine seguente mostra come viene mappato l'output dell'API al riepilogo della bozza del messaggio e-mail nel riquadro laterale.

Legenda:

1. Titolo dell'informazione dettagliata. Informazioni dettagliate con lo stesso titolo vengono raggruppate insieme.
2. Descrizioni delle informazioni dettagliate. Ciascuna informazione dettagliata ha una descrizione.

L'esempio nell'immagine seguente mostra come viene mappato l'output dell'API al riepilogo della bozza del messaggio e-mail nel corpo del messaggio e-mail.

Legenda:

1. Titolo dell'informazione dettagliata. Informazioni dettagliate con lo stesso titolo vengono raggruppate insieme.
2. Descrizione dell'informazione dettagliata. Ciascuna informazione dettagliata ha una descrizione.

Informazioni correlate

Riepilogare un thread di posta elettronica utilizzando le informazioni sulle vendite con Copilot in Outlook
Arricchire le informazioni dettagliate sulle opportunità con i dati dell'applicazione
Arricchire i dettagli dei record CRM con informazioni dettagliate della tua applicazione
Arricchire i riepiloghi dei record CRM con informazioni dettagliate della tua applicazione
Estendere le vendite in Microsoft 365 Copilot con applicazioni partner
Arricchire le bozze di messaggi e-mail con collegamenti ai file dell'applicazione
Creare estensioni per le vendite in Microsoft 365 Copilot