Forbedre mailkladder med fillinks fra dit program (forhåndsversion)

Artikel
12/27/2024

Vigtige oplysninger

Dette er en produktionsklar prøveversionsfunktion.
Produktionsklare forhåndsversioner er underlagt supplerende vilkår for anvendelse.

[Denne artikel er til dokumentationen til den foreløbige udgivelse. Der kan forekomme ændringer.]

Når du bruger Copilot til salg til at skrive en mailkladde, tages der højde for mailens hensigt, og der bruges CRM-oplysninger fra Salesforce eller Dynamics 365 til at oprette kladden. Du kan udvide den funktion til udarbejdelse af e-mail, som Copilot til salg giver med anbefalede filer fra dit eget program.

Bemærk

Denne funktion understøttes kun for mailkladder, der er oprettet ved hjælp af sideruden Copilot til salg i Outlook.

API-beskrivelse

Du skal føje følgende API-beskrivelse til handlingen. På denne måde kan Copilot til salg identificere den korrekte API, der skal aktiveres for at forbedre funktionen.

Denne handling henter filer, der er relevante for mailsamtalen, som vises i C4S-mailkladder i Outlook. Handlingen forbedrer de eksisterende færdigheder i Copilot til salg.

Input-nyttedata

Name	Datatype	Påkrævet	Oplysninger	Beskrivelse, der skal føjes til handlingen
resourceData	Object	Ja	De ressourcedata, der skal bruges til at hente det foreslåede indhold. For datastrukturen skal du gå til Model for udvidelsesmuligheder for maildata.	Dette input identificerer e-mail-indholdet, som er en samling af e-mail-tråd, emne og andre detaljer.
resourceType	String	Ja	Den type ressource, der skal hentes indholdsforslag til. For eksempel 'e-mail-tråd' eller 'teams-chat'.	Dette input identificerer den type ressource, der deles til hentning af foreslåede fillinks, som i dette tilfælde er 'e-mail-tråd'.
recordType	String	Nej	Typen af CRM-post, f.eks. firma eller salgsmulighed.	Dette input identificerer posttypen i CRM, som er relateret til mailtråden.
recordId	String	Nej	Det entydige id for den CRM-post, der skal bruges til foreslået indhold.	Dette input angiver det entydige id for den CRM-post, der er relateret til mailtråden.
crmType	String	Nej	Typen af CRM-system, hvis det er tilsluttet. Gyldige værdier er Salesforce og Dynamics 365.	Dette input angiver den type CRM, hvor den post, der er relateret til mailtråden, findes.
crmOrgUrl	String	Nej	CRM-organisationen URL-adresse.	Dette input angiver URL-adressen til det CRM-miljø, hvor den post, der er relateret til mailtråden, findes.
inputPrompt	String	Nej	Den aktuelt anvendte foreslåede prompt givet af brugeren til at generere e-mail-kladde. For eksempel "Svar på en bekymring" eller "Lav et forslag".	Dette input angiver den prompt, som brugeren giver, mens han udarbejder en e-mail.
top	Integer	Nej	Antal elementer, der skal hentes.	Dette input angiver antallet af fillinks, der skal hentes.
skip	Integer	Nej	Antal elementer, der skal springes over.	Dette input angiver antallet af elementer, der skal springes over, når foreslåede fillinks hentes.

Maildatamodel med udvidelsesmuligheder

