Sähköpostiyhteenvedon rikastaminen sovelluksen sisältöehdotuksilla (esiversio)

Tärkeää

  • Tämä on tuotantovalmis esiversiotoiminto.
  • Tuotantovalmiisiin esiversiotoimintoihin sovelletaan lisäkäyttöehtoja.

[Tämä artikkeli on esijulkaisuasiakirja, ja se voi muuttua.]

Kun Copilotia outlookissa ja myyntiagenttia käytetään yhdessä, Outlookissa näkyvät sähköpostiyhteenvedot sisältävät myyntitietoja, jotka ovat peräisin asiakassuhdehallintajärjestelmästäsi (CRM), kuten Dynamics 365 tai Salesforce CRM. Voit laajentaa sähköpostin yhteenvetoominaisuutta, jonka myyntiagentti tarjoaa oman sovelluksesi merkityksellisillä tiedoilla.

Muistio

Tämä ohjelmointirajapinta korvaa nykyisen Email Summary Skill -ohjelmointirajapinnan (toiminnon tunnus: scp-get-email-insights) uudella versiolla.

Ohjelmointirajapinnan kuvaus

Sinun on lisättävä toiminnolle seuraava ohjelmointirajapinnan kuvaus. Tämän avulla myyntiagentti tunnistaa oikean ohjelmointirajapinnan, joka käynnistää ominaisuuden täydentämiseksi.

Tämä toiminto hakee lisää myynnin merkityksellisiä tietoja, jotka näytetään C4S:n sähköpostiyhteenvetokokemuksessa Outlook-yhteenvedossa. Toiminto parantaa myynnin copilot-osaamista.

API-tiedot

  • Ohjelmointirajapinnan nimi: Email Summary Skill Version 2
  • Swagger-toiminnon tunnus: scp-get-email-insights-v2
  • Swagger-toiminnon metodi: post
  • Polku: <PowerAppsConnectorHostName>/api/enhanceskills/email-insights-v2

Syötteen tiedot

Tämä hyötykuorma toimii API-pyynnön pyyntötekstinä.

Nimi Tietotyyppi Pakollinen Yksityiskohdat Toiminnolle lisättävä kuvaus
resurssin tiedot Objekti Kyllä Resurssitiedot, joita käytetään ehdotetun sisällön noutamiseen. Lisätietoja tietorakenteesta on kohdassa Laajennussähköpostin tietomalli. Tämä syöte tunnistaa sähköpostin sisällön, joka on sähköpostiketjun, aiheen ja muiden tietojen kokoelma.
liittyvät entiteetit Array No Liittyvien entiteettien matriisi. Lisätietoja tietorakenteesta on kohdassa Liittyvän entiteetin tietomalli. Tämä syöte tunnistaa CRM-tietueiden joukon, joka liittyy sähköpostiketjuun.
crm-tyyppi Merkkijono No CRM-järjestelmän tyyppi, jos järjestelmään on muodostettu yhteys. Kelvolliset arvot ovat Salesforce ja Dynamics 365. Tämä syöte määrittää sen CRM:n tyypin, jossa sähköpostiketjuun liittyvä tietue on.
crmOrgUrl Merkkijono No CRM-organisaation URL-osoite. Tämä syöte määrittää sen CRM-ympäristön URL-osoitteen, jossa sähköpostiketjuun liittyvä tietue on.
huippu Kokonaisluku No Noudettavien kohteiden määrä. Tämä syöte määrittää noudettavien tiedostolinkkien määrän.
ohita Kokonaisluku No Ohitettavien kohteiden määrä. Tämä syöte määrittää ohitettavien kohteiden määrän, kun ehdotettuja tiedostolinkkejä noudetaan.

Laajennettavuussähköpostin tietomalli

