Merk
Tilgang til denne siden krever autorisasjon. Du kan prøve å logge på eller endre kataloger.
Tilgang til denne siden krever autorisasjon. Du kan prøve å endre kataloger.
Viktig!
- Dette er en produksjonsklar evalueringsfunksjonalitet.
- Produksjonsklare forhåndsversjoner er underlagt tilleggsvilkårene for bruk.
[Denne artikkelen er forhåndsutgitt dokumentasjon og kan endres.]
Når Copilot i Outlook og salgsagenten brukes sammen, inkluderer e-postsammendrag som vises i Outlook, salgsinformasjon som er hentet fra systemet for kunderelasjonsadministrasjon (CRM), for eksempel Dynamics 365 eller Salesforce CRM. Du kan utvide e-postsammendragsfunksjonen som salgsagenten gir innsikt fra ditt eget program.
Notat
Denne API-en erstatter den eksisterende APIen for e-postsammendragsferdighet (operasjons-ID: scp-get-email-insights) med en ny versjon.
API-beskrivelse
Du må legge til følgende API-beskrivelse i handlingen. Dette hjelper salgsagenten med å identifisere riktig API for å aktivere for å berike funksjonen.
Denne handlingen henter ytterligere salgsinnsikt som vises i C4S-funksjonen for e-postsammendrag, i Outlook-sammendraget. Handlingen forbedrer de eksisterende ferdighetene til salgscopiloten.
API-detaljer
- API-navn: Ferdighetsversjon 2 for e-postsammendrag
- Swagger-operasjons-ID: scp-get-email-insights-v2
- Swagger-driftsmetode: post
-
Bane:
<PowerAppsConnectorHostName>/api/enhanceskills/email-insights-v2
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. |
| relaterteEnheter | Array | Nei | Matrisen med relaterte enheter. For datastruktur gå til Relatert enhetsdatamodell. | Disse inndataene identifiserer matrisen med CRM-oppføringer, 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. |
| ø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 er 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 er 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. |
Relatert enhetsdatamodell
| Egenskap | Type | Obligatorisk | Detaljer | Beskrivelse som skal legges til i handlingen |
|---|---|---|---|---|
| entityId | Streng | Ja | Typen CRM-oppføring, for eksempel forretningsforbindelse eller salgsmulighet. | Disse inndataene oppgir den unike identifikatoren til CRM-posten som er relatert til e-posttråden. |
| enhetstype | Streng | Ja | Den unike identifikatoren for CRM-oppføringen som skal brukes til foreslått innhold. | Disse inndataene identifiserer oppføringstypen i CRM, som er relatert til e-posttråden. |
| entitetskilde | Streng | Nei | Disse inndataene angir enhetskilden, som for øyeblikket inneholder "tilkoblet" eller tomme verdier. | Denne inndataene angir enhetskildetypen. |
Utdataparametere
Salgsagenten forventer å motta en liste over innsikter (objekter) fra API-ene dine, og forventer at hver innsikt har bestemte parametere. For å sikre at salgsagenten kan analysere utdataene på riktig måte, må svarstrukturen følge retningslinjene i tabellen nedenfor.
| Parameter | Datatype | Obligatorisk | Detaljer |
|---|---|---|---|
| Verdi | Array | Ja | En liste over innsikter (objekter) som er definert som beskrevet i inndelingen Skjema for innsikt . Obs! Selv om denne parameteren inneholder en liste over innsikt, brukes bare den første innsikten i sammendraget av e-postsupplering for Outlook Canvas-opplevelsen. |
| harMerResultater | boolsk | Nei | En verdi som angir om flere resultater er tilgjengelige. |
Skjema for innsikt
| Navn | Datatype/format | Obligatorisk | Detaljer | Beskrivelse som skal legges til i handlingen |
|---|---|---|---|---|
| innsikt | Streng | Ja | Innsikten som leveres til brukere, for eksempel Kollegene dine, Mona Kane, Ray Tanaka og Daniela Smith, har jobbet med dem før. | Disse utdataene angir teksten du ønsker å inkludere i e-postsammendraget. |
Eksempel
{
"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
}
Eksemplet i illustrasjonen nedenfor viser hvordan utdataene fra API-en er tildelt til e-postsammendraget i sideruten.
Forklaring:
- Tittelen på innsikten. Innsikter som har samme tittel, grupperes sammen.
- Beskrivelser av innsikten. Hver innsikt har én beskrivelse.
Eksemplet i illustrasjonen nedenfor viser hvordan utdataene fra API-en er tildelt til e-postsammendraget i brødteksten i e-posten.
Forklaring:
- Tittelen på innsikten. Innsikter som har samme tittel, grupperes sammen.
- Beskrivelse av innsikten. Hver innsikt har én beskrivelse.
Relatert informasjon
Oppsummere en e-posttråd ved hjelp av salgsinformasjon med Copilot i Outlook
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
Berike e-postkladder med filkoblinger fra programmet
Bygg utvidelser for salgsagent