Property	Type	Oplysninger	Beskrivelse, der skal føjes til handlingen
plaintextBody	String	Hele mailbrødteksten indeholder alle de tidligere meddelelser fra mailtråden.	Dette input indeholder alt indholdet fra mailtråden i tekstformat.
fullHtmlBody	String	Den fulde HTML-version af mailbrødteksten, der indeholder alle de tidligere meddelelser fra mailtråden.	Dette input indeholder alt indholdet fra mailtråden i HTML-format.
emne	String	Mailens emne.	Dette input angiver emnet for mailen.
fra	String	Afsenders mailadresse.	Dette input angiver afsenderens mailadresse.
til	String[]	Modtagers mailadresser.	Dette input giver modtagerens mailadresse.
cc	String[]	Modtagernes mailadresser er tilføjet i feltet Cc i mailen.	Dette input indeholder alle modtagerens e-mail-adresser, der er inkluderet i feltet Cc i e-mailen.
bcc	String[]	Modtagernes e-mailadresser tilføjet i feltet Bcc i e-mailen.	Dette input indeholder alle modtagerens e-mail-adresser, der tilføjes i feltet Bcc i e-mailen.
sentDateTime	DateTimeOffset	Dato og klokkeslæt for mailen i UTC-format sammen med egenskaben Forskydning. For mere information, gå til DateTimeOffset Struct (System)	Dette input angiver mailens tidsstempel.
messageId	String	Mailens Graph-meddelelses-id.	Dette input indeholder mailens meddelelses-id.
conversationId	String	Graph-samtale-id'et for mailtråden.	Dette input indeholder samtale-id'et for mailtråden.

Outputparametre

Property	Datatype	Påkrævet	Oplysninger
værdi	Matrix	Ja	En liste over filkæder (objekter), der er defineret som beskrevet i svaret Skema til forslag til fil- eller linkindhold.
hasMoreResults	Boolean	Nej	En værdi, der angiver, om der er flere resultater.

Skema for svar på forslag til fil- eller linkindhold

Name	Datatype/-format	Påkrævet	Oplysninger	Beskrivelse, der skal føjes til handlingen
contentType	string	Ja	Den type indhold, der skal vises. Flere oplysninger, gå til Foruddefinerede værdier for contentType	Dette output angiver den type indhold, der er inkluderet i mailkladden.
indhold	string	Ja	Faktisk indhold inkluderet. Det kan enten være en webside eller en URL til filen.	Dette output angiver det faktiske indhold, der er inkluderet i mailkladden. Det kan enten være en webside eller en URL.
contentTitle	string	Ja	Titlen på det foreslåede indhold, der vises til brugeren.	Dette output angiver titlen på indholdet.
contentDescription	string	Ja	Beskrivelse af det foreslåede indhold, der vises til brugeren.	Dette output angiver den tekst, der skal inkluderes, når filerne beskrives.
contentIconUrl	string	Nej	Ikon for det foreslåede indhold, der vises til brugeren. Hvis det ikke er angivet, bruges et generisk ikon.	Dette output angiver det ikon, der skal medtages for indholdet.
additionalProperties	Object	Nej	Et sæt navneværdipar, der angiver yderligere egenskaber for det relaterede fillink, som handlingen returnerer.	Dette output angiver yderligere egenskaber som navneværdipar for hvert relateret link, der returneres af handlingen.

Foruddefinerede værdier for contentType

Strengværdi	Indholdstypen
content-file	Ekstern fil (generisk)
content-web	Ekstern webside
content-doc	Microsoft Word-dokument
content-pdf	Microsoft PDF-dokument
content-pptx	Microsoft PowerPoint-præsentation
content-xlsx	Microsoft Excel-regneark

Eksempel

{
  "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
}

Eksemplet på følgende billede viser, hvordan API'ens output knyttes til mailkladden.

Skærmbillede, der viser fillinks fra partnerapps i mailkladden.

Forklaring:

Fillinks fra partnerapps.

Se også

Opsummer en e-mailtråd ved hjælp af salgsoplysninger med Copilot i Outlook
Forbedre mailoversigter med indsigt fra dit program
Forbedre vigtige salgsoplysninger med indsigt fra dit program
Forbedre oplysninger om CRM-poster med indsigt fra dit program
Forbedre oversigter over CRM-poster med indsigt fra dit program
Udvide Microsoft 365 Copilot til salg med partnerapplikationer
Opbygge Copilot til salg-udvidelser

Del via