Suppler e-postutkast med filkoblinger fra programmet (forhåndsversjon)

Viktig!

[Denne artikkelen er forhåndsutgitt dokumentasjon og kan endres.]

Når du bruker salgsagenten til å utarbeide en e-postmelding, vurderer den e-postmeldingens hensikt og bruker CRM-informasjon fra Salesforce eller Dynamics 365 til å opprette utkastet. Du kan utvide e-postutkastfunksjonen som salgsagenten leverer med anbefalte filer fra ditt eget program.

Notat

Denne funksjonen støttes bare for e-postkladder som er opprettet ved hjelp av salgsagenten i Outlook.

API-beskrivelse

Du må legge til følgende API-beskrivelse i handlingen. På denne måten kan salgsagenten identifisere riktig API som må aktiveres for å berike funksjonen.

Denne handlingen henter filer som er relevante for e-postsamtalen, som vises i C4S e-postutkast i Outlook. Handlingen forbedrer de eksisterende ferdighetene til salgscopiloten.

API-operasjon

Denne API-en bruker operasjonstype: POST

Inndatanyttelast

Denne nyttelast går som forespørselstekst for API-forespørselen.

Navn Datatyper Obligatorisk Detaljer Beskrivelse som skal legges til i handlingen
ressursdata Objekt Ja Ressursdataene som skal brukes til å hente det foreslåtte innholdet. For datastrukturen, gå til E-postdatamodell for utvidbarhet. Disse inndataene identifiserer e-postinnholdet som er en samling av e-posttråd, emne og andre detaljer.
ressurstype Streng Ja Ressurstypen du vil hente innholdsforslag for. For eksempel "e-posttråd" eller "teams-chat". Disse inndataene identifiserer typen ressurs som deles for å hente foreslåtte filkoblinger, som i dette tilfellet er "e-posttråd".
recordType Streng Nei Typen CRM-oppføring, for eksempel forretningsforbindelse eller salgsmulighet. Disse inndataene identifiserer oppføringstypen i CRM, som er relatert til e-posttråden.
recordId Streng Nei Den unike identifikatoren for CRM-oppføringen som skal brukes til foreslått innhold. Disse inndataene oppgir den unike identifikatoren til CRM-posten som er relatert til e-posttråden.
crmType Streng Nei Typen CRM-system, hvis tilkoblet. De gyldige verdiene er Salesforce og Dynamics 365. Disse inndataene indikerer typen CRM, der oppføringen som er relatert til e-posttråden, finnes.
crmOrgUrl Streng Nei URL-adressen for CRM-organisasjonen. Disse inndataene indikerer nettadressen for CRM-miljøet, der oppføringen som er relatert til e-posttråden, finnes.
inputPrompt Streng Nei Den foreslåtte ledeteksten som for øyeblikket brukes av brukeren for å generere e-postutkast. For eksempel "Svar på en bekymring" eller "Lag et forslag". Disse inndataene indikerer ledeteksten som ble angitt av brukeren mens han/hun utarbeidet en e-post.
øverst Heltall Nei Antall elementer som skal hentes. Disse inndataene angir antall filkoblinger som skal hentes.
hoppe over Heltall Nei Antall elementer som skal hoppes over. Disse inndataene angir antall elementer som skal hoppes over under henting av foreslåtte filkoblinger.

E-postdatamodell for utvidbarhet

