Suppler CRM-oppføringssammendrag med innsikt fra programmet (forhåndsversjon)

Viktig!

[Denne artikkelen er forhåndsutgitt dokumentasjon og kan endres.]

Selgere ønsker relevant informasjon fra kunderelasjonssystemet (CRM), for eksempel kundespørringer, problemer og notater, slik at de bedre kan forstå konteksten for et møte de forbereder seg til, eller en e-postmelding de leser. Salgsagenten bruker KUNSTIG INTELLIGENS til å generere et sammendrag av hver CRM-post. Dette sammendraget fremhever avgjørende detaljer, for eksempel salgsfase, budsjett og forventet avtaledato. Du kan utvide sammendragsfunksjonen for CRM-oppføringer som salgsagenten gir innsikt fra ditt eget program.

API-beskrivelse

Du må legge til følgende API-beskrivelse i handlingen. På denne måten kan salgsagenten identifisere riktig API som må aktiveres for å berike funksjonen.

Denne handlingen henter ytterligere salgsinnsikt relatert til en CRM-oppføring som vises i C4S-kortet for oppføringssammendrag. Handlingen forbedrer de eksisterende ferdighetene til salgscopiloten.

API-operasjon

Denne API-en bruker operasjonstype: GET

Inndataparametre

Salgsagenten er utformet for å gi følgende inndataparametere til API-ene dine.

Navn Datatype/format Obligatorisk Detaljer Beskrivelse som skal legges til i handlingen
recordType Streng Ja Typen enhet eller objekt i CRM som det bes om relatert innsikt for, for eksempel aktiviteter. Verdien omfatter det språkagnostiske unike navnet på enheten eller objekttypen, ikke visningsnavnet som kan lokaliseres. Eksempler omfatter forretningsforbindelse og salgsmulighet. Disse inndataene indikerer enhets- eller objekttype i CRM, som det bes om relatert innsikt for.
recordId Streng Ja Den unike ID-en til CRM-oppføringen. Disse inndataene indikerer den unike identifikatoren for CRM-oppføringen som det bes om innsikt for.
startDateTime Streng i format for dato/klokkeslett Nei Startdatoen og -klokkeslettet for å slå opp innsikt. Formatet følger OpenAPI-spesifikasjonen. Her er et eksempel: 2017-07-21T17:32:28Z. Disse inndataene angir startdato og -tidspunkt for den forespurte innsikten.
endDateTime Streng i format for dato/klokkeslett Nei Sluttdatoen og -klokkeslettet for å slå opp innsikt. Formatet følger OpenAPI-spesifikasjonen. Her er et eksempel: 2017-07-21T17:32:28Z. Disse inndataene angir sluttdato og -tidspunkt for den forespurte innsikten.
øverst Heltall Nei Antall innsikter som skal hentes. Disse inndataene angir antall innsikter som skal hentes.
hoppe over Heltall Nei Antall innsikter å hoppe over. Disse inndataene angir antall innsikter som skal hoppes over.
crmType Streng Nei De gyldige verdiene er Dynamics 365 og Salesforce. Disse inndataene angir typen CRM der CRM-oppføringen finnes, og som det bes om innsikt for.
crmOrgUrl Streng Nei Vertsnavnet for CRM-organisasjonen, for eksempel contoso.crm.dynamics.com. Disse inndataene angir nettadressen til CRM-miljøet der CRM-oppføringen finnes, og som det bes om innsikt for.

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 .
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
tittel Streng Ja Tittelen på innsikten på referansekortet. Det er tittelen for innsikten på naturlig språk på det språket som er angitt i forespørselshodet Accept-Language. Her er et eksempel: Kontrakt signert. Disse utdataene angir tittelen på aktiviteten på referansekortet.
beskrivelse Streng Ja Beskrivelsen av innsikten. Det vises som punkter i oppføringssammendraget og er beskrivelsen av innsikten på naturlig språk på språket som er angitt i hodet Accept-Language. Her er et eksempel: Kenny, Logan og to andre signerte Fornyelseskontrakt for Contoso 2023 07.09.2023. Disse utdataene angir beskrivelsen av innsikten.
datoTid Streng i format for dato/klokkeslett Ja Datoen og klokkeslettet for aktiviteten i UTC-format. Hvis aktiviteten har både et starttidspunkt og et sluttidspunkt, må programmet bestemme hvilket tidspunkt som skal vises. Formatet følger OpenAPI-spesifikasjonen. Her er et eksempel: 2017-07-21T17:32:28Z. Dette utdataene angir tidspunktet som er knyttet til innsikten.
Url Streng Nei En gyldig URL-adresse for å åpne aktiviteten i partnerprogrammet. Disse utdataene angir URL-adressen for å åpne innsikt.
ytterligereEgenskaper Et objekt med egenskapsnavn og egenskapsverdiverdier for strengtypen Nei

Ytterligere egenskaper som vises i den detaljerte visningen. Egenskapsnavn og -verdier er på naturlig språk på språket som er angitt i hodet Accept-Language. Her er et eksempel:

{
 Statusårsak: «Logget av»,
 «Eier»: «Kenny Smith»
}
 Disse utdataene angir flere egenskaper som vises i den detaljerte visningen av innsikten.

Notat

Selv om API-kravene for utvidelse av funksjoner for e-postsammendrag og oppføringssammendrag kan se like ut, må de legges til som separate handlinger i koblingen.

Eksempel

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

Eksemplet på bildet nedenfor viser hvordan utdataene fra API-en tilordnes til oppføringssammendraget.

Skjermbilde av anatomien til de siste aktivitetene fra et partnerprogram.

Forklaring:

  1. Inndeling som viser innsikt fra partnerprogrammet. Inndelingstittelen er avledet fra navnet på Microsoft Power Platform-koblingen.
  2. Beskrivelser av innsikten fra API-svaret.
  3. Sitatnumre som kan velges for å vise detaljer om innsikten.
  4. Sitatkort som viser detaljer om innsikten.
  5. Ikon og tittel på innsikten. Ikonet hentes fra metadataene for Microsoft Power Platform-koblingen. Tittelteksten er tittelen på innsikten fra API-svaret.
  6. Flere egenskaper for innsikten fra API-svaret.
  7. Navnet på partnerprogrammet. Navnet som vises, er navnet på Microsoft Power Platform-koblingen.
  8. Kobling som kan velges for å vise innsiktsdetaljer i partnerprogrammet. Den er basert på nettadressen til innsikten i API-svaret.

Vis oppføringssammendrag
Berike e-postsammendrag med innsikt fra programmet
Berike e-postkladder med filkoblinger fra programmet
Berike mulighetsinnsikt med data fra programmet
Suppler CRM-oppføringsdetaljer med innsikt fra programmet
Utvid salgsagent med partnerprogrammer
Bygg utvidelser for salgsagent

  • Last updated on