CRM-tietueen yhteenvetojen rikastaminen sovelluksestasi peräisin olevilla merkityksellisillä tiedoilla (esiversio)
Tärkeää
- Tämä on tuotantovalmis esiversio-ominaisuus.
- Tuotantovalmiita esiversioita koskevat erilliset lisäkäyttöehdot.
[Tämä artikkeli sisältää julkaisua edeltävää materiaalia ja 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. Copilot for Sales luo tekoälyn avulla yhteenvedon jokaisesta CRM-tietueesta. Tässä yhteenvedossa korostetaan tärkeitä tietoja, kuten myyntivaihe, budjetti ja arvioitu sopimuspäivä. Voit laajentaa Copilot for Salesin CRM-tietueen yhteenveto-ominaisuutta omasta sovelluksestasi peräisin olevilla merkityksellisillä tiedoilla.
Ohjelmointirajapinnan kuvaus
Toimintoon on lisättävä seuraava ohjelmointirajapinnan kuvaus. Tällä tavoin Copilot for Sales voi tunnistaa oikean ohjelmointirajapinnan, joka on käynnistettävä ominaisuuden rikastamiseksi.
Tämä toiminto hakee CRM-tietueeseen liittyviä muita myyntitietoja, jotka näytetään C4S-tietueen yhteenvetokortissa. Toiminto parantaa nykyisiä Copilot for Sales -taitoja.
Ohjelmointirajapintatoiminto
Tämä ohjelmointirajapinta käyttää toimintotyyppiä: GET
Syöteparametrit
Copilot for Sales on suunniteltu toimittamaan ohjelmointirajapinnoille seuraavat syöteparametrit.
| Name | Tietojen tyyppi/muoto | Pakolliset | Details | Toimintoon lisättävä kuvaus |
|---|---|---|---|---|
| recordType | String | 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 | String | 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ä. 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ä. Esimerkki: 2017-07-21T17:32:28Z. | Tämä syöte määrittää pyydettyjen merkityksellisten tietojen päättymispäivän ja -ajan. |
| ensimmäiset | Integer | No | Noudettavien merkityksellisten tietojen määrä. | Tämä syöte määrittää noudettavien merkityksellisten tietojen määrän. |
| skip | Integer | No | Ohitettavien merkityksellisten tietojen määrä. | Tämä syöte määrittää ohitettavien merkityksellisten tietojen määrän. |
| crmType | String | 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 | String | 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. |
Tulosparametrit
Copilot for Sales odottaa saavansa luettelon merkityksellisistä tiedoista (objekteista) ohjelmointirajapinnoistasi ja odottaa, että jokaisella merkityksellisellä tiedolla on tietyt parametrit. Jotta Copilot for Sales pystyy jäsentämään tuloksen oikein, pitää noudattaa seuraavassa taulukossa kuvattua vastausrakennetta.
| Parametri | Tietotyyppi | Pakolliset | Details |
|---|---|---|---|
| arvo | Matriisi | Kyllä | Luettelo merkityksellisistä tiedoista (objekteista), jotka on määritetty Merkityksellisten tietojen rakenne -osassa kuvatulla tavalla. |
| hasMoreResults | Totuusarvo | No | Arvo, joka osoittaa, onko lisää tuloksia saatavilla. |
Merkityksellisten tietojen rakenne
| Name | Tietojen tyyppi/muoto | Pakolliset | Details | Toimintoon lisättävä kuvaus |
|---|---|---|---|---|
| otsikko | String | 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. |
| description | String | 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. |
| dateTime | Merkkijono päivämäärä- ja aikamuodossa | Kyllä | Aktiviteetin päivämäärä ja kellonaika UTC-muodossa. Jos aktiviteetilla on sekä alkamis- että päättymisaika, sovelluksen on määritettävä, kumpi aika näytetään. Muoto noudattaa OpenAPI-määritystä. Esimerkki: 2017-07-21T17:32:28Z. | Tämä tulos määrittää merkitykselliseen tietoon liittyvän ajan. |
| url-osoite | String | No | Kelvollinen URL-osoite, joka avaa aktiviteetin kumppanisovelluksessa. | Tulos määrittää URL-osoitteen merkityksellisen tiedon avaamista varten. |
| additionalProperties | 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ä { |
Tämä tulos määrittää merkityksellisen tiedon tietonäkymässä näytettävät lisäominaisuudet. |
Muistiinpano
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.
Selite:
- Osa, jossa näkyy merkityksellisiä tietoja kumppanisovelluksesta. Tämän osan otsikko johdetaan Microsoft Power Platform -yhdistimen nimestä.
- Ohjelmointirajapintavastauksen merkityksellisten tietojen kuvaukset.
- Lainausnumerot, jotka voidaan valita merkityksellisten tietojen yksityiskohtien tarkastelemiseksi.
- Lainauskortti, jossa näkyvät merkityksellisten tietojen yksityiskohdat.
- Merkityksellisen tiedon kuvake ja otsikko. Kuvake noudetaan Microsoft Power Platform -yhdistimen metatiedoista. Otsikkoteksti on ohjelmointirajapintavastauksesta peräisin olevan merkityksellisen tiedon otsikko.
- Ohjelmointirajapintavastauksesta peräisin olevan merkityksellisen tiedon lisäominaisuudet.
- Kumppanisovelluksen nimi. Näkyvissä oleva nimi on Microsoft Power Platform -yhdistimen nimi.
- Linkki, joka voidaan valita merkityksellisen tietojen yksityiskohtien kumppanisovelluksessa tarkastelemista varten. Tämä perustuu ohjelmointirajapintavastauksen merkityksellisen tiedon URL-osoitteeseen.
Liittyvät tiedot
Näytä tietueen yhteenveto
Sähköpostiyhteenvetojen rikastaminen sovelluksestasi peräisin olevilla merkityksellisillä tiedoilla
Sähköpostiluonnosten rikastaminen sovelluksen tiedostolinkeillä
Keskeisten myyntitietojen rikastaminen sovelluksestasi peräisin olevilla merkityksellisillä tiedoilla
CRM-tietuetietojen rikastaminen sovelluksestasi peräisin olevilla merkityksellisillä tiedoilla
Microsoft 365 Copilot for Salesin laajentaminen kumppanisovellusten avulla
Copilot for Sales -laajennusten luominen