CRM-tietueen yhteenvetojen rikastaminen sovelluksestasi peräisin olevilla merkityksellisillä tiedoilla (esiversio)

Tärkeää

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

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

Ymmärtääkseen paremmin valmisteltavan kokouksen tai luetun sähköpostiviestin kontekstin myyjät haluavat asiaankuuluvia asiakkuudenhallinnan (CRM) tietoja, kuten asiakkaiden kyselyt, huolenaiheet ja muistiinpanot. Myyntiagentti luo tekoälyn avulla yhteenvedon kustakin CRM-tietueesta. Tässä yhteenvedossa korostetaan tärkeitä tietoja, kuten myyntivaihe, budjetti ja arvioitu sopimuspäivä. Voit laajentaa CRM-tietueiden yhteenvedon ominaisuutta, jonka myyntiagentti tarjoaa oman sovelluksesi merkityksellisillä tiedoilla.

Ohjelmointirajapinnan kuvaus

Sinun on lisättävä toiminnolle seuraava ohjelmointirajapinnan kuvaus. Näin myyntiagentti voi tunnistaa oikean ohjelmointirajapinnan, joka on kutsuttava täydentämään ominaisuutta.

Tämä toiminto hakee CRM-tietueeseen liittyviä muita myyntitietoja, jotka näytetään C4S-tietueen yhteenvetokortissa. Toiminto parantaa myynnin copilot-osaamista.

Ohjelmointirajapinnan toiminto

Tämä ohjelmointirajapinta käyttää toiminnon tyyppiä: GET

Syöteparametrit

Myyntiedustaja on suunniteltu tarjoamaan seuraavat syöteparametrit ohjelmointirajapinnoillesi.

Nimi Tietotyyppi/muoto Pakollinen Yksityiskohdat Toiminnolle lisättävä kuvaus
recordType Merkkijono Kyllä Sen entiteetin tai objektin tyyppi CRM:ssä, johon liittyviä merkityksellisiä tietoja, kuten aktiviteetteja, pyydetään. Arvo sisältää entiteetti- tai objektityypin kielestä riippumattoman yksilöllisen nimen, ei lokalisoitavaa näyttönimeä. Esimerkkejä ovat tili ja mahdollisuus. Tämä syöte määrittää sen entiteetin tai objektin tyypin CRM:ssä, johon liittyviä merkityksellisiä tietoja pyydetään.
recordId Merkkijono Kyllä CRM-tietueen yksilöivä tunniste. Tämä syöte määrittää sen CRM-tietueen yksilöllisen tunnisteen, jota varten merkityksellisiä tietoja pyydetään.
startDateTime Merkkijono päivämäärä- ja aikamuodossa No Merkityksellisten tietojen hakemisen aloituspäivä ja -aika. Muoto noudattaa OpenAPI-määritystä. Tässä on esimerkki: 2017-07-21T17:32:28Z. Tämä syöte määrittää pyydettyjen merkityksellisten tietojen alkamispäivän ja -ajan.
endDateTime Merkkijono päivämäärä- ja aikamuodossa No Merkityksellisten tietojen hakemisen päättymispäivä ja -aika. Muoto noudattaa OpenAPI-määritystä. Tässä on esimerkki: 2017-07-21T17:32:28Z. Tämä syöte määrittää pyydettyjen merkityksellisten tietojen päättymispäivän ja -ajan.
huippu Kokonaisluku No Noudettavien oivallusten määrä. Tämä syöte määrittää noudettavien merkityksellisten tietojen määrän.
ohita Kokonaisluku No Ohitettujen merkityksellisten tietojen määrä. Tämä syöte määrittää ohitettavien merkityksellisten tietojen määrän.
crm-tyyppi Merkkijono No Kelvolliset arvot ovat Dynamics 365 ja Salesforce. Tämä syöte määrittää CRM-tyypin, jossa se CRM-tietue sijaitsee, jota varten myyntitietoja pyydetään.
crmOrgUrl Merkkijono No CRM-organisaation isäntänimi, kuten contoso.crm.dynamics.com. Tämä syöte määrittää sen CRM-ympäristön URL-osoitteen, jossa sijaitsee se CRM-tietue, jota varten merkityksellisiä tietoja pyydetään.

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.
onLisääTuloksia totuusarvo No Arvo, joka ilmaisee, onko enemmän tuloksia saatavilla.

Merkityksellisten tietojen rakenne

