Jaa

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

  • Artikkeli

Tärkeää

[Tämä artikkeli sisältää julkaisua edeltävää materiaalia ja voi muuttua.]

Myyjät voivat tarkastella tallennetun yhteystiedon tietoja sekä siihen liittyviä tallennettuja tietueita, kuten asiakkaita ja mahdollisuuksia. Voit laajentaa Copilot for Salesin asiakkuudenhallinnan (CRM) tietuetietojen 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 liittyvät tietueet. Toiminto parantaa Copilot for Salesin nykyisiä taitoja.

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 CRM:n entiteetin tai objektin tyyppi, jolle liittyviä tietueita 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öt määrittää CRM-tietuetyypin, jota varten liittyviä tietueita pyydetään.
recordId String Kyllä CRM-tietueen yksilöivä tunniste. Tämä syöte määrittää sen CRM-tietueen yksilöllisen tunnisteen, jota varten liittyviä tietueita pyydetään.
ensimmäiset Integer No Haettavien aktiviteettien määrä. Tämä syöte määrittää noudettavien liittyvien tietueiden määrän.
skip Integer No Ohitettavien aktiviteettien määrä. Tämä syöte määrittää ohitettavien tietueiden määrän noudettaessa liittyviä tietueita.
crmType String No CRM-järjestelmän tyyppi. Kelvolliset arvot ovat Dynamics 365 ja Salesforce. Tämä syöte määrittää sen CRM:n tyypin, josta liittyvät tietueet noudetaan.
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, josta liittyvät tietueet noudetaan.

Muistiinpano

Tämä laajennuspiste tukee merkityksellisten tietojen hahmontamista enintään viidestä yhdistinlaajennuksesta Outlookin erilliskokemuksessa.

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
recordId String Kyllä Tietueen yksilöivä tunniste. Tämä tulos määrittää kunkin toiminnon palauttaman liittyvän tietueen yksilöllisesti.
recordTypeDisplayName String Kyllä Tietuetyypin näyttönimi, kuten Sopimus. Se on lokalisoitava Accept-Language-otsikon kautta määritetylle kielelle. Tämä tulos määrittää kunkin toiminnon palauttaman liittyvän tietueen tietuetyypin näyttönimen.
recordTypePluralDisplayName String Kyllä Tietuetyypin monikkonäyttönimi, kuten Sopimukset. Se on lokalisoitava Accept-Language-otsikon kautta määritetylle kielelle. Tämä tulos määrittää kunkin toiminnon palauttaman liittyvän tietueen tietuetyypin näyttönimen monikkomuodon.
recordType String Kyllä Tietuetyypin järjestelmänimi, kuten sopimus. Tämä tulos määrittää kunkin toiminnon palauttaman liittyvän tietueen tyypin.
recordTitle String Kyllä Tietueen nimi, kuten Contoso 2023 Renewal Contract. Tämä tulos määrittää kunkin toiminnon palauttaman liittyvän tietueen otsikon.
url-osoite String No Kelvollinen URL-osoite, joka avaa tietueen kumppanisovelluksessa. Tämä tulos määrittää kunkin toiminnon palauttaman liittyvän tietueen URL-osoitteen.
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ä Accept-Language-otsikon kautta määritetyllä kielellä. Esimerkki:

{
 "Tilan syy": "Hyväksytty",
 "Omistaja": "Kenny Smith"
}
 Tämä tulos määrittää lisäominaisuuksia kunkin toiminnon palauttaman tietueen nimi-arvopareina.

Esimerkki:

{
    "value": [
        {
            "recordId": "ID1",
            "recordTypeDisplayName": "Contract",
            "recordTitle": "50 Cafe A-100 Automatic Renewal Contract",
            "recordTypePluralDisplayName": "Documents",
            "recordType": "contract",
            "url": "https://contosohub.com/contract/id1",
            "additionalProperties": {
                "Status": "Signed",
                "Date": "9/7/23",
                "Signed by": "Alberto Burgos, Tony [last name]"
            }
        },
        {
            "recordId": "ID2",
            "recordTypeDisplayName": "Contract",
            "recordTitle": "ABC Company 2023 Renewal Contract",
            "recordTypePluralDisplayName": "Documents",
            "recordType": "contract",
            "url": "https://contosohub.com/contract/id2",
            "additionalProperties": {
                "Status": "Delivered",
                "Date": "9/3/23",
                 "Signed by": "Alberto Burgos"
            }
        }
    ],
    "hasMoreResults": false
}

Seuraavassa kuvassa näkyy esimerkki siitä, miten ohjelmointirajapinnan tuotos yhdistetään liittyviin tietueisiin.

Näyttökuva kumppanisovelluksen liittyvien tietueiden rakenteesta.

Selite:

  1. Kortti, jossa näkyvät kumppanisovelluksen liittyvät tietueet.
  2. Kortin kuvake ja otsikko. Kuvake noudetaan Microsoft Power Platform -yhdistimen metatiedoista. Otsikko on Microsoft Power Platform -yhdistimen nimi.
  3. Liittyvien tietueiden nimet ohjelmointirajapinnan vastauksesta. Kaksi ohjelmointirajapintavastauksen lisäominaisuutta hahmonnetaan kunkin liittyvän tietueen avainkentiksi.
  4. Lisää toimintoja -painike, jota voidaan käyttää joko tietueen linkin kopioimiseen tai tietueen tietojen tarkastelemiseen kumppanisovelluksessa. Linkki perustuu liittyvän tietueen URL-osoitteeseen ohjelmointirajapinnan vastauksessa.
  5. Liittyvän tietueen lisäominaisuudet ohjelmointirajapinnan vastauksesta.

Tietueen tietojen tarkasteleminen
Uuden kysymys- ja vastausominaisuuden (K&V) lisääminen Sales-keskusteluun
Sähköpostiyhteenvetojen rikastaminen sovelluksestasi peräisin olevilla merkityksellisillä tiedoilla
Keskeisten myyntitietojen rikastaminen sovelluksestasi peräisin olevilla merkityksellisillä tiedoilla
CRM-tietueen yhteenvedon rikastaminen sovelluksestasi peräisin olevilla merkityksellisillä tiedoilla
Microsoft 365 Copilot for Salesin laajentaminen kumppanisovellusten avulla
Copilot for Sales -laajennusten luominen