Condividi tramite

Arricchisci le bozze e-mail con collegamenti ai file dalla tua applicazione (anteprima)

Importante

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

Quando usi l'app Sales per creare un messaggio di posta elettronica, considera la finalità del messaggio di posta elettronica e usa le informazioni CRM di Salesforce o Dynamics 365 per creare la bozza. È possibile estendere la funzionalità di creazione della posta elettronica fornita dall'app Sales con i file consigliati dalla propria applicazione.

Nota

Questa funzionalità è supportata solo per le bozze di posta elettronica create usando l'app Sales in Outlook.

Descrizione API

Devi aggiungere la seguente descrizione dell'API all'azione. In questo modo, l'app Sales può identificare l'API corretta che deve essere richiamata per arricchire la funzionalità.

Questa azione ottiene i file pertinenti alla conversazione e-mail, che verranno visualizzati nelle bozze e-mail C4S in Outlook. L'azione migliora le competenze esistenti del Copilot per le vendite.

Operazione API

Questa API utilizza il tipo di operazione: POST

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.
tipo di risorsa 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à 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.

Parametri di output

Proprietà Tipo di dati Obbligatorio Dettagli
value Matrice Sì Elenco di collegamenti a file (oggetti) che sono definiti come descritto nella risposta relativa allo schema dei suggerimenti sul contenuto di file o collegamenti.
ha più risultati Boolean NO Un valore che indica se sono disponibili più risultati.

Schema per la risposta ai suggerimenti sul contenuto del file o del collegamento

Nome Formato del tipo di dati Obbligatorio Dettagli Descrizione da aggiungere nell'azione
tipo di contenuto 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 attuale incluso nella bozza del messaggio e-mail. Può trattarsi di una pagina Web o di un URL.
Titolo del contenuto string Sì Titolo del contenuto suggerito mostrato all'utente. Questo output indica il titolo del contenuto.
contenutoDescrizione 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.
proprietà aggiuntive Oggetto 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)
contenuto del web Pagina Web esterna
content-doc Documento Microsoft Word
content-pdf Documentazione PDF di Microsoft
content-pptx Presentazione di Microsoft PowerPoint
content-xlsx Foglio 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.

Screenshot che mostra i collegamenti ai file dalle app partner nella bozza del messaggio e-mail.

Legenda:

  1. Collegamenti di file da app partner.

Vedi anche

Riepilogare un thread di posta elettronica utilizzando le informazioni sulle vendite con Copilot in Outlook
Arricchire il riepilogo dei messaggi e-mail con informazioni dettagliate dell'applicazione
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
Creare estensioni per le vendite in Microsoft 365 Copilot

  • Last updated on