Nimi Tietojen tyyppi/muoto Pakollinen Yksityiskohdat Toimintoon lisättävä kuvaus
otsikko Merkkijono Kyllä Lainauskortissa olevan merkityksellisen tiedon otsikko. Tämä on merkityksellisen tiedon luonnollisen kielen muodossa oleva otsikko Accept-Language-pyynnön otsikossa määritetyllä kielellä. Esimerkki: Sopimus allekirjoitettu. Tämä tulos määrittää aktiviteetin otsikon viitekortissa.
kuvaus Merkkijono Kyllä Merkityksellisen tiedon kuvaus. Se näkyy tietueen yhteenvedossa luettelomerkkeinä, ja se on merkityksellisten tietojen luonnollisen kielen kuvaus Accept-Language-otsikossa määritetyllä kielellä. Esimerkki: Kenny, Logan ja kaksi muuta allekirjoittivat Contoso 2023 -uusimissopimuksen 7.9.2023. Tämä tulos määrittää merkityksellisen tiedon kuvauksen.
päivämäärä ja aika Merkkijono päivämäärä- ja aikamuodossa Kyllä Aktiviteetin päivämäärä ja aika UTC-muodossa. Jos aktiviteetilla on sekä alkamis- että päättymisaika, sovelluksen on määritettävä, mikä aika näytetään. Muoto noudattaa OpenAPI-määritystä. Tässä on esimerkki: 2017-07-21T17:32:28Z. Tämä tuloste ilmaisee merkityksellisiin tietoihin liittyvän ajan.
URL-osoite Merkkijono No Kelvollinen URL-osoite, joka avaa aktiviteetin kumppanisovelluksessa. Tulos määrittää URL-osoitteen merkityksellisen tiedon avaamista varten.
lisäominaisuudet Objekti, jonka Ominaisuuden nimi- ja Ominaisuuden arvo -arvot ovat Merkkijono-tyyppiä No

Lisäominaisuudet, jotka näkyvät yksityiskohtaisessa näkymässä. Ominaisuuksien nimet ja arvot ovat luonnollisella kielellä Accept-Language-otsikon kautta määritetyllä kielellä. Esimerkki:

{
 "Tilan syy": "Hyväksytty",
 "Omistaja": "Kenny Smith"
}
 Tämä tulos määrittää merkityksellisen tiedon tietonäkymässä näytettävät lisäominaisuudet.

Muistio

Vaikka sähköpostiviestin yhteenvedon laajentamisen vaatimukset ja tietueen yhteenvedon ominaisuudet saattavat näyttää samalta, ne on lisättävä yhdistimeen erillisinä toimintoina.

Esimerkki

{
    "value": [
        {
            "title": "Contract signed",
            "description": "You have 5 connections in Fourth Coffee Inc",
            "dateTime": "2024-05-07T03:28:38.0667701Z",
            "url": null,
            "additionalProperties": {
                "Contract name": "50 Cafe-A-100 Automatic Renewal Contract",
                "Signed by": "Alberto Burgos, Tony",
                "Signed": "9/7/23"
            }
        },
        {
            "title": "Contract signed",
            "description": "Multiple stakeholders from Fourth Coffee have visited the Contoso website four times in the last four months",
            "dateTime": "2024-05-07T03:28:38.0669445Z",
            "url": null,
            "additionalProperties": {
                "Contract name": "50 Cafe-A-100 Automatic Renewal Contract",
                "Signed by": "Alberto Burgos, Tony",
                "Signed": "9/7/23"
            }
        }
    ],
    "hasMoreResults": false
}

Seuraavassa kuvassa on esimerkki siitä, miten ohjelmointirajapinnan tulos yhdistetään tietueen yhteenvetoon.

Näyttökuva kumppanisovelluksen viimeisimpien aktiviteettien rakenteesta.

Selite:

  1. Osio, joka näyttää kumppanisovelluksen merkitykselliset tiedot. Osan otsikko johdetaan Microsoft Power Platform -liittimen nimestä.
  2. Ohjelmointirajapinnan vastauksen merkityksellisten tietojen kuvaukset.
  3. Lainausnumerot, jotka voidaan valita merkityksellisten tietojen tietojen tarkastelemiseksi.
  4. Lainauskortti, joka näyttää merkityksellisiä tietoja.
  5. Merkityksellisten tietojen kuvake ja otsikko. Kuvake noudetaan Microsoft Power Platform -liittimen metatiedoista. Otsikkoteksti on ohjelmointirajapintavastauksesta peräisin olevan merkityksellisen tiedon otsikko.
  6. Ohjelmointirajapintavastauksen merkityksellisten tietojen lisäominaisuudet.
  7. Kumppanisovelluksen nimi. Näytetty nimi on Microsoft Power Platform -liittimen nimi.
  8. Linkki, jonka voi valita merkityksellisten tietojen tarkastelemiseksi kumppanisovelluksessa. Se perustuu API-vastauksen merkityksellisten tietojen URL-osoitteeseen.

Näytä tietueen yhteenveto
Sähköpostiyhteenvetojen rikastaminen sovelluksestasi peräisin olevilla merkityksellisillä tiedoilla
Täydennä sähköpostiluonnoksia sovelluksen tiedostolinkeillä
Täydennä mahdollisuuksien merkityksellisiä tietoja sovelluksesi tiedoilla
CRM-tietuetietojen rikastaminen sovelluksestasi peräisin olevilla merkityksellisillä tiedoilla
Myyntiedustajan laajentaminen kumppanisovelluksilla
Myyntiedustajan koontilaajennukset

  • Last updated on