Attribuutti Kirjoita Yksityiskohdat Toiminnolle lisättävä kuvaus
plaintextBody Merkkijono Sähköpostiviestin täydellinen tekstiosa sisältää sähköpostiketjun kaikki aiemmat viestit. Tämä syöte sisältää sähköpostiketjun koko sisällön tekstimuodossa.
fullHtmlBody Merkkijono Sähköpostiviestin tekstiosan täydellinen HTML-versio, joka sisältää sähköpostiketjun kaikki aiemmat viestit. Tämä syöte sisältää sähköpostiketjun koko sisällön HTML-muodossa.
aihe Merkkijono Sähköpostin aihe. Tämä syöte sisältää sähköpostiviestin aiheen.
alkaen Merkkijono Lähettäjän sähköpostiosoite. Tämä syöte sisältää lähettäjän sähköpostiosoitteen.
vastaanottaja String[] Vastaanottajan sähköpostiosoitteet. Tämä syöte sisältää vastaanottajan sähköpostiosoitteen.
kopio String[] Vastaanottajan sähköpostiosoitteet lisätty sähköpostin Kopio-kenttään. Tämä syöte sisältää kaikki vastaanottajan sähköpostiosoitteet, jotka sisältyvät sähköpostiviestin Kopio-kenttään.
piilokopio String[] Vastaanottajan sähköpostiosoitteet lisätty sähköpostin Piilokopio-kenttään. Tämä syöte sisältää kaikki vastaanottajan sähköpostiosoitteet, jotka on lisätty sähköpostiviestin Piilokopio-kenttään.
sentDateTime DateTimeOffset Sähköpostiviestin päivämäärä ja kellonaika UTC-muodossa sekä Siirtymä-ominaisuus. Lisätietoja on DateTimeOffset Struct (järjestelmä) -kohdassa Tämä syöte sisältää sähköpostiviestin aikaleiman.
viestin tunnus Merkkijono Sähköpostiviestin Graph-sanomatunnus. Tämä syöte sisältää sähköpostiviestin sanomatunnuksen.
conversationId Merkkijono Sähköpostiketjun Graph-keskustelutunnus. Tämä syöte sisältää sähköpostiketjun keskustelutunnuksen.
Attribuutti Kirjoita Pakollinen Yksityiskohdat Toiminnolle lisättävä kuvaus
entityId Merkkijono Kyllä CRM-tietueen tyyppi, kuten asiakas tai mahdollisuus. Tämä syöte sisältää sen CRM-tietueen yksilöllisen tunnisteen, joka liittyy sähköpostiketjuun.
entiteettityyppi Merkkijono Kyllä Ehdotetussa sisällössä käytettävän CRM-tietueen yksilöllinen tunniste. Tämä syöte määrittää CRM:n tietuetyypin, joka liittyy sähköpostiviestiketjuun.
entiteettilähde Merkkijono No Tämä syöte ilmaisee entiteettilähteen, joka sisältää tällä hetkellä yhdistettyjä tai tyhjiä arvoja. Tämä syöte ilmaisee entiteetin lähdetyypin.

Tulosteparametrit

Myyntiagentti odottaa saavansa luettelon merkityksellisistä tiedoista (objekteista) ohjelmointirajapinnoistasi, ja se odottaa, että jokaisella merkitykselliselle tiedolle on tiettyjä parametreja. Jotta myyntiagentti voi jäsentää tuloksen oikein, vastausrakenteen on noudatettava seuraavassa taulukossa olevia ohjeita.

Parametri Tietotyyppi Pakollinen Yksityiskohdat
Arvo Array Kyllä

Luettelo merkityksellisistä tiedoista (objekteista), jotka on määritetty kohdassa Rakenteen merkityksellisten tietojen rakenne kuvatulla tavalla.

Huomautus: Vaikka tämä parametri sisältää luettelon merkityksellisistä tiedoista, vain ensimmäistä merkityksellistä tietoa käytetään sähköpostin rikastusyhteenvedossa Outlook Canvas -kokemuksessa.
onLisääTuloksia totuusarvo No Arvo, joka ilmaisee, onko enemmän tuloksia saatavilla.

Merkityksellisten tietojen rakenne

Nimi Tietotyyppi/muoto Pakollinen Yksityiskohdat Toiminnolle lisättävä kuvaus
merkityksellinen havainto Merkkijono Kyllä Käyttäjille toimitetut merkitykselliset tiedot, kuten Kollegasi Mona Kane, Ray Tanaka ja Daniela Smith ovat työskennelleet heidän kanssaan aiemmin. Tämä tulos ilmaisee tekstin, jonka haluat sisällyttää sähköpostiviestin yhteenvetoon.

Esimerkki

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

Seuraavan kuvan esimerkissä näytetään, miten ohjelmointirajapinnan tulos yhdistetään sivuruudun sähköpostiyhteenvetoon.

Näyttökuva kumppanisovelluksista peräisin olevista merkityksellisistä tiedoista sähköpostiviestin yhteenvedossa.

Selite:

  1. Merkityksellisen tiedon otsikko. Merkitykselliset tiedot, joilla on sama otsikko, ryhmitellään yhteen.
  2. Merkityksellisen tiedon kuvaukset. Yksi kuvaus kutakin merkityksellistä tietoa kohden.

Seuraavan kuvan esimerkissä näytetään, miten ohjelmointirajapinnan tulos yhdistetään sähköpostin viestiosion sähköpostiyhteenvetoon.

Näyttökuva kumppanisovellusten merkityksellisistä tiedoista sähköpostiviestin tekstiosassa.

Selite:

  1. Merkityksellisen tiedon otsikko. Merkitykselliset tiedot, joilla on sama otsikko, ryhmitellään yhteen.
  2. Merkityksellisen tiedon kuvaus. Yksi kuvaus kutakin merkityksellistä tietoa kohden.

Tee yhteenveto sähköpostiviestiketjusta käyttäen myyntitietoja Copilotin avulla Outlookissa
Täydennä mahdollisuuksien merkityksellisiä tietoja sovelluksesi tiedoilla
CRM-tietuetietojen rikastaminen sovelluksestasi peräisin olevilla merkityksellisillä tiedoilla
CRM-tietueen yhteenvedon rikastaminen sovelluksestasi peräisin olevilla merkityksellisillä tiedoilla
Myyntiedustajan laajentaminen kumppanisovelluksilla
Täydennä sähköpostiluonnoksia sovelluksen tiedostolinkeillä
Myyntiedustajan koontilaajennukset

  • Last updated on