Arricchisci le bozze e-mail con collegamenti ai file dalla tua 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.]
Se utilizzi Copilot per le vendite per creare una bozza di messaggio e-mail considera l'intento dell'e-mail e utilizza le informazioni CRM di Salesforce o Dynamics 365 per creare la bozza. Puoi estendere la funzionalità di bozza e-mail fornita da Copilot per le vendite con file consigliati dalla tua applicazione.
Nota
Questa funzionalità è supportata solo per le bozze di messaggi e-mail create utilizzando il riquadro laterale Copilot per le vendite in Outlook.
Descrizione API
Devi aggiungere la seguente descrizione dell'API all'azione. In questo modo, Copilot per le vendite può identificare l'API corretta che deve essere richiamata per arricchire la funzionalità.
Questa azione ottiene i file rilevanti per la conversazione e-mail, che verranno visualizzati nelle bozze e-mail C4S in Outlook. L'azione migliora le competenze esistenti del Copilot per le vendite.
Payload input
| Name | Tipo di dati | Obbligatorio | Details | Descrizione da aggiungere nell'azione |
|---|---|---|---|---|
| resourceData | Object | Sì | Dati della risorsa da utilizzare per il recupero del contenuto suggerito. Per la struttura dei dati, vai a 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. |
| resourceType | String | Sì | Tipo di risorsa per la quale recuperare i suggerimenti di contenuto. Ad esempio, 'email-thread' o 'teams-chat'. | Questo input identifica il tipo di risorsa condivisa per il recupero dei collegamenti ai file suggeriti, che in questo caso è "email-thread". |
| recordType | String | No | Il tipo di record CRM, ad esempio account o opportunità. | Questo input identifica il tipo di record in CRM, che è correlato al thread e-mail. |
| recordId | String | No | L'identificatore univoco del record CRM da utilizzare per i contenuti suggeriti. | Questo input fornisce l'identificatore univoco del record CRM correlato al thread di posta elettronica. |
| 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. |
| inputPrompt | String | No | La richiesta suggerita attualmente utilizzata fornita dall'utente per generare una bozza di messaggio e-mail. Ad esempio, "Rispondi a un problema" o "Fai una proposta". | Questo input indica la richiesta fornita dall'utente durante la stesura di un messaggio e-mail. |
| 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à | Type | Details | 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 Ccn 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 altre informazioni, vai a DateTimeOffset Struct (sistema) | Questo input fornisce il timestamp del messaggio e-mail. |
| messageId | 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. |
Parametri di output
| Proprietà | Tipo di dati | Obbligatorio | Details |
|---|---|---|---|
| value | Matrice | Sì | Elenco di collegamenti a file (oggetti) definiti come descritto nella risposta Schema per suggerimenti sul contenuto di file o collegamenti. |
| hasMoreResults | Boolean | No | Un valore che indica se sono disponibili più risultati. |
Schema per la risposta ai suggerimenti sul contenuto del file o del collegamento
| Name | Formato del tipo di dati | Obbligatorio | Details | Descrizione da aggiungere nell'azione |
|---|---|---|---|---|
| contentType | string | Sì | Tipo di contenuto da mostrare. Per ulteriori informazioni, vai a Valori predefiniti per contentType | Questo output indica il tipo di contenuto incluso nella bozza del messaggio e-mail. |
| contenuto | string | Sì | Contenuti effettivi inclusi. Può trattarsi di una pagina Web o di un URL del file. | Questo output indica il contenuto effettivo incluso nella bozza del messaggio e-mail. Può trattarsi di una pagina Web o di un URL. |
| contentTitle | string | Sì | Titolo del contenuto suggerito mostrato all'utente. | Questo output indica il titolo del contenuto. |
| contentDescription | string | Sì | Descrizione del contenuto suggerito mostrato all'utente. | Questo output indica il testo da includere nella descrizione dei file. |
| contentIconUrl | string | No | Icona del contenuto suggerito mostrato all'utente. Se non è fornita, viene utilizzata un'icona generica. | Questo output indica l'icona da includere per il contenuto. |
| additionalProperties | Object | No | Set di coppie nome-valore che indicano proprietà aggiuntive del collegamento al file correlato restituito dall'azione. | Questo output indica proprietà aggiuntive come coppie nome-valore di ogni collegamento correlato restituito dall'azione. |
Valori predefiniti per contentType
| Valore stringa | Tipo di contenuto |
|---|---|
| content-file | File esterno (generico) |
| content-web | Pagina Web esterna |
| content-doc | Documento Microsoft Word |
| content-pdf | Documentazione PDF di Microsoft |
| contenuto-pptx | Presentazione di Microsoft PowerPoint |
| contenuto-xlsx | Fogli di calcolo Microsoft Excel |
Esempio
{
"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
}
L'esempio nell'immagine seguente mostra come viene mappato l'output dell'API alla bozza del messaggio e-mail.
Legenda:
- Collegamenti di file da app partner.
Vedi anche
Riepiloga un thread di posta elettronica utilizzando le informazioni sulle vendite con Copilot in Outlook
Arricchire il riepilogo messaggio e-mail con informazioni dettagliate dell'applicazione
Arricchisci le informazioni chiave sulle vendite con informazioni dettagliate della tua 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 Microsoft 365 Copilot per le vendite con applicazioni partner
Creare estensioni di Copilot per le vendite