Egenskap Type Detaljer Beskrivelse som skal legges til i handlingen
plaintextBody Streng Den komplette e-postteksten inneholder alle tidligere meldinger i e-posttråden i den. Disse inndataene oppgir alt innholdet fra e-posttråden i tekstformat.
fullHtmlBody Streng Den fullstendige HTML-versjonen av e-postteksten som inneholder alle tidligere meldinger i e-posttråden i den. Disse inndataene oppgir alt innholdet fra e-posttråden i HTML-format.
emne Streng Emne for e-postmeldingen. Disse inndataene oppgir emnet for e-posten.
fra Streng Avsenders e-postadresse: Disse inndataene oppgir avsenderens e-postadresse.
til String[] Mottakerens e-postadresser. Disse inndataene oppgir mottakerens e-postadresse.
cc String[] Mottakerens e-postadresser lagt til i Kopi-feltet i e-posten. Disse inndataene oppgir alle mottakerens e-postadresser som er inkludert i Kopi-feltet i e-posten.
bcc String[] Mottakerens e-postadresser lagt til i Blindkopi-feltet i e-posten. Disse inndataene oppgir alle mottakerens e-postadresser som er lagt til i Blindkopi-feltet i e-posten.
sentDateTime DateTimeOffset Datoen og klokkeslettet for e-postmeldingen i UTC-format sammen med Offset-egenskapen. Hvis du vil ha mer informasjon, kan du gå til DateTimeOffset Struct (System) Disse inndataene oppgir tidsstempelet for e-posten.
Meldings-ID Streng Meldings-ID i Graph for e-posten. Disse inndataene oppgir meldings-ID-en for e-posten.
conversationId Streng Samtale-ID i Graph for e-posttråden. Disse inndataene oppgir samtale-ID-en for e-posttråden.

Utdataparametere

Egenskap Datatyper Obligatorisk Detaljer
Verdi Array Ja En liste over filkoblinger (objekter) som er definert som beskrevet i Skjema for fil eller svaret på forslagene til koblingsinnhold.
harMerResultater boolsk Nei En verdi som angir om flere resultater er tilgjengelige.

Skjema for fil eller svaret på forslagene til koblingsinnhold

Navn Datatypeformat Obligatorisk Detaljer Beskrivelse som skal legges til i handlingen
innholdstype streng Ja Typen innhold som skal vises. Hvis du vil ha mer informasjon, kan du gå til Forhåndsdefinerte verdier for contentType Disse utdataene angir typen innhold som er inkludert i e-postutkastet.
innhold streng Ja Det faktiske innholdet som er inkludert. Det kan enten være en nettside eller en nettadresse til filen. Disse utdataene angir det faktiske innholdet som er inkludert i e-postutkastet. Det kan enten være en nettside eller en nettadresse.
innholdTittel streng Ja Tittelen på det foreslåtte innholdet som vises til brukeren. Disse utdataene angir tittelen på innholdet.
innholdBeskrivelse streng Ja Beskrivelsen av det foreslåtte innholdet som vises til brukeren. Disse utdataene angir teksten som skal inkluderes når filene beskrives.
contentIconUrl streng Nei Ikonet for det foreslåtte innholdet som vises til brukeren. Hvis det ikke er angitt, brukes et generelt ikon. Disse utdataene angir ikonet som skal inkluderes for innholdet.
ytterligereEgenskaper Objekt Nei Et sett med navn/verdi-par som angir ytterligere egenskaper for den relaterte filkoblingen handlingen returnerer. Disse utdataene angir flere egenskaper som navneverdipar for hver relaterte kobling som returneres av handlingen.

Forhåndsdefinerte verdier for contentType

Tekstverdi Innholdstype
innhold-fil Ekstern fil (generell)
innhold-web Ekstern nettside
innhold-dokument Microsoft Word-dokument
Innhold-PDF Microsoft PDF-dokument
Innhold-PPTX Microsoft PowerPoint-presentasjon
Innhold-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å bildet nedenfor viser hvordan utdataene fra API-en tilordnes til e-postutdraget.

Skjermbilde av filkoblinger fra partnerapper i e-postutkastet.

Forklaring:

  1. Filkoblinger fra partnerapper.

Se også

Oppsummere en e-posttråd ved hjelp av salgsinformasjon med Copilot i Outlook
Berike e-postsammendrag med innsikt fra programmet
Berike mulighetsinnsikt med data fra programmet
Suppler CRM-oppføringsdetaljer med innsikt fra programmet
Berike CRM-oppføringssammendrag med innsikt fra programmet
Utvid salgsagent med partnerprogrammer
Bygg utvidelser for salgsagent

  • Last updated on