Berik CRM-oppføringsdetaljer med innsikt fra programmet (forhåndsversjon)

Viktig!

• Dette er en produksjonsklar forhåndsversjonsfunksjon.
• Produksjonsklare forhåndsversjoner er underlagt tilleggsvilkår for bruk.

[Denne artikkelen inneholder dokumentasjon for forhåndsversjonen og kan bli endret.]

Selgere kan vise detaljer om en lagret kontakt, sammen med de tilknyttede oppføringene, for eksempel forretningsforbindelser og salgsmuligheter. Du kan utvide funksjonen for oppføringsdetaljer i kunderelasjonssystemet (CRM) som Copilot for salg gir, med innsikt fra ditt eget program.

API-beskrivelse

Du må legge til følgende API-beskrivelse i handlingen. Copilot for salg kan dermed identifisere riktig API som må aktiveres for å supplere funksjonen.

Denne handlingen henter oppføringer relatert til en CRM-oppføring. Handlingen forbedrer de eksisterende ferdighetene til Copilot for salg.

Inndataparametere

Copilot for salg er utformet for å gi følgende inndataparametere til API-ene.

Name	Datatype/format	Kreves	Details	Beskrivelse som skal legges til i handlingen
recordType	String	Ja	Typen enhet eller objekt i CRM som det finnes forespørsler om relaterte oppføringer for. Verdien omfatter det språkagnostiske unike navnet på enheten eller objekttypen, ikke visningsnavnet som kan lokaliseres. Eksempler omfatter forretningsforbindelse og salgsmulighet.	Disse inndataene identifiserer oppføringstypen i CRM som det bes om relaterte oppføringer for.
recordId	String	Ja	Den unike ID-en til CRM-oppføringen.	Disse inndataene oppgir den unike identifikatoren for CRM-oppføringen som det bes om relaterte oppføringer for.
øverst	Integer	No	Antall aktiviteter som skal hentes.	Disse inndataene angir antall relaterte oppføringer som skal hentes.
skip	Integer	No	Antall aktiviteter som skal hoppes over.	Disse inndataene angir antall oppføringer som skal hoppes over under henting av relaterte oppføringer.
crmType	String	No	Typen CRM-system. De gyldige verdiene er Dynamics 365 og Salesforce.	Disse inndataene angir typen CRM de relaterte oppføringene hentes fra.
crmOrgUrl	String	No	Vertsnavnet for CRM-organisasjonen, for eksempel contoso.crm.dynamics.com.	Disse inndataene angir URL-adressen til CRM-miljøet de relaterte oppføringene hentes fra.

Notat

Dette utvidelsespunktet støtter gjengivelse av innsikt fra opptil fem tilkoblingsutvidelser i Outlook-sideruten.

Utdataparametere

Copilot for salg forventer å motta en liste over innsikter (objekter) fra API-ene, og forventer at hver innsikt har bestemte parametere. For å sikre at Copilot for salg kan analysere utdataene riktig, må svarstrukturen følge retningslinjene i tabellen nedenfor.

Parameter	Datatype	Kreves	Details
verdi	Matrise	Ja	En liste over innsikter (objekter) som er definert slik som beskrevet i delen Skjema for innsikt.
hasMoreResults	Bolsk	No	En verdi som angir om flere resultater er tilgjengelige.

Skjema for innsikt

Name	Datatype/format	Kreves	Details	Beskrivelse som skal legges til i handlingen
recordId	String	Ja	Den unike ID-en til oppføringen.	Disse utdataene identifiserer unikt hver relaterte oppføring som returneres av handlingen.
recordTypeDisplayName	String	Ja	Visningsnavnet for oppføringstypen, for eksempel Kontrakt. Det bør lokaliseres til språket som er angitt i hodet Accept-Language.	Disse utdataene angir visningsnavnet til oppføringstypen for hver relaterte oppføring som returneres av handlingen.
recordTypePluralDisplayName	String	Ja	Flertallsvisningsnavnet for oppføringstypen, for eksempel Kontrakter. Det bør lokaliseres til språket som er angitt i hodet Accept-Language.	Disse utdataene angir visningsnavnet i flertall til oppføringstypen for hver relaterte oppføring som returneres av handlingen.
recordType	String	Ja	Systemnavnet for oppføringstypen, for eksempel kontrakt.	Disse utdataene angir typen for hver relaterte oppføring som returneres av handlingen.
recordTitle	String	Ja	Navnet på oppføringen, for eksempel Fornyelseskontrakt for Contoso 2023.	Disse utdataene angir tittelen for hver relaterte oppføring som returneres av handlingen.
url	String	No	En gyldig URL-adresse for å åpne oppføringen i partnerprogrammet.	Disse utdataene angir URL-adressen for hver relaterte oppføring som returneres av handlingen.
additionalProperties	Et objekt som har verdiene Egenskapsnavn og Egenskapsverdi av typen Streng	No	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 reason": "Signed off", "Owner": "Kenny Smith" }	Disse utdataene angir flere egenskaper som navneverdipar for hver relaterte oppføring som returneres av handlingen.

Eksempel

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

Eksemplet på bildet nedenfor viser hvordan utdataene for API-en er tilordnet til de relaterte oppføringene.

Forklaring:

1. Kort som viser relaterte oppføringer fra partnerprogrammet.
2. Ikon og tittel for kortet. Ikonet hentes fra metadataene for Microsoft Power Platform-koblingen. Tittelen er navnet på Microsoft Power Platform-koblingen.
3. Relaterte oppføringstitler fra API-svaret. To ytterligere egenskaper fra API-svaret gjengis som nøkkelfelter i hver relaterte oppføring.
4. Knappen Flere handlinger som kan brukes til å kopiere en kobling til oppføringen eller vise oppføringsdetaljer i partnerprogrammet. Koblingen er basert på nettadressen til den relaterte oppføringen i API-svaret.
5. Ytterligere egenskaper for den relaterte oppføringen fra API-svaret.

Relatert informasjon

Vise detaljer for oppføring
Suppler e-postsammendrag med innsikt fra programmet
Suppler e-postutkast med filkoblinger fra programmet
Suppler viktig salgsinformasjon med innsikt fra programmet
Suppler CRM-oppføringssammendrag med innsikt fra programmet
Utvid Microsoft 365 Copilot for salg med partnerprogrammer
Bygg Copilot for salg-utvidelser